# Compiler-Owned File Templates

Use these templates for files the knowledge compiler owns.

Keep frontmatter balanced: enough for provenance and maintenance, but not excessive.

## Source Digest

```md
---
type: source-digest
topic: <topic-slug>
status: active
created: <YYYY-MM-DD>
updated: <YYYY-MM-DD>
source_notes:
  - <canonical source path or note link>
derived_from:
  - <optional workspace operation or seed note>
confidence: high
source_url: <optional URL>
---

# <Source Title>

## Why This Matters

## Key Takeaways

## Entities

## Related Concepts

## Open Questions
```

## Local Concept

```md
---
type: concept
topic: <topic-slug>
status: active
created: <YYYY-MM-DD>
updated: <YYYY-MM-DD>
source_notes:
  - <supporting source digest or canonical note>
derived_from:
  - <seed concept or source digest>
confidence: medium
shared_concept:
---

# <Concept Name>

## Definition

## Why It Matters Here

## Supporting Sources

## Tensions

## Implications

## Related Concepts

## Related Outputs
```

After promotion, keep this as a topic-specific application page instead of maintaining a full duplicate of the shared concept.

## Shared Concept

```md
---
type: shared-concept
topic: shared
status: active
created: <YYYY-MM-DD>
updated: <YYYY-MM-DD>
source_notes:
  - <supporting source digests or canonical notes>
derived_from:
  - <origin workspace concepts>
confidence: medium
workspace_origins:
  - <topic-slug>
---

# <Concept Name>

## Definition

## Why It Matters

## Supporting Sources

## Tensions

## Implications

## Related Concepts

## Workspace Applications
```

Only create or update this file during explicit promote or merge operations.

## Output

```md
---
type: output
topic: <topic-slug>
status: active
created: <YYYY-MM-DD>
updated: <YYYY-MM-DD>
source_notes:
  - <source digests or canonical notes used>
derived_from:
  - <concepts or prior outputs>
confidence: medium
output_kind: <brief|comparison|memo|slides|chart|answer>
---

# <Output Title>

## Question

## Answer

## Basis

## Follow-On Questions
```

Save outputs only when they are durable enough to deserve file status.

## Index

```md
# <Topic Name> Index

## Scope

## Sources

## Concepts

## Outputs

## Open Questions

## Promotion Candidates
```

## Health Check

```md
# Health Check

## Coverage Gaps

## Contradictions

## Duplicate or Overlapping Concepts

## Weakly Supported Claims

## Promotion / Merge Candidates

## Next Passes
```

## Log

Use consistent headings so the log stays parseable.

```md
# Log

## [2026-04-06] initialize | <topic-slug>

## [2026-04-06] ingest | <source title>

## [2026-04-06] query | <question slug>

## [2026-04-06] lint | <short note>

## [2026-04-06] promote | <concept slug>

## [2026-04-06] merge | <concept slug>
```