Scaffold: agent starter kit (seeded from Ebb)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

docs/HANDOFF.md

@@ -0,0 +1,20 @@
+# Handoff: state of the work
+
+Living document, rewritten in place (never a second copy). A new orchestrator session reads CLAUDE.md, then this.
+
+## 1. Where things stand
+- `main` at <hash>, last gate: <date, result line>.
+- Installed on the owner's phone: <package> from <hash>.
+
+## 2. Open work (one line each, with who owns it: agent or owner)
+
+## 3. Owner questions (asked, unanswered)
+
+## 4. Paused (waiting on something outside the repo)
+
+## 5. Numbering
+Next free: D-001, SPEC v0.1, schema 1.
+
+## 6. How the work is run
+See CLAUDE.md › Orchestration. HUMAN steps in reports are relayed in chat by the orchestrator; the owner does not
+read them in files.

docs/decisions.md

@@ -0,0 +1,8 @@
+# Decisions
+
+One entry per decision that changes or refines SPEC.md. Numbered, dated, never deleted: a revised decision gets a new
+entry and the old one a strike-through plus a pointer. The spec is updated in the same change.
+
+| # | Date | Decision | Why | Where it lives |
+|---|---|---|---|---|
+| D-001 | YYYY-MM-DD | … | … | SPEC §… |