aaronrene / knowtation public
overseer.v0.2.0.mdc
91 lines 4.2 KB
Raw
sha256:8915fe406161f95c1681f9469375e7bae5b28c884f00bedbdef65e4b0cd0738d docs(flow): commit FLOW-V0-SPEC.md hygiene for 7A-INT merge Human 19 hours ago
1 ---
2 description: "Docs-first handover of the cross-repo overseer role: snapshot truth per repo, update the durable docs (ROADMAP snapshot, next-session plan, coordination doc), then regenerate the living handover block as a projection of them."
3 globs: "**/*process*, **/*handover*, **/*coordination*, **/*dogfood*"
4 alwaysApply: false
5 ---
6
7 <!-- GENERATED FROM CANONICAL FLOW [email protected] (generator v1) — DO NOT EDIT; regenerate via knowtation flow project -->
8
9 ## Step 1: Snapshot truth per repo, confirmed via muse -C (not ambient).
10
11 **Instruction:** Run muse -C &lt;abs path&gt; status and log for each repo (Scooling, Knowtation, MuseHub) and capture branch, HEAD sha, and dirty state.
12
13 **Trigger:** Run when a chat is getting long, a chat switch is needed, or a session ends with multi-repo state in flight.
14
15 **Boundaries:**
16 - Always target each repo with muse -C &lt;absolute-path&gt; — a bare muse can report an ambient repo
17 - Read only — do not commit or checkout during the snapshot
18 - No secrets in captured output
19
20 **Output shape:** A per-repo line for each repo with real branch, HEAD sha, and dirty flag, each confirmed via -C.
21
22 **Verification:** artifact_exists — Each repo is confirmed via -C (not ambient) and every repo line carries a real branch and sha. (evidence required: yes)
23
24 **Skill refs:** cli:muse -C &lt;abs-repo-path&gt; status, cli:muse -C &lt;abs-repo-path&gt; log
25
26 ## Step 2: Record the current step, next action, and open gates/blockers.
27
28 **Instruction:** Write down the current initiative step, the unambiguous next action, and any open gates or blockers.
29
30 **Trigger:** Run after per-repo truth is captured.
31
32 **Boundaries:**
33 - State the next action so it needs no chat history to interpret
34
35 **Output shape:** A current-step line, a next-action line, and an open-gates/blockers list.
36
37 **Verification:** human_review — The next action is unambiguous. (evidence required: yes)
38
39 ## Step 3: List the boundaries and the cross-repo wiring touched this session.
40
41 **Instruction:** Enumerate the boundaries to honor and the cross-repo wiring touched this session.
42
43 **Trigger:** Run after the step and gates are recorded.
44
45 **Boundaries:**
46 - Boundaries are stated explicitly, not assumed
47
48 **Output shape:** An explicit boundaries list and a cross-repo wiring list for the session.
49
50 **Verification:** human_review — Boundaries are explicit and the cross-repo wiring touched is listed. (evidence required: yes)
51
52 ## Step 4: Update the durable docs FIRST.
53
54 **Instruction:** Update the ROADMAP snapshot, the next-session plan, and the coordination doc so they match reality before any block is written.
55
56 **Trigger:** Run after truth, step/gates, and boundaries are captured.
57
58 **Boundaries:**
59 - Update durable docs before regenerating any handover block
60 - Docs are the source of truth, the block is a projection of them
61
62 **Output shape:** Updated ROADMAP snapshot, next-session plan, and coordination doc reflecting reality.
63
64 **Verification:** artifact_exists — The durable docs are updated and match reality before any block is written. (evidence required: yes)
65
66 ## Step 5: Regenerate the handover block into the living file from the now-current docs.
67
68 **Instruction:** Overwrite docs/OVERSEER-HANDOVER.md with a block regenerated from the updated durable docs, not from memory.
69
70 **Trigger:** Run only after the durable docs are updated.
71
72 **Boundaries:**
73 - The block is a projection of the docs — never hand-written ahead of them
74 - No secrets in the block
75
76 **Output shape:** An overwritten docs/OVERSEER-HANDOVER.md whose block matches the durable docs.
77
78 **Verification:** artifact_exists — The living file is overwritten and its block matches the docs, not memory. (evidence required: yes)
79
80 ## Step 6: Emit the block as the first message of the next chat.
81
82 **Instruction:** Paste the regenerated handover block as the first message of the new chat so the overseer role resumes with no prior history.
83
84 **Trigger:** Run once the living file holds the current block.
85
86 **Boundaries:**
87 - Emit only the projected block — do not add scope beyond the durable docs
88
89 **Output shape:** The handover block, emitted as the first message of the next chat.
90
91 **Verification:** human_review — A new overseer can resume from the emitted block with no prior chat history. (evidence required: yes)
File History 1 commit
sha256:8915fe406161f95c1681f9469375e7bae5b28c884f00bedbdef65e4b0cd0738d docs(flow): commit FLOW-V0-SPEC.md hygiene for 7A-INT merge Human 19 hours ago