knowledge-vault/skills/knowledge-processing/viewpoint-discussion-distil.../runbook.md

80 lines
2.2 KiB
Markdown

# Runbook: Viewpoint Discussion Distillation
## 1. Before Creating A Work Directory
```text
1. Read Knowledge Vault README and VAULT rules.
2. Read this capability folder.
3. Read CCPE runtime handoff and invocation protocol.
4. Confirm target work directory with the user.
5. Confirm whether the first pass stops after source registration or proceeds to segmentation.
```
## 2. First Pass
```text
1. Create the confirmed work directory.
2. Create required subdirectories.
3. Write README.md.
4. Write 00-source-map.md with source metadata and round boundaries.
5. Write 03-run-notes.md with decisions and gates.
6. Create invocation records for the first participant.
7. Stop at the agreed confirmation point.
```
## 3. Segmentation Pass
```text
1. Create worker thread-start packets by source range.
2. Execute or dispatch conversation-segmentation.
3. Write skill-execution-record.md for local execution.
4. Collect source block indexes and worker return packets.
5. Create a continuation handoff before topic discovery.
```
## 4. Topic Discovery Pass
```text
1. Prepare topic-discovery-router invocation packet.
2. Prepare prompt-to-send.md if the participant is external.
3. Stop if real invocation is unavailable.
4. Save returned output with metadata.
5. Draft 01-topic-map.md from accepted returned output.
6. Pause for user confirmation.
```
## 5. Routing And Topic Docs
```text
1. Confirm topic-map.
2. Execute evidence-routing-and-topic-doc-builder by range or topic group.
3. Write 02-material-routing-log.md.
4. Generate topic docs with source material layer and source index.
5. Do not declare completion until coverage audit is accepted.
```
## 6. Audit
```text
1. Prepare lossless-coverage-auditor invocation packet.
2. Save real returned output.
3. Write audits/coverage-audit.md and audits/distortion-risk-log.md.
4. Repair missing or distorted routing.
5. Ask user before any source-disposable claim.
```
## 7. Downstream Handoff
Create downstream packets only after user confirmation.
Possible downstream tracks:
```text
- writing-workbench
- CCPE model or participant work
- engineering project
- scale or rubric extraction
- todo extraction
- continued research
```