Skip to content

ambient-code/reference

Repository files navigation

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

License

MIT - See LICENSE

About

Ambient Code Reference Repository - AI-assisted development best practices

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 3

  •  
  •  
  •