repo-architecture

# Repo Architecture — Filing Rules > **Full filing rules:** See `skills/_brain-filing-rules.md` ## Contract 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 1. **Identify the primary subject.** What would you search for to find this page? 2. **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` 3. **Cross-link.** Link from related directories. 4. **Check notability.** See `skills/conventions/quality.md` notability 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