29 lines
1.9 KiB
Markdown
29 lines
1.9 KiB
Markdown
# SOP Governance Tool — Spec Pack (Stage 1)
|
||
|
||
Complete specification suite for the single-tenant SOP governance tool, written to be dropped into the project repository and used by **Claude Code**.
|
||
|
||
## Reading order (human)
|
||
| # | File | What it answers |
|
||
|---|------|-----------------|
|
||
| 1 | `docs/01-PRD.md` | What we're building, for whom, and what we're deliberately NOT building |
|
||
| 2 | `docs/02-FRD.md` | Every functional requirement with testable acceptance criteria (FR-x.x) |
|
||
| 3 | `docs/03-architecture.md` | Stack, directory layout, and the 6 architectural decisions (AD-1…AD-6) |
|
||
| 4 | `docs/04-database-schema.md` | Full Postgres DDL, JSON shapes, RLS policy matrix, seed plan |
|
||
| 5 | `docs/05-api-spec.md` | Every mutation & AI route with request/response examples and error codes |
|
||
| 6 | `docs/06-ui-ux.md` | Screen-by-screen specs, design tokens, mobile staff experience |
|
||
| 7 | `docs/07-development-plan.md` | M0–M7 milestones, weekly rhythm, scope-cut order |
|
||
| 8 | `CLAUDE.md` | Session-by-session implementation plan + working rules for Claude Code |
|
||
|
||
## How to use with Claude Code
|
||
1. Create your repo, copy this whole folder in (`CLAUDE.md` at repo root, `docs/` alongside).
|
||
2. Open Claude Code in the repo. It reads `CLAUDE.md` automatically.
|
||
3. Say: **"Read CLAUDE.md and docs/07-development-plan.md, then start Session S1."**
|
||
4. One session at a time. Run each milestone's ✅ checklist before moving on.
|
||
|
||
## Scope guardrails
|
||
- **Stage 1 only:** one company, fixed roles, 1-level approval, minimal incident log (report + review, no escalation workflows), no billing, no WhatsApp API (share links manually).
|
||
- **Stage-2 ready by design:** `org_id` on every table + RLS from day one — multi-tenant SaaS later is an evolution, not a rewrite.
|
||
- If a feature isn't in `02-FRD.md`, it is out of scope. Add it to a "later" list, don't build it.
|
||
|
||
Parent documents: BRD v1.1 · Solo-Founder Roadmap (Stage 0 → 1 → 2).
|