Ambient Code Reference

AI-assisted development patterns. Each pattern is standalone - adopt what you need.

Patterns

Problem	Pattern
AI context windows fill up fast	Repomap
AI gives inconsistent answers	Codebase Agent
AI misses obvious bugs	Self-Review Reflection
PRs take forever to create	Issue-to-PR Automation
Code reviews are bottleneck	PR Auto-Review
Dependency updates pile up	Dependabot Auto-Merge
Stale issues accumulate	Stale Issue Management
Security feels ad-hoc	Security Patterns
Tests are disorganized	Testing Patterns

Getting Started

See Quickstart for pattern overview and adoption guidance.

Development Setup

git clone https://github.com/ambient-code/reference.git
cd reference

# Install dependencies
uv pip install -r requirements.txt      # Repomap dependencies
uv pip install -r requirements-dev.txt  # Doc tooling

# Install pre-commit hooks (includes repomap auto-update)
pre-commit install

Prerequisites: Python 3.11+, Node.js (for markdownlint and mermaid-cli)

npm install -g markdownlint-cli @mermaid-js/mermaid-cli

Repository Contents

reference/
├── docs/
│   ├── README.md              # Quickstart guide
│   └── patterns/              # Individual pattern docs
├── .claude/                   # Example CBA configuration
├── PRESENTATION-ambient-code-reference.md  # 9-feature overview
└── CLAUDE.md                  # Agent instructions for this repo

Links

• Working Demo: demo-fastapi
• Presentation: PRESENTATION-ambient-code-reference.md

License

MIT - See LICENSE