ginnoir
8bf00c326d
Populates the decisions index with the two existing ADRs (list SSE/notify, release workflow). Adds task 09 to the phase 1 list and adds the phase 8 garden module task entries to the task index.
3.1 KiB
3.1 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