Repo Architecture — Filing Rules
Full filing rules: See skills/_brain-filing-rules.mdContract
This skill guarantees:
- Every new page is filed by primary subject (not format, not source)
- The decision protocol is followed for ambiguous cases
- Common misfiling patterns are caught
Phases
- Identify the primary subject. What would you search for to find this page?
- Walk the decision tree:
- About a person → people/{name-slug}.md - About a company → companies/{name-slug}.md - A reusable concept/framework → concepts/{slug}.md - An original idea → originals/{slug}.md - A meeting → meetings/{slug}.md - Media content → media/{type}/{slug}.md - Raw data import → sources/{slug}.md
- Cross-link. Link from related directories.
- Check notability. See
skills/conventions/quality.mdnotability gate.
Output Format
Advisory: "File this at {type}/{slug}.md because the primary subject is {reason}."
Anti-Patterns
- Filing by format ("it's a PDF so it goes in sources/")
- Filing by source ("it came from email so it goes in sources/")
- Creating pages without checking if one already exists
- Using
sources/for anything except raw data dumps