SPEC v0.3: orchestrator resolutions of the plans' open points

Records D-004 and D-015 to D-025: shells and ownership, server seams
(router middleware, rate_limit layer, tasks::start, AuditWriter and PushQueue
traits, next_occurrence_date in kvitt-domain, M3 owns recurring generation,
M4 lands after M3), OpenAPI parsed-value equality, feature convention and
strings, empty fake scenario and resolveRange exception, shared ledger rows and
editor fields in :core:design, no bundled font, pruning at 04:00, development
infrastructure as M2c-dev built it, M2c-pi allowances, release keystore,
production import procedure. Plans and prompts close their open points;
HANDOFF rewritten to the real state; CLAUDE.md: implementation agents never
edit SPEC.md or docs/decisions.md.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-10-17 21:23:38 +02:00
parent c885aba313
commit 76ee957f41
45 changed files with 501 additions and 342 deletions
+4 -4
View File
@@ -7,11 +7,11 @@ Read PLAN-U1.md and follow it; CLAUDE.md rules apply. SPEC.md wins over both. Yo
Numbers (normally none are needed for UX work): next decision {{NEXT_DECISION}}, spec version {{SPEC_VERSION}}, schema version {{SCHEMA_VERSION}}. If a value is still a `{{…}}` placeholder, write `TODO(spec)` wherever a number would go.
Setup and limits:
- Work on branch `agent-ux` in the worktree `.claude/worktrees/agent-ux`: from the main checkout, `git worktree add .claude/worktrees/agent-ux -b agent-ux main`, then `git reset --hard main` inside it. Do not use any other branch or worktree (an old `UX-sprint` branch exists elsewhere; ignore it).
- Work on branch `UX-sprint` in the worktree `~/orca/workspaces/kvitt/UX-sprint` (the owner's separate session); `git rebase main` before reporting. Do not use any other branch or worktree.
- Commit only files under `docs/ux/`. Edit nothing else, SPEC.md and CLAUDE.md included.
- Deliver 2 or 3 directions per SPEC §13.4 phase 1: HTML in a 411 dp phone frame, the six screens S-4, S-7, S-5, S-9, S-11, S-8 in light and dark, Swedish copy, realistic data for Jacob and Anna, PNG exports, and `docs/ux/directions/README.md` with the comparison and your recommendation.
- No external requests except Google Fonts for a font that may be bundled in an Android app. No placeholder text.
- No external requests except Google Fonts. The app bundles no font and uses the Material 3 default typeface (D-020). No placeholder text.
- Stop and ask before installing any tool (for example a headless browser for PNG export).
- Commit on `agent-ux`, `git rebase main`. Never merge, push or remove the worktree.
- Commit on `UX-sprint`, `git rebase main`. Never merge, push or remove the worktree.
Report: end with the report described in PLAN-U1.md §10: branch, head commit hash, files produced with PNG counts, fonts and licences, your recommendation in one line, open questions and spec gaps with section numbers, and the owner's next step ("Review 2-3 directions, pick one, give comments") with the PNG paths.
Report: end with the report described in PLAN-U1.md §10: branch, head commit hash, files produced with PNG counts, typography, your recommendation in one line, open questions and spec gaps with section numbers, and the owner's next step ("Review 2-3 directions, pick one, give comments") with the PNG paths.