CodeCaptain

AI-assisted iteration framework that brings engineering discipline to AI-driven development.

Why

AI coding assistants are fast but reckless — they skip impact analysis, miss callers, break data formats, and silently introduce bugs. CodeCaptain forces a structured workflow: every change goes through requirements → design → review → develop → test → acceptance. No shortcuts, no silent fixes, no untracked scope creep.

What It Does

• Iteration template — 13-section document covering requirements, code analysis, design, side effects, risks, tests, and acceptance. Ensures nothing is missed before code is written.
• Release template — Aggregates multiple iterations into a release with metrics, compatibility notes, and migration guide.
• AI skills — Three skills that drive the workflow: a router to detect project and intent, a developer skill for iterations, and a coordinator skill for releases. Integrates with FlashCodeGraph for call chain analysis, impact assessment, and code navigation.

Directory Structure

CodeCaptain/
├── templates/              # Document templates
│   ├── iteration.md        # Iteration lifecycle template (13 sections)
│   └── release.md          # Release summary template (13 sections)
├── skills/                 # AI assistant skills
│   ├── project-router.md   # Always loaded — routes to correct project and workflow
│   ├── iteration-developer.md  # On demand — drives iteration lifecycle
│   └── release-coordinator.md  # On demand — drives release process
├── standards/              # Coding standards
│   ├── general.md          # Language-agnostic standards
│   ├── go.md
│   ├── java.md
│   ├── python.md
│   └── typescript.md
└── projects/               # Per-project iteration and release documents
    └── {project-name}/
        ├── iteration-X.X-name.md
        └── release-vX.md

How It Works

1. project-router (always loaded) detects project name and intent from user input.
2. Routes to iteration-developer or release-coordinator skill.
3. The skill drives the full workflow, generating documents from templates.

Setup

1. Copy skills/project-router.md to your AI assistant's skill directory.
2. Edit CODECAPTAIN_ROOT in project-router.md to point to this directory.
3. The other two skills (iteration-developer.md, release-coordinator.md) are loaded on demand by the router — no manual setup needed.

Templates

Iteration Template

Covers the full lifecycle of a change — from requirements to acceptance:

#	Section	#	Section
1	Iteration Goal	8	Test Cases
2	Background	9	Decision Log
3	Existing Code Analysis	10	Development Readiness
4	Feasibility	11	Out of Scope
5	Design	12	Development Summary
6	Side Effects	13	Acceptance
7	Risks

Release Template

Aggregates multiple iterations into a release:

#	Section	#	Section
1	Release Overview	8	Migration Guide
2	Feature List	9	Test Summary
3	New Features	10	Open Items
4	Improvements	11	Roadmap
5	Refactoring	12	Known Limitations
6	Metrics	13	Iteration Index
7	Compatibility