CortanaROI Brain

schema

2 min read

Schema

Page conventions and templates. Read RESOLVER.md first to decide which directory a page belongs in.

Universal conventions

  • Two layers. Compiled truth above ---, timeline below.
  • Frontmatter. YAML at the top. At minimum: name, type, status.
  • Cross-references. Use [Title](../dir/slug.md) for internal links.
  • Source attribution. Every non-obvious claim cites source and date. Three source types: observed (directly witnessed), derived (from code/data/logs), inferred (reasoning across multiple observations).

Project template

---
name: <Project Name>
type: project
status: active | paused | shipped | archived
---
 
# <Project Name>
 
> One-paragraph executive summary. What this is, why it exists, current state.
 
## State
- **Owner:** Cody (+ any collaborators)
- **Repo path:** <absolute or relative path>
- **Depends on:** <concepts, other projects>
- **Key metrics:** <how we measure success>
 
## Open Threads
- <active item - remove when resolved>
 
## See Also
- [Concept A](../concepts/a.md)
 
---
 
## Timeline
- **YYYY-MM-DD** | Source - What happened.

Concept template

---
name: <Concept Name>
type: concept
status: active | superseded
---
 
# <Concept Name>
 
> <= 200 words of compiled truth. What the framework is and when it applies.
 
## Core claim
<one or two sentences>
 
## Evidence
- <observed | derived | inferred> - <claim>, source, date
 
## When it applies
<conditions>
 
## When it breaks
<counter-examples, edge cases>
 
## See Also
- [Related concept](../concepts/other.md)
 
---
 
## Timeline
- **YYYY-MM-DD** | Source - What happened.

Idea template

---
name: <Idea Name>
type: idea
status: raw | researching | graduating
---
 
# <Idea Name>
 
> One-paragraph pitch. What it is, why it might work.
 
## Hypothesis
<the testable claim>
 
## How to validate
<experiment or data needed>
 
## Cost to try
<engineering effort, data required>
 
## Graduation criteria
<what evidence promotes this to projects/>
 
---
 
## Timeline

Writing template

---
name: <Title>
type: writing
status: draft | published
---
 
# <Title>
 
<prose>

No timeline required for writing - the piece stands on its own.

Cross-reference discipline

  • When you add a link from Page A to Page B, add the reverse link on Page B’s See Also section in the same commit.
  • When you rename a slug, grep the repo and update every reference before committing.
  • When you archive a page, move it to archive/ and leave a stub redirect in the old location for 30 days.

Graph View

Backlinks