chaos-controller
Start clean. Stay clean. End clean.
Full-session hygiene for AI-assisted coding. Shell checks at start, QA agents at checkpoints, structured docs at end, lessons loop across sessions.
npx skills add CHAOSAiGENT/chaos-controllerFour Moments
chaos-controller covers every phase of an AI coding session, not just the end.
Session Start
Clean bay
Checks .gitignore coverage, sensitive files, stale branches, and unresolved conflicts before you write a line of code.
Mid-Session
Context pressure nudge
Detects when your context window is getting crowded and recommends what to prune before you lose signal.
Checkpoint
QA + docs + pruning
Three agents run in parallel: mechanical QA on your diffs, roadmap compliance check, and context pruning analysis.
Across Sessions
Lessons loop
Extracts patterns from PM Notes and feeds them into lessons.md so the next session starts smarter.
The Foreman Pattern
Three agents, one command, ~$0.01 per checkpoint.
Inspector Apprentice
Haiku-powered mechanical QA. Scans diffs for leaked secrets, debug artifacts, missing error handling, and test gaps.
Inspector Journeyman
Sonnet-powered spec compliance. Checks your work against the roadmap, flags scope drift, verifies implementation completeness.
Pruner Toolhand
Haiku-powered context analysis. Identifies stale context, recommends pruning, writes to settings.local.json so it sticks.
What You Get
| Feature | Community (Free) | Team ($15/seat/mo) |
|---|---|---|
| Shell check engine | ✓ | ✓ |
| Pre-commit hook | ✓ | ✓ |
| Session docs (logbook + roadmap) | ✓ | ✓ |
| Depth selection (quick / standard / deep) | ✓ | ✓ |
| Lessons loop (cross-session learning) | ✓ | ✓ |
| Foreman + 3 QA agents | ✓ | ✓ |
| Session brief (start-of-session context) | — | ✓ |
| Token accounting + cost trending | — | ✓ |
| Terse mode | — | ✓ |
| PR annotations | — | ✓ |
| Agent adapters (Cursor, Copilot, Windsurf, Gemini CLI) | — | ✓ |
| Context drift detection + locking | — | ✓ |
| Team dashboard | — | ✓ |
Services
Need hands-on help getting your team's AI workflow right?
AI Hygiene Audit
$2K-$5K
We review your team's AI-assisted workflow end to end. Gitignore gaps, context discipline, session documentation, tool setup. Written report with prioritized fixes.
Custom Setup
$3K-$8K
We configure chaos-controller for your stack: custom check rules, agent tuning, CI integration, team onboarding. Includes 30 days of support.
Ongoing Retainer
$1K-$3K/mo
Monthly review of session docs, hygiene metrics, and workflow optimization. Slack access for async questions.
Install in one command
npx skills add CHAOSAiGENT/chaos-controllerFree and open source. Works with Claude Code today.
See what your whole team is building
14-day free trial. No credit card required.