From c6bf2e0fc84cfaa45a030e48608ec7ba63c72c93 Mon Sep 17 00:00:00 2001 From: CroneKorkN Date: Sun, 10 May 2026 16:14:12 +0200 Subject: [PATCH] spec: banner stale sections so partial readers see the pivot MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit §0 Revisions notes that §3 and §7 Phase 2 are pre-pivot, but a reader deep-linking into either section bypasses §0. Add a section-level banner at the top of each that points back to §0 and to bundles/AGENTS.md for the current per-bundle convention. Content is preserved as a record of the original design. Co-Authored-By: Claude Opus 4.7 (1M context) --- .../specs/2026-05-10-agent-friendliness-design.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/docs/superpowers/specs/2026-05-10-agent-friendliness-design.md b/docs/superpowers/specs/2026-05-10-agent-friendliness-design.md index 18f8718..65c7295 100644 --- a/docs/superpowers/specs/2026-05-10-agent-friendliness-design.md +++ b/docs/superpowers/specs/2026-05-10-agent-friendliness-design.md @@ -127,6 +127,12 @@ bundle. ## 3. Per-bundle `AGENTS.md` template +> **Status: replaced — pre-pivot intent only.** Per-bundle docs are plain +> `README.md` with no fixed structure. See §0 Revisions and the +> "Per-bundle README" section in [`bundles/AGENTS.md`](../../../bundles/AGENTS.md) +> for the current convention. The template below is kept as a record of +> the original design. + One balanced doc serving both audiences. Prose where prose helps, structure where structure helps. Sections in order: @@ -339,6 +345,12 @@ in 30–120 lines each; root `AGENTS.md` is ~150 lines. ### Phase 2 — seed bundles (10) +> **Status: dropped — pre-pivot intent only.** Phase 2 didn't ship. After +> Phase 1 landed, the maintainer pulled the per-bundle `AGENTS.md` +> migration: the rigid template proved a poor fit for the heterogeneous +> existing READMEs. See §0 Revisions. The seed list and migration plan +> below are kept as a record of how the work was scoped. + Bundles selected empirically (node+group references and recent commit activity, validated 2026-05-10):