docs/references/ is the small dev.kit knowledgebase for developers and agents.
Use this directory for compact reference material that helps interpret repo contracts and gap output, such as:
- command and workflow contract surfaces
- config contract surfaces
- dependency contract boundaries
- output schema shapes for tool consumers
- agent and developer workflow practices
- repo design guidance
These files are not generated output and not repo-specific app docs.
Use docs/ for dev.kit product and workflow documentation.
Use .rabbit/context.yaml for generated repo facts.