79 lines
2.3 KiB
Markdown
79 lines
2.3 KiB
Markdown
# Capability Spec: Viewpoint Discussion Distillation
|
|
|
|
## 1. Purpose
|
|
|
|
Convert a long viewpoint discussion into a durable Knowledge Vault material package without losing source traceability.
|
|
|
|
## 2. Inputs
|
|
|
|
```text
|
|
- source document path
|
|
- source type
|
|
- source primary language
|
|
- known boundary rule
|
|
- intended use
|
|
- output workspace path
|
|
- optional seed topics
|
|
- optional forbidden merges
|
|
- optional downstream intent
|
|
```
|
|
|
|
## 3. Outputs
|
|
|
|
```text
|
|
- README.md
|
|
- 00-source-map.md
|
|
- 01-topic-map.md
|
|
- 02-material-routing-log.md
|
|
- 03-run-notes.md
|
|
- topics/
|
|
- audits/
|
|
- model-mining/
|
|
- handoff/
|
|
- invocations/
|
|
```
|
|
|
|
## 4. Operating Principle
|
|
|
|
First preserve, then structure.
|
|
|
|
The source material layer must remain separate from the structured viewpoint layer. Topic documents may reorganize ideas, but must keep source block ids and enough original material to support later reuse.
|
|
|
|
For discussion sources that fit a high-context participant, first get a whole-source gestalt alignment before segmentation. The global portrait prevents chunk-first workers from flattening tools, layers, cases, action tracks, and model upgrades into false peer topics.
|
|
|
|
Step 0 determines downstream mode:
|
|
|
|
```text
|
|
coherent -> structure-first mode with biased workers
|
|
mixed -> macro-topic split mode
|
|
fragmented -> flat-topic discovery mode with minimally biased workers
|
|
```
|
|
|
|
The Step 0 output must be checked by the user. It may repeat multiple times under human correction before it becomes the structure lens for workers.
|
|
|
|
Human confirmation artifacts must primarily use the source primary language unless the user explicitly requests another language.
|
|
|
|
## 5. Human Gates
|
|
|
|
```text
|
|
Gate 1: Confirm workspace path.
|
|
Gate 2: Confirm source block convention.
|
|
Gate 3: Confirm Step 0 gestalt alignment, macro-topic split, or recorded exception.
|
|
Gate 4: Confirm candidate topic-map / topic hierarchy.
|
|
Gate 5: Confirm material routing.
|
|
Gate 6: Confirm topic docs / extracted material usefulness.
|
|
Gate 7: Confirm audit repair strategy.
|
|
Gate 8: Confirm downstream routing.
|
|
```
|
|
|
|
## 6. Acceptance Criteria
|
|
|
|
```text
|
|
- every source block has a routing status
|
|
- every formal participant output has a valid record
|
|
- no topic document relies only on summary
|
|
- low-confidence routing remains visible
|
|
- source-disposable claims are blocked until coverage audit
|
|
- downstream work is optional and user-confirmed
|
|
```
|