https://github.com/YotpoLtd/cADR
🤖 AI-powered ADR generation - Automatically capture and document architectural decisions as you code
https://github.com/YotpoLtd/cADR
adr architectural-decision-records cicd coding-agents continues-ai documentation llm precommit-hooks
Last synced: 15 days ago
JSON representation
🤖 AI-powered ADR generation - Automatically capture and document architectural decisions as you code
- Host: GitHub
- URL: https://github.com/YotpoLtd/cADR
- Owner: YotpoLtd
- License: mit
- Created: 2025-10-05T18:14:16.000Z (about 2 months ago)
- Default Branch: master
- Last Pushed: 2025-11-09T08:04:26.000Z (17 days ago)
- Last Synced: 2025-11-09T10:09:09.336Z (17 days ago)
- Topics: adr, architectural-decision-records, cicd, coding-agents, continues-ai, documentation, llm, precommit-hooks
- Language: TypeScript
- Homepage: https://www.npmjs.com/package/cadr-cli
- Size: 524 KB
- Stars: 4
- Watchers: 0
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
- awesome-continuous-ai - Continuous Architectural Decision Records (cADR) - AI-powered ADR generation - Automatically capture and document architectural decisions as you code (Categories / Continuous Documentation)
README
# cADR - Continuous Architectural Decision Records
[](https://github.com/YotpoLtd/cADR/actions/workflows/test.yml)
[](https://www.npmjs.com/package/cadr-cli)
[](https://opensource.org/licenses/MIT)
> Automatically capture and document architectural decisions as you code.
Stop losing track of important architectural decisions. cADR analyzes your code changes with LLMs and generates comprehensive ADRs automatically, keeping your documentation in sync with your code.
## ✨ Why cADR?
- **Never miss a decision**: Automatically detects architecturally significant changes
- **Stay in flow**: Works with your existing Git workflow, never blocks commits
- **AI-powered documentation**: Generates comprehensive ADRs in MADR format
- **Smart and fast**: Analyzes only what matters with configurable ignore patterns
## 🚀 Quick Start
Get cADR running in under 2 minutes:
```bash
# Install
npm install -g cadr-cli
# Set your API key (choose one)
export OPENAI_API_KEY="sk-your-api-key-here"
# OR
export GEMINI_API_KEY="your-api-key-here"
# Navigate to your Git repository
cd /path/to/your/repo
# Initialize configuration
cadr init
# Make some changes, then analyze
cadr analyze
```
**[→ Full Quick Start Guide with Examples](./docs/QUICK_START.md)**
## 🎯 Key Features
- 🤖 **LLM-Powered Analysis** - OpenAI and Gemini integration to detect architecturally significant changes
- 📝 **Automated ADR Generation** - Generates comprehensive Markdown ADRs following the MADR template format
- ⚡ **Git Integration** - Analyzes staged changes, uncommitted changes, or commit ranges
## 📚 Documentation
### For Users
- **[Quick Start Guide](./docs/QUICK_START.md)** - Get started in 5 minutes
- **[Usage Guide](./docs/USAGE.md)** - Detailed command reference and configuration
- **[ADR Generation](./docs/ADR_GENERATION.md)** - How automatic ADR creation works
- **[MADR Template](./docs/MADR_TEMPLATE.md)** - ADR format reference
### For Contributors
- **[Contributing Guide](./CONTRIBUTING.md)** - How to contribute to cADR
- **[Development Setup](./DEVELOPMENT.md)** - Set up your local dev environment
- **[Testing Guide](./TESTING.md)** - Running and writing tests
## 📦 Installation
### Quick Install
```bash
npm install -g cadr-cli
```
### Verify Installation
```bash
cadr --version
# Output: cADR version 0.0.1 (core: 0.0.1)
```
For more installation options and configuration, see the [Usage Guide](./docs/USAGE.md).
## 🔧 Configuration
cADR is configured via `cadr.yaml` in your project root. Run `cadr init` to create it interactively, or create it manually:
```yaml
provider: openai
analysis_model: gpt-4
api_key_env: OPENAI_API_KEY
timeout_seconds: 15
ignore_patterns:
- node_modules/**
- "*.test.ts"
- dist/**
```
**Supported Providers:**
- **OpenAI**: All OpenAI chat models
- **Gemini**: All Google Gemini models
Specify any model name supported by your chosen provider. See the [Usage Guide](./docs/USAGE.md#configuration) for all configuration options.
## 🏗️ What Gets Generated?
When cADR detects an architecturally significant change, it generates a comprehensive ADR including:
- **Context and Problem Statement** - Why the decision was needed
- **Decision Drivers** - Key factors influencing the choice
- **Considered Options** - Alternative approaches evaluated
- **Decision Outcome** - The chosen approach and detailed rationale
- **Consequences** - Both positive and negative impacts
Generated ADRs follow the [MADR (Markdown Architectural Decision Records)](https://adr.github.io/madr/) format with sequential numbering.
📖 **[Learn More About ADR Generation →](./docs/ADR_GENERATION.md)**
## 🤝 Contributing
We welcome contributions! Whether you're fixing bugs, adding features, or improving documentation:
1. Read the [Contributing Guide](./CONTRIBUTING.md)
2. Set up your [Development Environment](./DEVELOPMENT.md)
3. Check out the [Testing Guide](./TESTING.md)
4. Submit a Pull Request
## 🆘 Support & Community
- 📖 [Documentation](./docs) - Comprehensive guides and references
- 🐛 [Report Issues](https://github.com/YotpoLtd/cADR/issues) - Found a bug?
- 💬 [Discussions](https://github.com/YotpoLtd/cADR/discussions) - Questions and ideas
- 🔄 [Changelog](./CHANGELOG.md) - What's new in each release
## 📄 License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
---
**[Quick Start](./docs/QUICK_START.md)** • **[Usage Guide](./docs/USAGE.md)** • **[Contributing](./CONTRIBUTING.md)** • **[Development](./DEVELOPMENT.md)**
Made with ❤️ by the cADR team