Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (ai-development-framework) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

AIDevelopmentFramework

The system around the AI that makes the AI reliable.

An open-source framework for structured AI-assisted software development. Built on the PIV+E loop (Plan, Implement, Validate, Evolve) — a methodology where the human owns planning and validation, the AI owns implementation, and the system gets smarter with every cycle.

Why This Exists

AI coding assistants are powerful but unpredictable. They lose context, repeat mistakes, and produce code that looks right but isn't. The solution isn't a better AI — it's a better system around the AI: plans that survive session boundaries, rules that prevent known mistakes, agents that maintain architectural knowledge, and a self-improving feedback loop.

Quick Start

Existing Project

Copy .claude/ into your project root
Run /setup to check installed plugins
Run /prime to load context
Run /start to begin

New Project

Copy .claude/ into your project root
Run /setup to install dependencies
Run /start and choose "Starting a new project"

The PIV+E Loop

Plan — Brainstorm, write specs, decompose into issues Implement — TDD, execute plans, use specialist agents Validate — Automated checks, visual testing, code review Evolve — Update rules and knowledge from what was learned

Pipeline Commands

Command	Phase	Purpose
`/start`	Router	Detects what you're doing, routes to the right pipeline
`/prime`	Plan	Loads codebase context into session
`/create-prd`	Plan	Brainstorms and generates a PRD
`/plan-project`	Plan	Decomposes PRD into GitHub milestones and issues
`/plan-feature`	Plan	Creates detailed implementation plan
`/execute`	Implement	Executes plan with TDD, step by step
`/validate`	Validate	Runs lint, tests, visual testing, code review
`/ship`	Validate	Commits, pushes, creates PR
`/evolve`	Evolve	Updates rules and knowledge base
`/setup`	Utility	Checks framework health

What's Inside

.claude/
├── commands/       10 pipeline commands (the workflow)
├── agents/         4 specialist agents + template
├── skills/         Framework-specific skills
├── rules/          Auto-loading domain rules
├── references/     Templates (PRD, plan, issue, patterns)
└── hooks/          Guardrails (branch protection, reminders)

Scope Levels

Level	Entry Point	Pipeline
L0	"I have an idea"	/create-prd then /plan-project then per-issue L2
L1	"I need a feature"	/plan-feature then per-issue L2
L2	"I have issue #42"	/prime then /plan then /execute then /validate then /ship
L3	"There's a bug"	/prime then debug then fix then /validate then /ship

Documentation

Methodology — The PIV+E loop explained
Getting Started — Setup and walkthrough
Command Reference — All commands
Customization — Adding agents, rules, skills
Plugin Install Guide — Dependencies

Credits

Synthesizes approaches from:

Cole Medin's AI Coding Summit Workshop — PIV loop, context resets, plan-as-specification
Real-world battle-tested Claude Code configurations from production development

License

MIT