every libs/*.py and hooks/*.py now starts with a one-line module
docstring; every bin/* script starts with a `# purpose:` header.
discovery-by-`ls`-and-read instead of by index.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
The bundlewrap install is now captured in requirements.txt as an editable
github reference, and the file:/// path in the README pointed at a local
clone with no relation to the actual install method.
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>
Replaces the PyPI 5.0.3 pin with an editable github clone of the personal
fork. The fork tracks upstream main and carries an agent-oriented
AGENTS.md the rest of this repo's docs link to.
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>
