@oneie/claude 0.3.2 → 0.4.0

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)
+-->