§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>
vendors ~/.claude/plans/btw-are-you-sure-crystalline-balloon.md into
docs/superpowers/plans/2026-05-10-agent-friendliness-plan.md so the
plan lives alongside its spec and handoff. tagged with a top-of-file
note flagging it as a frozen pre-pivot artifact (the per-bundle-doc
section, the AGENTS.template.md reference, and the Phase 2 seed-list
all reflect original intent, not what shipped).
handoff's pointer updated to the in-repo path.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
- spec §0 gets a new revision bullet noting that per-bundle docs
are README.md (not AGENTS.md), the rigid template is gone, and
Phase 2 was dropped. flags §3 and §7 as pre-pivot intent only;
doesn't back-fit them.
- handoff replaced with a short status note (~50 lines vs the
original ~390): what landed, where current truth lives, and the
fact that nothing is planned for a next session.
implementation plan in ~/.claude/plans/ is left as a frozen
pre-pivot artifact.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
- drop the docs/agents/bundlewrap/ folder; bundlewrap-language docs now
live in the personal fork's AGENTS.md (canonical reference). ckn-bw
links out instead of duplicating
- slim commands.md scope from ~80-120 to ~30-50 lines (fork carries the
generic bw runbook; ckn-bw keeps only repo-specific deltas: apt-key
verification, *.py_ suspended-node behavior, vault-echo guidance)
- sync bw command syntax against 5.0.3 source (no -p flag; use bare or
--preview; bw hash takes only literal node/group names; replace
bw groups -n with bw nodes -a groups)
- rebalance phase 2 seed list: php -> routeros-monitoring (highest-churn
bundle in 18mo per user-story analysis)
- update fork install pointer to editable github reference
- new section 0 documents revisions inline so a reader sees current shape
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
21 recurring user stories derived from 1169 commits of git history (with
detailed analysis of the last 222 commits / 18 months). Grounded in
concrete commit evidence; each story carries an "Implications for agent
docs" section that drives content additions in the agent-friendliness
implementation plan.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Brainstormed design for making this BundleWrap repo legible to agents:
root AGENTS.md + per-area docs + per-bundle template, with a focused
docs/agents/bundlewrap/ folder covering items.md and metadata.md as
the hard parts. Read-only bw command envelope and an after-change
runbook keyed by what was edited.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
