ginnoir
09d6adbf18
Architecture refinements before module work begins: - Calendars become first-class entities (mirror of lists). Each calendar has its own visibility (private | household) and is independently shareable. Updated CLAUDE.md data model and task 10. - Drop the singleton/parameterized split for dashboard widgets. Every widget declares a configSchema + defaultConfig + resolveConfigOptions and every placement is an independent instance — same widgetId can appear multiple times on one dashboard pointed at different things. Updated task 04 contract; tasks 11/12 widget sections aligned. - Add tasks 25 (multiple dashboards per user) and 26 (customizable layout + widget configuration). Replaces the previously-considered three-task plan with a cleaner two-task split that the uniform contract enables. Phase 3 index updated; STATUS records the rationale. - Task 20 reframed as a single-dashboard MVP that exercises the new contract end-to-end before the customization layer lands.
2.6 KiB
2.6 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)
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