forked from eva/focus-flow
66 lines
2.9 KiB
Markdown
66 lines
2.9 KiB
Markdown
# Current Software Plan
|
||
|
||
Blocks 01–12 are complete and remain historical records in
|
||
`Codex Documentation/Archived plans/`. The active path resumes at Block 13.
|
||
|
||
The backend sequence is Blocks 11–17. Block 18 is a deliberately limited UI
|
||
foundation block and is blocked until the backend completion gate in Chunk 17.4
|
||
passes.
|
||
|
||
## Execution rules
|
||
|
||
1. Read `AGENTS.md` first.
|
||
2. Read `V1_BACKEND_COMPLETION_GAP_MATRIX.md` before starting Block 11.
|
||
3. Execute active block documents in numeric order.
|
||
4. Execute only the next chunk or stage requested by the user.
|
||
5. Respect every `BREAKPOINT` as a hard stop.
|
||
6. When the next chunk changes recommended Codex level, stop and ask the user to
|
||
confirm the mode switch before continuing.
|
||
7. Run the relevant formatter, analyzer, unit tests, contract tests, and
|
||
integration tests before claiming a chunk is complete.
|
||
8. Commit completed bounded work with a descriptive conventional commit.
|
||
9. Mark a completed plan `Complete`, move it to
|
||
`Codex Documentation/Archived plans/`, and commit the archive move.
|
||
10. Do not rewrite archived Blocks 01–10 to make new work appear previously
|
||
complete. Add errata or new active work instead.
|
||
|
||
## Scope guardrails
|
||
|
||
Backend V1 includes the application-facing use cases, persistence schema,
|
||
MongoDB adapter boundary, deterministic scheduling behavior, internal statistics,
|
||
and UI-independent read models required by Today, Backlog, quick capture, locked
|
||
time, rollover, surprise logging, child tasks, free slots, project defaults, and
|
||
reminder policy decisions.
|
||
|
||
Backend V1 does not include week/month views, reports, overwhelm shield,
|
||
burnout catch-up, drag-and-drop, a visible task-history panel, task dependencies,
|
||
context tags, advanced sync, user accounts, production authentication, or
|
||
flexible-task overrun behavior.
|
||
|
||
The UI must never receive a MongoDB connection string or database credentials.
|
||
Block 16 must choose and document a trusted runtime boundary before adding a
|
||
runtime database dependency.
|
||
|
||
## Active plan index
|
||
|
||
| Order | Plan | Status | Backend/UI |
|
||
|---|---|---|---|
|
||
| 11 | `../Archived plans/V1_BLOCK_11_Backend_Baseline_Domain_Contracts.md` | Complete, archived | Backend |
|
||
| 12 | `../Archived plans/V1_BLOCK_12_Occupancy_Scheduling_Correctness.md` | Complete, archived | Backend |
|
||
| 13 | `V1_BLOCK_13_Lifecycle_Statistics_Project_Reminders.md` | Planned | Backend |
|
||
| 14 | `V1_BLOCK_14_Application_Use_Cases_Read_Models.md` | Planned | Backend |
|
||
| 15 | `../Archived plans/V1_BLOCK_15_Persistence_Schema_Codecs_Repositories.md` | Complete, archived | Backend |
|
||
| 16 | `V1_BLOCK_16_MongoDB_Runtime_Adapter.md` | In progress | Backend |
|
||
| 17 | `V1_BLOCK_17_Backend_Acceptance_Handoff.md` | Planned | Backend gate |
|
||
| 18 | `V1_BLOCK_18_UI_Foundation_Design_Spike.md` | Planned, blocked | UI foundation |
|
||
|
||
## Recommended mode labels
|
||
|
||
Chunks and stages use only:
|
||
|
||
- `low`
|
||
- `medium`
|
||
- `high`
|
||
- `extra high`
|
||
|
||
Blocks do not receive a Codex thinking-level classification.
|