docs: capability-map row + ROADMAP R-23/R-13 + PROMPT-TEMPLATE N.5 for Direction-2 immediate-sync

This commit is contained in:
2026-07-16 21:50:38 +02:00
parent 5c8e6494b7
commit bdb65a80e8
3 changed files with 17 additions and 2 deletions
+14 -1
View File
@@ -284,7 +284,19 @@ Decisions made, architectural state, what's next.
`<repo>/README.md` if architecture/features changed; authoritative architecture/feature docs in
`felhom.eu/documentation/{architecture,controller}/`. Spikes/audits → `felhom.eu/documentation/audits/`.
### N.5 Website version bump (if controller/hub version is shown on the site).
### N.5 Capability map + backlog (end-of-session checklist — easy to forget)
If the task **changed what the platform can do** (new/removed capability, or a capability moved
status), update in the SAME session:
- **`architecture/00-capability-map.md`** — add/adjust the affected *scenario* row with the correct
**status** (PROVEN-LIVE requires an `audits/`|`tests/` citation; else IMPLEMENTED/PARTIAL) and an
evidence citation. A leg not exercised live → PARTIAL/IMPLEMENTED with a note saying which leg and
a `→ R-n` pointer, never PROVEN-LIVE.
- **`backlog/ROADMAP.md`** — add any new open work / deferred legs as an item (next free `R-n`),
collapse a now-shipped item to its one-liner + version, and honor the **coupling rule** (every
roadmap item names the map row it flips; every map gap row points back by ID). Parked sub-features
(e.g. an alternative transport, an agent-plane leg) go as a note under the owning arc's item.
### N.6 Website version bump (if controller/hub version is shown on the site).
---
@@ -403,6 +415,7 @@ AUTHOR CHECKLIST (for Claude.ai — verify before handing to CC)
| 13| Build/deploy commands correct for each repo (controller golden / agent / hub)?| Failed or wrong deploy |
| 14| STOP point explicit for risky/supervised; live-validation hits real pipeline?| Destructive op run unsupervised; F9 bypass |
| 15| Doc routing correct (CHANGELOG cumulative, REPORT overwrite, CONTEXT, README, documentation/)? | Doc drift / cumulative REPORT |
| 15b| Capability changed → `00-capability-map.md` row + status/evidence updated AND `backlog/ROADMAP.md` item added/collapsed (coupling rule)? | Capability map goes stale; deferred legs lost |
| 16| UI strings Hungarian + adult tone + minimal emoji specified? | English/placeholder UI leaking to customers |
| 17| §15 report format demanded so the result is validatable against Gitea? | Unverifiable "done" claims (cardinal rule) |