flow_session_to_flow.json
json
sha256:8915fe406161f95c1681f9469375e7bae5b28c884f00bedbdef65e4b0cd0738d
docs(flow): commit FLOW-V0-SPEC.md hygiene for 7A-INT merge
Human
16 hours ago
| 1 | { |
| 2 | "flow": { |
| 3 | "schema": "knowtation.flow/v0", |
| 4 | "flow_id": "flow_session_to_flow", |
| 5 | "title": "Session-to-Flow review", |
| 6 | "version": "0.1.0", |
| 7 | "scope": "personal", |
| 8 | "summary": "At the end of a substantial session, check for a recurring procedure and emit a Flow candidate proposal \u2014 never an auto-Flow.", |
| 9 | "tags": ["agent-ops", "flywheel", "capture"], |
| 10 | "steps": [ |
| 11 | "flow_session_to_flow#1", |
| 12 | "flow_session_to_flow#2" |
| 13 | ], |
| 14 | "inputs": [], |
| 15 | "vault_mirror_path": "meta/flows/session-to-flow.md", |
| 16 | "updated": "2026-06-20T00:00:00Z", |
| 17 | "truncated": false |
| 18 | }, |
| 19 | "steps": [ |
| 20 | { |
| 21 | "schema": "knowtation.flow_step/v0", |
| 22 | "step_id": "flow_session_to_flow#1", |
| 23 | "flow_id": "flow_session_to_flow", |
| 24 | "ordinal": 1, |
| 25 | "owned_job": "Detect whether this session re-derived a recurring, non-obvious procedure worth saving.", |
| 26 | "instruction": "Review the session for a repeated ordered step/skill-ref sequence using bounded structural signals only, and decide if a candidate clears the quality bar.", |
| 27 | "trigger": "Run at the end of a substantial session with the user's opt-in extraction enabled.", |
| 28 | "when_not_to_run": "Skip if extraction is opted out, classroom/minor policy disables capture, the procedure recurred fewer than the threshold sessions, or confidence is low.", |
| 29 | "requires": [ |
| 30 | { "kind": "vault_scope", "id": "personal" } |
| 31 | ], |
| 32 | "boundaries": [ |
| 33 | "Content-minimized \u2014 observe ids, hashes, and counts only; never raw prompts, completions, or note bodies", |
| 34 | "Suppress low-confidence candidates and cap candidates per session", |
| 35 | "Do not widen the inferred scope" |
| 36 | ], |
| 37 | "skill_refs": [ |
| 38 | { "kind": "mcp_prompt", "id": "resume-session" } |
| 39 | ], |
| 40 | "inputs": [], |
| 41 | "outputs": [ |
| 42 | { "name": "signal_summary", "type": "text" } |
| 43 | ], |
| 44 | "output_shape": "A bounded signal summary (trigger_signal, observed_count, scope_hint, confidence) \u2014 or an explicit 'no candidate'.", |
| 45 | "verification": { |
| 46 | "kind": "artifact_exists", |
| 47 | "evidence_required": true, |
| 48 | "description": "A bounded signal summary exists recording the trigger_signal, observed_count, and confidence (or an explicit no-candidate result)." |
| 49 | }, |
| 50 | "automatable": "agent_assisted" |
| 51 | }, |
| 52 | { |
| 53 | "schema": "knowtation.flow_step/v0", |
| 54 | "step_id": "flow_session_to_flow#2", |
| 55 | "flow_id": "flow_session_to_flow", |
| 56 | "ordinal": 2, |
| 57 | "owned_job": "Emit a Flow candidate as a proposal for the user to approve, edit, or reject.", |
| 58 | "instruction": "Produce a knowtation.flow_candidate/v0 proposal with pointer-only evidence and route it to the review tray; never promote it to a Flow.", |
| 59 | "trigger": "Run only when step 1 produced a candidate at or above the confidence threshold.", |
| 60 | "when_not_to_run": "Skip when step 1 returned 'no candidate', or the candidate duplicates an existing Flow above the dedup overlap threshold (offer merge instead).", |
| 61 | "requires": [ |
| 62 | { "kind": "vault_scope", "id": "personal" }, |
| 63 | { "kind": "tool", "id": "knowtation_cli" } |
| 64 | ], |
| 65 | "boundaries": [ |
| 66 | "Never auto-promote a candidate to a Flow \u2014 review-before-write is mandatory", |
| 67 | "Evidence refs are pointers only (run ids, hashes) \u2014 no raw content", |
| 68 | "Candidate title and draft steps are untrusted text", |
| 69 | "Scope is inferred then user-confirmed, never silently widened" |
| 70 | ], |
| 71 | "skill_refs": [ |
| 72 | { "kind": "cli", "id": "knowtation propose <candidate_path> --intent flow_candidate --source agent" } |
| 73 | ], |
| 74 | "inputs": [ |
| 75 | { "name": "signal_summary", "from": "flow_session_to_flow#1.outputs.signal_summary" } |
| 76 | ], |
| 77 | "outputs": [ |
| 78 | { "name": "candidate_proposal_ref", "type": "string" } |
| 79 | ], |
| 80 | "output_shape": "A pending flow_candidate/v0 proposal in the review tray with status pending_review.", |
| 81 | "verification": { |
| 82 | "kind": "human_review", |
| 83 | "evidence_required": true, |
| 84 | "description": "The candidate is recorded as a proposal pending review and is never auto-promoted; the user approves, edits, or rejects it." |
| 85 | }, |
| 86 | "automatable": "manual" |
| 87 | } |
| 88 | ] |
| 89 | } |
File History
1 commit
sha256:8915fe406161f95c1681f9469375e7bae5b28c884f00bedbdef65e4b0cd0738d
docs(flow): commit FLOW-V0-SPEC.md hygiene for 7A-INT merge
Human
16 hours ago