agentic-dev-framework

# Agentic Development Framework

[![Documentation](https://img.shields.io/badge/docs-99%20files-blue)](./DOCUMENTATION_INDEX.md)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](./LICENSE)

> **A methodology framework for AI-assisted software development.** Structure your AI coding workflow with checkpoints, escalation rules, and human oversight to ship quality code faster.

---

## What Problem This Solves

AI coding assistants can generate code fast, but without structure:
- Developers spend too much time validating AI output
- Quality is inconsistent across sessions
- Security issues slip through
- No clear process for when to trust vs. verify

This framework provides **guardrails** that make AI-assisted development predictable, secure, and scalable.

---

## What This Framework Provides

| Component | Purpose |
|-----------|---------|
| **Checkpoints** (C0→C3) | Structured workflow: Scope → Plan → Implement → PR |
| **Escalation Rules** | When AI must stop and ask the human |
| **Quality Gates** | Automated + human verification at each stage |
| **Security Module** | DevSecOps for AI-generated code |
| **Factory Model** | Scale to multiple agents and batch processing |

---

## Start Here

| Your Goal | Start With |
|-----------|------------|
| **Apply to your project** | [Bootstrap Guide](runtime/golden-path/BOOTSTRAP_NEW_PROJECT.md) |
| Learn the workflow | [Agent Quickstart](runtime/golden-path/QUICKSTART_AGENT.md) |
| Understand checkpoints | [Checkpoints Spec](core/spec/CHECKPOINTS.md) |
| See real examples | [Case Studies](case-studies/) |
| Scale to teams | [Factory Model](core/factory-model/) |
| Secure AI code | [Security Module](core/security/) |

---

## The Core Workflow

```
┌─────────────────────────────────────────────────────────────┐
│                    BEFORE ANY WORK                          │
│   Check Escalation Triggers → If any apply → STOP → Ask     │
└─────────────────────────────────────────────────────────────┘