@oneie/claude 0.3.1 → 0.4.0

package/templates/template-plan.md

@@ -0,0 +1,75 @@
+<!--
+TEMPLATE — DESIGN PHASE. Copy to text/<slug>-plan.md, fill, delete this comment.
+Owner: Opus · high (the decider — never delegated). Skills: typedb, signal where the
+substrate is touched. This is the DESIGN phase of /do (see text/do-refined.md).
+Runs AFTER PROMISE (text/<slug>.md) and SURVEY, BEFORE the plan (text/<slug>-todo.md).
+-->
+
+---
+title: {Human-readable title}
+slug: {kebab-slug}
+type: plan
+tier: {trivial | simple | complex}
+source_of_truth:
+  - text/{feature}.md          # the promise this design must keep
+  - text/dictionary-plan.md        # canonical names — reconcile against this
+  - schema/one.tql             # only if the substrate is touched
+---
+
+# {Title}
+
+## The promise (from FRAME)
+
+{One line, copied from text/<feature>.md — the design exists to keep this promise.}
+
+## Reuse verdict (from SURVEY)
+
+{expose | extend | build | drop} — {what already exists, what the real gap is. Only the gap gets designed.}
+
+## Design
+
+### Data shape
+{What extends the existing schema. Reuse relations; add the minimum field. NEVER a parallel model.}
+
+### Types
+{Flow from the schema. No hand-maintained second copy.}
+
+### API
+{Which existing route family this joins. New route only if SURVEY said `build`.}
+
+### UI
+{Which existing components / pages / navigation this composes. Empty / loading / error / edge states named here, not deferred to BUILD.}
+
+## Substrate reconciliation (gate — zero new core concepts without justification)
+
+- [ ] Names exist in `dictionary.md` (no dead names)
+- [ ] No new dimension / verb / type — or one-sentence justification: {…}
+- [ ] No locked-rule break (6 dims, 6 verbs, 3 rules)
+
+## Pre-mortem (assume it shipped and failed — why?)
+
+{Red-team the design. Walk every boundary. Name the assumptions that, if wrong, sink it.
+Each failure mode below becomes a test in the todo's demo gate.}
+
+| Failure mode | Likelihood | Becomes test |
+|---|---|---|
+| {how it could break} | {low/med/high} | {the assertion that catches it} |
+
+## Decisions (this, not that, because)
+
+{Every non-obvious choice gets one line. Favour boring, proven shapes over clever ones.
+A decision nobody wrote down is one the next person re-litigates.}
+
+- **{choice}** over **{alternative}** — because {reason}.
+
+## Clarifications (CLARIFY gate — features/schema only)
+
+{≤5 high-impact ambiguity questions and their answers, written here at design time.
+NOT a second human gate — INTAKE is the one front-door checkpoint. This is decision capture.}
+
+- **Q:** {scope / data-model / edge-case / naming question}
+  **A:** {the decision}
+
+## Out of scope
+
+{What this explicitly does NOT do — the boundary that keeps the todo honest.}

package/templates/template-teach.md

@@ -0,0 +1,59 @@
+---
+slug: {{slug}}
+written: {{YYYY-MM-DD}}
+proven: true
+promise: text/{{slug}}.md
+---
+
+# {{Feature Name}}
+
+> Written after PROVE passes. Describes behavior that exists, not behavior that is planned.
+> The promise (`text/{{slug}}.md`) is what this doc must match.
+
+## What it does
+
+{{1–3 sentences. What the user/operator gets. Every claim here must be in the proven behavior.}}
+
+## How to use it
+
+{{The golden path. Step-by-step. Present tense. Tested commands only.}}
+
+```bash
+# Example — copy-pasteable, verified to work
+```
+
+## Reference
+
+| Concept | Where |
+|---------|-------|
+| {{name}} | {{`file:line` or section link}} |
+| Script | `.claude/scripts/{{relevant-script}}.sh` |
+| Template | `text/template-{{template}}.md` |
+
+---
+
+## Runbook
+
+### Verify it's working
+
+```bash
+# The proof command from the PROVE step — still valid as a health check
+```
+
+### Common issues
+
+| Symptom | Cause | Fix |
+|---------|-------|-----|
+| {{symptom}} | {{cause}} | {{fix}} |
+
+### Rollback
+
+{{What to undo if this needs to be reverted. Specific commands, not vague guidance.}}
+
+<!--
+TEACH stop rules (from do.md):
+- Write AFTER PROVE passes (proven: true in frontmatter marks this)
+- Match the promise: every user-facing claim must appear in text/{{slug}}.md
+- Doc + runbook in one file; presence check is: test -f text/{{slug}}-doc.md
+- do-reconcile.sh dictionary on this file before committing (no dead names)
+-->

package/templates/template-tests.md

@@ -0,0 +1,43 @@
+---
+slug: {{slug}}
+surface: {{frontend|api|backend|substrate}}
+cycle: {{C1}}
+folder: {{one.ie/web|packages/sdk|channels}}
+deliverables:
+  - {{D1 — what it asserts}}
+---
+
+# Tests — {{slug}} · {{cycle}}
+
+> One `expect()` per deliverable — assert the destination, not the path.
+> Run: `bun run verify` in `{{folder}}/`
+> Written first (before W3 edits land), verified at W4.
+
+## {{D1 — user-facing outcome}}
+
+```typescript
+import { describe, it, expect } from 'vitest'
+// import { {{thing}} } from '{{path}}'
+
+describe('{{slug}} · {{deliverable}}', () => {
+  it('{{outcome a user would care about}}', async () => {
+    // arrange
+    // const input = ...
+
+    // act
+    // const result = await ...
+
+    // assert
+    // expect(result).toBe(...)
+  })
+})
+```
+
+<!--
+Rules (from do.md testing policy):
+- ≤1 test file per cycle
+- Goal-based: assert shipped outcome, not implementation detail
+- Vitest-first; add requires_playwright: true in todo frontmatter if browser needed
+- N-variant split-test → winner mark(), losers warn(0.5)
+- One import per test file (avoid cross-cycle coupling)
+-->