39 lines
2.1 KiB
Markdown
39 lines
2.1 KiB
Markdown
---
|
|
name: deriving-tech-log-root-tree
|
|
description: Use when a completed or substantially completed docs project analysis must be decomposed into grounded Tech Log Topics and candidate Case, Reference, Open Question, and Decision records.
|
|
---
|
|
|
|
# Deriving Tech Log Root Tree
|
|
|
|
## Core rule
|
|
|
|
**Discover record candidates from evidence already present in the detailed analysis. Do not brainstorm a content calendar.**
|
|
|
|
## Required sequence
|
|
|
|
1. Read project `state.json`, `final/document.md`, and `source-index.md`.
|
|
2. Read bounded analysis files when the final document's anchor is not enough to judge classification.
|
|
3. Identify coherent Topics from shared engineering problem spaces, not merely folder/module names.
|
|
4. Within each Topic, identify concrete incidents first (Case), then reusable rules (Reference), unresolved unknowns (Open Question), and explicit project choices (Decision).
|
|
5. Write the human-readable PROJECT/TOPIC tree.
|
|
6. Add a Node Specification for every title with source anchors, readiness, relations, and kind-specific metadata.
|
|
7. Run `references/decomposition-checklist.md`.
|
|
8. Hash the source detailed document and record the project revision so downstream generation can detect staleness.
|
|
|
|
Use `.agents/skills/writing-tech-log-records/references/root-tree-contract.md` as the output contract.
|
|
|
|
## Topic boundary
|
|
|
|
A Topic is a stable problem/decision area whose records share terminology, evidence, and relations. It should be broad enough to connect several records when the evidence supports them, but narrow enough that its References and Decisions remain coherent.
|
|
|
|
Do not create one Topic per source file. Do not force unrelated incidents into one Topic because they use the same framework.
|
|
|
|
## Classification discipline
|
|
|
|
- Case title names the concrete engineering problem/verification, not a generic technology lesson.
|
|
- Reference title names a reusable criterion/distinction.
|
|
- Open Question title states an uncertainty that is still unresolved.
|
|
- Decision title states an actual/proposed project direction evidenced in sources.
|
|
|
|
Branches may be empty. Symmetry is not a quality goal.
|