leancraft 0.1.0

package/.leancraft/human/discovery/02-research.md

@@ -0,0 +1,104 @@
+# 02 — Research — 12 Pain Themes (P1-P12)
+
+> Status: DRAFT — Agent drafts, human verifies quotes. Min 12 themes (no max — add P13-P20 if needed). Sources Inventory holds your 50–100 raw posts — more sources = stronger themes. Validator checks ≥12.
+
+## P1: [Theme]
+
+- **Quote:** "[verbatim]"
+- **Source:** https://... — Date: YYYY-MM-DD — Platform: Reddit/X/HN/G2
+- **Frequency:**
+- **Severity:** high/medium/low
+
+## P2: [Theme]
+
+- **Quote:** "[verbatim]"
+- **Source:** https://... — Date: YYYY-MM-DD — Platform: Reddit/X/HN/G2
+- **Frequency:**
+- **Severity:** high/medium/low
+
+## P3: [Theme]
+
+- **Quote:** "[verbatim]"
+- **Source:** https://... — Date: YYYY-MM-DD — Platform: Reddit/X/HN/G2
+- **Frequency:**
+- **Severity:** high/medium/low
+
+## P4: [Theme]
+
+- **Quote:** "[verbatim]"
+- **Source:** https://... — Date: YYYY-MM-DD — Platform: Reddit/X/HN/G2
+- **Frequency:**
+- **Severity:** high/medium/low
+
+## P5: [Theme]
+
+- **Quote:** "[verbatim]"
+- **Source:** https://... — Date: YYYY-MM-DD — Platform: Reddit/X/HN/G2
+- **Frequency:**
+- **Severity:** high/medium/low
+
+## P6: [Theme]
+
+- **Quote:** "[verbatim]"
+- **Source:** https://... — Date: YYYY-MM-DD — Platform: Reddit/X/HN/G2
+- **Frequency:**
+- **Severity:** high/medium/low
+
+## P7: [Theme]
+
+- **Quote:** "[verbatim]"
+- **Source:** https://... — Date: YYYY-MM-DD — Platform: Reddit/X/HN/G2
+- **Frequency:**
+- **Severity:** high/medium/low
+
+## P8: [Theme]
+
+- **Quote:** "[verbatim]"
+- **Source:** https://... — Date: YYYY-MM-DD — Platform: Reddit/X/HN/G2
+- **Frequency:**
+- **Severity:** high/medium/low
+
+## P9: [Theme]
+
+- **Quote:** "[verbatim]"
+- **Source:** https://... — Date: YYYY-MM-DD — Platform: Reddit/X/HN/G2
+- **Frequency:**
+- **Severity:** high/medium/low
+
+## P10: [Theme]
+
+- **Quote:** "[verbatim]"
+- **Source:** https://... — Date: YYYY-MM-DD — Platform: Reddit/X/HN/G2
+- **Frequency:**
+- **Severity:** high/medium/low
+
+## P11: [Theme]
+
+- **Quote:** "[verbatim]"
+- **Source:** https://... — Date: YYYY-MM-DD — Platform: Reddit/X/HN/G2
+- **Frequency:**
+- **Severity:** high/medium/low
+
+## P12: [Theme]
+
+- **Quote:** "[verbatim]"
+- **Source:** https://... — Date: YYYY-MM-DD — Platform: Reddit/X/HN/G2
+- **Frequency:**
+- **Severity:** high/medium/low
+
+## Sources Inventory (50–100 raw posts — more = stronger)
+
+| # | URL | Platform | Date | Pain |
+|---|---|---|---|---|
+| 1 |  |  |  | P1 |
+| ... |  |  |  |  |
+
+## Synthesis
+
+- Top 3 by frequency:
+
+## Validation
+
+- [ ] P1-P12 headings present (add P13+ if needed — validator checks ≥12)
+- [ ] Each has Quote + URL + Date
+- [ ] ≥12 unique URLs (50–100 recommended)

package/.leancraft/human/discovery/03-competitive.md

@@ -0,0 +1,28 @@
+# 03 — Competitive Teardown
+
+> Status: DRAFT — Min 9 competitors, pricing must have $, min 5 wedges
+
+## Competitors
+
+| # | Name | URL | Pricing | Strength | Weakness |
+|---|---|---|---|---|---|
+| 1 | [Competitor 1] | https://... | $X/mo |  |  |
+
+## Pricing Table (must have $)
+
+| Competitor | Free | Starter | Pro |
+|---|---|---|---|
+|  | $0 | $ | $ |
+
+## Our Wedges
+
+1.
+2.
+3.
+4.
+5.
+
+## Validation
+
+- [ ] ≥9 competitors with URLs
+- [ ] Pricing has $/€/£

package/.leancraft/human/discovery/04-personas.md

@@ -0,0 +1,24 @@
+# 04 — Personas — 5 Personas + Affinity Map
+
+> Status: DRAFT — Min 5 personas
+
+## Persona 1: [Name] — [Role]
+
+- **Demographics:**
+- **Goals:**
+- **Pains:** (link to P# from 02-research.md)
+- **JTBD:** When ... I want ... So ...
+- **Quote:** "[from research]"
+
+## Persona 2–5: [same structure]
+
+## Affinity Map
+
+| Theme | P1 | P2 | P3 | P4 | P5 |
+|---|---|---|---|---|---|
+|  | ● |  | ● |  |  |
+
+## Validation
+
+- [ ] 5 personas with goals/pains/jtbd
+- [ ] Each pain links to P#

package/.leancraft/human/discovery/05-jtbd.md

@@ -0,0 +1,27 @@
+# 05 — JTBD + Empathy Maps + Pain Matrix
+
+> Status: DRAFT
+
+## JTBD Statements
+
+- When [situation] I want [motivation] So I can [outcome] — Persona: [Name] — Pain: P#
+
+## Empathy Maps (1 per persona)
+
+### Persona: [Name]
+- **Says:**
+- **Thinks:**
+- **Does:**
+- **Feels:**
+
+## Pain Matrix
+
+| Pain | P1 | P2 | P3 | P4 | P5 | Priority |
+|---|---|---|---|---|---|---|
+|  | 3 | 1 | 3 | 2 | 1 | P0 |
+
+## Validation
+
+- [ ] JTBD per persona
+- [ ] 5 empathy maps
+- [ ] Pain matrix

package/.leancraft/human/discovery/06-prd.md

@@ -0,0 +1,101 @@
+# 06 — PRD — Goals, Flows, Reqs
+
+> Status: DRAFT — Min 3 flows, 10 FRs. Lean overview, not 20 pages — founder thinks through, agent fills from discovery.
+
+## Goals (P0/P1)
+
+- P0:
+- P1:
+
+## Non-Goals
+
+- Not building:
+
+## Success Metrics (North Star + Activation)
+
+| Metric | Target | Source (from 01-vision) |
+|---|---|---|
+| North Star | [e.g., Weekly infobots created] | 01-vision.md |
+| Activation | [e.g., 1 infobot in 5 min] | 04-personas.md P1 |
+| Retention | [e.g., D7 return] | 05-jtbd.md |
+
+## Assumptions + Open Questions (test in next sprint)
+
+| Assumption | How to test | Owner |
+|---|---|---|
+| [e.g., Solo founders will pay $10] | 5 interviews (02-research P3) | PM |
+| [Open: Do agencies need multi-brand?] | Ask 3 agencies in 04-personas | PM |
+
+## User Flows (≥3)
+
+### Flow 1: [Name] — Persona: [Name]
+1. User ...
+2. System ...
+3. ...
+
+## Functional Reqs (≥10)
+
+| ID | Req | Persona | Flow | Priority |
+|---|---|---|---|---|
+| FR-01 | As [persona] I can ... | P1 | F1 | P0 |
+
+## NFRs
+
+- Performance:
+- Security:
+- A11y: WCAG AA
+
+## Stakeholders / Dependencies (overview)
+
+| Role / System | Person / API | Dependency | Risk if missing |
+|---|---|---|---|
+| [e.g., Stripe] | api.stripe.com | Payments | Cannot charge |
+
+## RACI (light — who decides)
+
+| Decision | R (Does) | A (Owns) | C (Consult) | I (Inform) |
+|---|---|---|---|---|
+| Pricing | PM | Founder | Eng | Users |
+| Ship | Eng | CTO | PM | — |
+
+## PESTEL (light — 1 line each)
+
+- P (Political):
+- E (Economic):
+- S (Social):
+- T (Tech):
+- E (Env):
+- L (Legal):
+
+## 4 Whys (founder thinks, agent maps)
+
+- Why now:
+- Why us:
+- Why this problem:
+- Why not others:
+
+## Timeline / Milestones (light Gantt — P0/P1, not waterfall dates)
+
+| Milestone | Target | Owner | Depends on |
+|---|---|---|---|
+| M1: Alpha (P0 flows) | Wk 4 | Eng | 06-prd FR-01-05 |
+| M2: Beta | Wk 8 | PM | User tests |
+
+## Legal / Compliance (overview)
+
+- Data / PII: (from 07-data.md if exists)
+- IP / License:
+- Regulatory:
+
+## Risks
+
+| Risk | Likelihood | Impact | Mitigation |
+|---|---|---|---|
+|  |  |  |  |
+
+## Validation
+
+- [ ] ≥3 flows + ≥10 FRs with IDs
+- [ ] Success Metrics (North Star + Activation)
+- [ ] Assumptions + Open Questions
+- [ ] RACI, PESTEL, 4 Whys, Timeline, Legal present (overview, 3-5 lines each)

package/.leancraft/human/sprint/map.md

@@ -0,0 +1,22 @@
+# Sprint — Map (Day 1)
+
+> Human owns, agent READ-ONLY
+
+## How-Might-We
+
+- HMW ...
+
+## Target
+
+- Persona:
+- Moment:
+- Metric:
+
+## Map
+
+1. ...
+2. ...
+
+## Validation
+
+- [ ] HMW + target with metric

package/.leancraft/joint/decisions.log.md

@@ -0,0 +1,21 @@
+# Decisions Log — Joint (Human + Agent Append)
+
+> Both can append. Human decisions are final. Agent must cite source.
+
+## 2026-08-30 — Init
+
+- Decision: Adopted Leancraft doc-first structure
+- Why: Solve vibe coding ownership/context drift
+- By: human
+
+## Template
+
+### YYYY-MM-DD — [Title]
+
+- Decision:
+- Why:
+- Alternatives rejected:
+- By: human | agent (source: human/definition/intent.md I2)
+
+---
+*Append only. Never delete.*

package/.leancraft/joint/ledger.jsonl

@@ -0,0 +1,3 @@
+{"ts":"2026-08-30T00:00:00Z","spec":"init","model":"human","cost":0,"calls":0,"sources":[],"event":"leancraft init"}
+{"ts":"2026-08-30T20:27:03.798Z","commit":"no-git","event":"sync","validate":"FAIL — fix errors before Lock"}
+{"ts":"2026-08-30T21:57:01.235Z","commit":"4c68032","event":"sync","validate":"FAIL — fix errors before Lock"}

package/.leancraft/joint/test-report.md

@@ -0,0 +1,20 @@
+# Test Report — Joint (Human + Agent)
+
+> Sprint Day 3 — Human observes 5 real users, agent synthesizes patterns (human validates)
+
+## User 1 — [Name, Persona]
+
+- Task:
+- Observed:
+- Quote:
+
+## User 2–5 — [same]
+
+## Synthesis (agent proposes, human validates)
+
+- Pattern:
+- Fix:
+
+## Validation
+
+- [ ] ≥5 real user notes (validator checks)

package/.leancraft/templates/definition/feature.md

@@ -0,0 +1,32 @@
+# Feature — [NNN-kebab-case, e.g., 042-pdf-export]
+
+> REQUIRED: intent, invariants, oracles, acceptance. 1 per flow from 06-prd.md. Ephemeral — delete when shipped.
+
+## Intent
+
+[1 paragraph, distilled from 06-prd.md Flow N]
+
+## Invariants (scoped to this feature)
+
+- **I1:** [feature-specific, e.g., PDF contains all line items for scopeId]
+- **I2:** ...
+
+## Oracles
+
+- **O1:** Property test: ...
+- **O2:** e2e: ...
+
+## Acceptance (human-checkable)
+
+- [ ] Given ... When ... Then ...
+- [ ] Axe passes
+- [ ] Perf <2s
+
+## Source Trace
+
+- FR-05, Persona: Solo Sree
+
+## Validation
+
+- [ ] Invariants have Check
+- [ ] Source trace present

package/.leancraft/templates/definition/guardrails.md

@@ -0,0 +1,39 @@
+# Guardrails — Security, Perf, A11y, i18n
+
+> REQUIRED: security, performance, a11y, i18n
+
+## Security (from discovery/07-data.md if exists)
+
+- **CWE-89 SQLi:** Never string-concat SQL, use `scopedQuery()` / parameterized
+- **CWE-79 XSS:** Never `innerHTML`, use framework escape
+- **Secrets:** Never commit `.env`, use `wrangler secret`
+- **AuthZ:** Every query scoped by `userId + brandId`
+- **Checks:** `semgrep`, `codeql`
+
+## Performance
+
+- Budget: LCP <2.5s, TTFB <600ms
+- No N+1, paginate >100 rows
+- Check: `autocannon`, `lighthouse`
+
+## A11y
+
+- WCAG AA, axe-core must pass
+- No color-only indicators, ARIA labels required
+
+## i18n
+
+- No hardcoded strings, use `t()` keys
+- Check: `i18n:check` script
+
+## Legal / Privacy (from 06-prd Legal)
+
+- Data / PII: (from 07-data.md if exists)
+- IP / License:
+- Regulatory: (GDPR, etc.)
+- Checks: legal review
+
+## Validation
+
+- [ ] 5 sections present
+- [ ] Each has Check command

package/.leancraft/templates/definition/intent.md

@@ -0,0 +1,33 @@
+# Intent — Global Executable Spec
+
+> REQUIRED: intent, invariants (≥3), oracles (≥2), non-goals. This is the contract agents code against.
+
+## Intent
+
+[1 paragraph: what we are building, distilled from 06-prd.md]
+
+## Invariants (≥3, machine-checkable)
+
+- **I1:** [e.g., totalChargesInScope == SUM(lineItems where scopeId==X)] — Check: `npm run test:invariants`
+- **I2:** [e.g., PDF must be WCAG AA] — Check: `axe-core`
+- **I3:** [e.g., Never string-concat SQL] — Check: `semgrep --config guardrails`
+
+## Oracles (≥2, how we prove invariants)
+
+- **O1:** Property test — `fast-check` generates 500 random inputs, invariant holds
+- **O2:** Security — CodeQL/Semgrep passes
+- **O3:** Perf — `autocannon` <2s for 100 rows, no N+1
+
+## Non-Goals
+
+- Not: ...
+
+## Source Trace
+
+- Derived from: 06-prd.md FR-01, FR-05; Success Metric: Activation; Assumption: [from 06-prd.md]; 04-personas.md P1
+
+## Validation
+
+- [ ] ≥3 invariants with Check command
+- [ ] ≥2 oracles with tool name
+- [ ] Source trace to PRD/persona

package/.leancraft/templates/definition/system.md

@@ -0,0 +1,47 @@
+# System — Architecture & Decisions
+
+> REQUIRED: stack, architecture, decisions, data-model
+
+## Stack (pinned versions)
+
+- Frontend: [e.g., Next.js 15.0.0, React 19]
+- Backend: [e.g., Cloudflare Workers]
+- DB: [e.g., D1, `wrangler.jsonc`]
+- Infra:
+
+## Architecture
+
+```
+[diagram: client → worker → D1, with boundaries]
+```
+
+## Decisions (ADRs distilled)
+
+| Decision | Chosen | Rejected | Why |
+|---|---|---|---|
+| Auth | ... | ... | ... |
+
+## Integrations / Dependencies (from 06-prd Stakeholders)
+
+| System | API / Host | Why | Allowlist |
+|---|---|---|---|
+| ... | ... | ... | → config |
+
+## Deployment / Infra (light)
+
+- Hosting: ...
+- Env: dev / staging / prod
+- CI: ...
+
+## Data Model
+
+- Tables: ...
+- PII handling: (links to discovery/07-data.md if exists)
+- Agents: (links to 08-agents.md if exists)
+- UX: (links to 10-ux.md if exists)
+
+## Validation
+
+- [ ] Pinned versions listed
+- [ ] Architecture diagram present
+- [ ] Decisions have why

package/.leancraft/templates/discovery/00-index.md

@@ -0,0 +1,40 @@
+# 00 — Index — Reading Order & Conventions
+
+> REQUIRED SECTIONS: reading-order, conventions, status-legend, agent-usage
+
+## Reading Order
+
+1. `00-overview.md` → elevator pitch
+2. `01-vision.md` → north star
+3. `02-research.md` → pain themes (P1-P12)
+4. `03-competitive.md` → teardown
+5. `04-personas.md` → who we serve
+6. `05-jtbd.md` → jobs + empathy maps
+7. `06-prd.md` → goals, flows, reqs
+8. `../definition/intent.md` → invariants + oracles (executable)
+9. `../definition/system.md` → architecture
+10. `../definition/guardrails.md` → security/perf/a11y
+11. `../definition/features/*.md` → per-flow specs (ephemeral)
+
+## Conventions
+
+- `human/discovery/**` — PM-owned, agent READ-ONLY
+- `human/definition/**` — Tech-owned, agent READ-ONLY (distilled from discovery)
+- `agent/**` — Agent-owned, auto-generated
+- `joint/**` — Both append
+
+## Status Legend
+
+- `DRAFT` — agent drafted, human not yet approved
+- `LOCKED` — human approved, agent cannot edit (needs `proposals/` + human unlock)
+- `AUTO` — agent-owned, regenerated on `leancraft sync`
+
+## Agent Usage
+
+Agent MUST read `config.json` → `00-index.md` → `00-overview.md` → target doc, in order. Never skip.
+Run `npm run leancraft:validate` before asking to Lock.
+
+## Validation
+
+- [ ] All 4 sections present
+- [ ] No `TODO` / `TBD` placeholders

package/.leancraft/templates/discovery/00-overview.md

@@ -0,0 +1,31 @@
+# 00 — Overview — Elevator Pitch & Stack
+
+> REQUIRED: elevator-pitch, brand-shape, tech-stack, cost-ceiling
+
+## Elevator Pitch
+
+[1 paragraph: what it is, for whom, why now]
+
+## Brand Shape
+
+- Parent brand:
+- Sub-brands:
+- Brand promise:
+
+## Tech Stack
+
+- Frontend:
+- Backend:
+- DB:
+- Infra:
+
+## Cost Ceiling
+
+- Target infra cost: $____/mo
+- Per-user cost ceiling:
+- Cost tracker lives in: `joint/decisions.log.md` or `agent/status.md`
+
+## Validation
+
+- [ ] Cost ceiling has $ value with currency
+- [ ] Stack lists pinned versions

package/.leancraft/templates/discovery/01-vision.md

@@ -0,0 +1,28 @@
+# 01 — Vision — North Star & 3-Year
+
+> REQUIRED: north-star, 10x-vs-parity, 3-year-vision
+
+## North Star
+
+[1 sentence: world with product vs without]
+
+## 10x vs Parity Matrix
+
+| Capability | Parity (must match) | 10x (our wedge) |
+|---|---|---|
+|  |  |  |
+
+## 3-Year Vision
+
+- Year 1:
+- Year 2:
+- Year 3:
+
+## Non-Goals (explicit)
+
+- Not building:
+
+## Validation
+
+- [ ] 10x column has ≥3 wedges
+- [ ] Non-goals listed