open-knowledge-pack-knowledge-base-consolidate
Consolidate — promote research into a canonical article
This skill is pack guidance. The platform
open-knowledgeskill (read/write/preview/linking/grounding rules) still governs every markdown operation — this layers the procedure on top.
Promote existing research on a topic into a canonical article under articles/. Canonical, not provisional — the output is the source of truth for future agents, not a snapshot of uncertainty.
The content directory is the resolved content.dir — read it with config({ key: 'content.dir' }) if you don't already know it. Paths below are relative to it.
STOP gate: has a decision actually been made?
Consolidation is promotion, not creation. If the team hasn't decided, the resulting "canonical" article lies about the team's state of understanding — future agents read it, act on it, and the false certainty compounds.
Before any write, confirm out loud with the user:
- What is the actual decision? (e.g., "We chose Yjs for CRDT" — not "Yjs is one option")
- What alternatives were considered and rejected? (these go in "Alternatives considered," not as equals)
- What's the rationale the team used? (not your reconstruction from sources)
If the decision is still open, do not consolidate. Tell the user: "The research is still provisional. When the team decides, come back and consolidate with the outcome." Then stop.