docs: scaffold agent-friendly entry points (Phase 1)
introduces a balanced set of agent + human docs:
- root AGENTS.md (with CLAUDE.md symlink) — 5-rule quickstart,
layout map, mental model, use-case keyed example pointers.
- docs/agents/conventions.md — vault/demagify, eval-loader
constraints, group inheritance, naming, do-not-touch list,
suspension idioms, working-style notes.
- docs/agents/commands.md — repo-specific deltas to the fork's
bw runbook (apt-key offline-verify, *.py_ suspended-node
visibility, vault-echo rule).
- per-area AGENTS.md for bundles/, nodes/, groups/, libs/,
hooks/, data/, items/, bin/ — mechanism-focused, no enumeration.
- bundles/AGENTS.template.md — per-bundle doc template with
optional `## Writes into` section for cross-namespace reactors.
bundlewrap-language reference (item types, dep keywords, reactors,
runbook, three-tier safety envelope) is not duplicated here; we
link out to the fork's AGENTS.md instead.
bw test still green. all internal links resolve. Phase 0 invariants
preserved (libs/hooks docstrings, bin/* # purpose: headers).
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
CroneKorkN
04558a9189
