---
name: cognitive-compile
description: Deep learning compile framework — transforms raw information into actionable judgment. Use when the user wants to deeply understand a topic, not just capture it.
version: "1.2"
updated: "2026-05-22"
assumes: "The task requires deeper understanding or judgment, not only capture or storage."
conflicts_with: "Do not use when the user only needs ingestion; run wiki-ingest before synthesis when source capture is missing."
---
# Cognitive Compile — Deep Learning Framework
Transform raw information into structured understanding and actionable judgment through 8 explicit sections.
## Usage Template
**Prompt**
```text
Use cognitive-compile on this topic. Move from question to facts, concepts, pattern recognition, conflict detection, hypothesis generation, decision support, and action.
```
**Use Case**
- Understanding a complex topic deeply enough to make a decision or produce a reusable explanation.
**Expected Result**
- The agent produces a structured reasoning artifact with conflicts, judgment, and next actions.
**Output Example**
- An 8-section compile: question, facts, concepts, pattern recognition, conflict detection, hypothesis generation, decision support, and action.
**Verification Case**
- The output separates facts from interpretation and names unresolved assumptions or evidence gaps.
**Verified Effect**
- Raw information becomes a decision-ready understanding with explicit assumptions, conflicts, and actions.
## Success Metrics
- Artifact contains all 8 sections and separates facts, interpretations, assumptions, conflicts, and actions.
- At least one decision-relevant judgment and one evidence gap are explicit.
- Next action is small enough to execute or test in the next work session.
## When to Use
- User wants to "understand X deeply"
- User asks for analysis, synthesis, or judgment
- After ingesting an important source, before filing it away
- User says "help me think through this"
## The 8 Sections
### 1. What is the original question?
Define the core question that makes this exploration worthwhile.
```
Why does this matter?
What am I trying to understand?
What decision will this inform?
```
### 2. What are the key facts?
Extract verifiable claims from the source. Separate observation from interpretation.
- List factual claims with source references
- Note confidence level for each
- Distinguish: firsthand observation vs secondhand report vs inference
### 3. What concepts/entities are involved?
Map the intellectual terrain.
- Link to existing wiki concepts and entities
- Identify relationships between them
- Note: is this connecting previously unconnected ideas?
### 4. Pattern Recognition — what patterns does this resemble?
Connect new knowledge to existing mental models.
- What known pattern does this fit?
- What analogy from a different domain applies?
- Does this confirm or challenge existing models in the wiki?
### 5. Conflict Detection — what conflicts or uncertainties exist?
Surface tensions, contradictions, and gaps.
- Does this source contradict existing wiki pages? → Flag with `> [!warning] Contradiction`
- What is the key uncertainty?
- What information is missing?
### 6. Hypothesis Generation — what can I test?
Turn insight into testable propositions.
```
If X is true, then Y should happen when I try Z.
The cheapest way to test this is...
The evidence that would falsify this is...
```
### 7. Decision Support — what judgment can I form?
Form a tentative thesis — not final truth, but best current understanding.
```
On balance, the evidence suggests that...
The key insight that changes my mental model is...
I'm most uncertain about...
This changes my next decision by...
```
### 8. What can I act on?
Convert understanding into action.
- One thing to do differently
- One thing to investigate further
- One thing to write to the wiki
- One behavior experiment to run, if applicable
- One creativity experiment to run, if applicable
## Output
Save the compile result to the wiki as a concept page or atomic note with these frontmatter fields:
```yaml
---
type: concept | atomic-note
knowledge_stage: captured | cross-checked
evidence_level: single-source | multi-source
---
```
## Quality Gates
- [ ] All 8 sections completed
- [ ] Pattern Recognition is explicit
- [ ] Conflict Detection is explicit
- [ ] Hypothesis Generation is explicit
- [ ] Decision Support is explicit
- [ ] Step 3: linked to ≥2 existing wiki pages
- [ ] Step 5: contradictions flagged if any
- [ ] Final action list includes at least 1 concrete action
- [ ] Result saved to wiki
- [ ] Log updated