Map design IDs to Gitea #1-#37, add tasks 80-88, stub ADRs 0004-0006, and point STATUS at the P1 batch order.
3.8 KiB
3.8 KiB
Task briefs
Each file here is a self-contained brief for a sub-session (typically Sonnet) to execute one chunk of work. Briefs assume the executor has read /CLAUDE.md — do not restate the stack or architecture there.
How to use a brief
- Read
/CLAUDE.mdfirst. - Read the task file end-to-end.
- Stop when all acceptance criteria pass. Do not bolt on extra scope.
- If a brief turns out to be wrong, update the brief in the same commit as the code.
Brief format
Every task file has these sections:
- Goal — one sentence.
- Why — what this unlocks; how it fits the larger plan.
- Depends on — task numbers that must be done first.
- Scope — bullet list of what to build.
- Out of scope — explicit non-goals to prevent drift.
- Acceptance criteria — checkable list. Done = all checked.
- Notes — gotchas, recommended libs, sketches.
Phase index
Phase 1 — Scaffold
- 01 — Repo init & tooling
- 02 — Next.js app skeleton
- 03 — Drizzle + Postgres setup
- 04 — Module loader & registry
- 05 — Compose stack & Caddy
- 06 — Authentik install + OIDC integration
- 07 — Household seeding & session
- 08 — Theming infrastructure (multi-theme + dark mode)
- 09 — Pre-deploy checklist (recurring)
Phase 2 — Core modules
Phase 3 — Dashboard & UX
- 20 — Dashboard composition (single-dashboard MVP)
- 21 — Quick-add registry
- 22 — Activity log
- 25 — Multiple dashboards per user
- 26 — Customizable layout + widget configuration
Phase 4 — Sharing
Phase 5 — Notifications & reminders
Phase 6 — PWA polish
Phase 7 — Hardening
Phase 8 — Garden module
- 70 — Garden infrastructure (MinIO + upload route + schema)
- 71 — Garden containers
- 72 — Garden plants
- 73 — Garden care tracking
- 74 — Garden integrations
- 75 — Garden dashboard
Phase 9 — Post-v0.1
Batch order (bugs → API → editor/notes → journal → agent). Design: docs/superpowers/specs/2026-07-03-backlog-triage-design.md. Issue map: docs/issues-map.md.