cronekorkn/bundlewrap
1
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

spec: banner stale sections so partial readers see the pivot

Browse source 
§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) <noreply@anthropic.com>
This commit is contained in:
CroneKorkN 2026-05-10 16:14:12 +02:00
parent d4dedde0ad
commit c6bf2e0fc8
Signed by: cronekorkn
SSH key fingerprint: SHA256:v0410ZKfuO1QHdgKBsdQNF64xmTxOF8osF1LIqwTcVw
1 changed files with 12 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

12
docs/superpowers/specs/2026-05-10-agent-friendliness-design.md
View file

@ -127,6 +127,12 @@ bundle.
## 3. Per-bundle `AGENTS.md` template ## 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 One balanced doc serving both audiences. Prose where prose helps, structure
where structure helps. Sections in order: 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) ### 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 Bundles selected empirically (node+group references and recent commit
activity, validated 2026-05-10): activity, validated 2026-05-10):