{ "version": "1.0.0", "companion": "_brain-filing-rules.md", "description": "Canonical (machine-readable) brain filing rules. The .md companion is the human explainer; this JSON is what `gbrain check-resolvable` audits against. Keep both in sync.", "rules": [ { "kind": "person", "directory": "people/", "examples": ["founders", "investors", "attendees", "contacts"], "description": "A page whose primary subject is one person." }, { "kind": "company", "directory": "companies/", "examples": ["portfolio companies", "acquirers", "vendors"], "description": "A page whose primary subject is one company or organization." }, { "kind": "deal", "directory": "deals/", "examples": ["seed rounds", "acquisitions"], "description": "A page whose primary subject is a financing or M&A transaction." }, { "kind": "meeting", "directory": "meetings/", "examples": ["1:1s", "pitches", "pods"], "description": "A meeting transcript or minutes. Propagate entities to companies/ and people/ pages." }, { "kind": "concept", "directory": "concepts/", "examples": ["mental models", "theses", "frameworks"], "description": "A reusable idea, framework, or mental model not tied to a specific person/company." }, { "kind": "project", "directory": "projects/", "examples": ["internal initiatives", "multi-session work"], "description": "A multi-session piece of work with its own arc." }, { "kind": "analysis", "directory": "analysis/", "examples": ["deep dives", "comparative studies"], "description": "A long-form analysis of a specific topic." }, { "kind": "civic", "directory": "civic/", "examples": ["policy analysis", "government topics"], "description": "Public-sector, policy, or civic-issue content." }, { "kind": "writing", "directory": "writing/", "examples": ["essays", "drafts", "published pieces"], "description": "A piece of prose authored by the user." }, { "kind": "guide", "directory": "guides/", "examples": ["runbooks", "how-to docs"], "description": "A guide or runbook authored for future reference." }, { "kind": "tech", "directory": "tech/", "examples": ["APIs", "libraries", "language notes"], "description": "Technical references and tooling notes not tied to a specific company." }, { "kind": "finance", "directory": "finance/", "examples": ["market data", "metrics"], "description": "Financial reference data not tied to a single deal." }, { "kind": "personal", "directory": "personal/", "examples": ["logistics", "family"], "description": "Personal-life content — kept separate from work." }, { "kind": "openclaw", "directory": "openclaw/", "examples": ["agent-state notes"], "description": "Notes about the host OpenClaw agent itself, not the underlying entities." } ], "sources_dir": { "directory": "sources/", "purpose": "ONLY for raw data: bulk imports, API dumps, periodic captures. A page with a clear primary subject (person, company, concept) does NOT belong here.", "not_for": ["articles about a person", "analyses of a company", "reusable frameworks"] }, "notes": [ "The PRIMARY SUBJECT of the content determines the directory, not the format or source skill.", "When in doubt: what would you search for to find this page again?", "Cross-link from related directories via back-links — do not duplicate content." ] }