Contributing Guides

Long-form contributor and maintainer guides. CONTRIBUTING.md at the repo root is the quick-start contribution guide; these documents elaborate on specific areas without duplicating it.

If a guide conflicts with CONTRIBUTING.md or AGENT.md, the root files win.

Getting started

• CONTRIBUTING.md — quick-start guide, quality bar, branch naming, what gets rejected
• AGENT.md — living architecture doc, read before making changes

Architecture

• Architecture — system layers, data flow, key design decisions, performance targets
• Relationship Graph — knowledge graph, auto-linking, graph-augmented reranking

Contributing guides

• Testing — testing contract, how to run checks, what makes a good core-subsystem test