Flow Prime
Comprehensive codebase assessment inspired by Factory.ai's Agent Readiness framework.
Role: readiness assessor, improvement proposer Goal: full visibility into codebase health, targeted fixes for agent readiness
Two-Tier Assessment
| Category | Pillars | What Happens |
|---|---|---|
| Agent Readiness | 1-5 (30 criteria) | Scored, maturity level calculated, fixes offered |
| Production Readiness | 6-8 (18 criteria) | Reported for awareness, no fixes offered |
This gives you full visibility while keeping remediation focused on what actually helps agents work.
Why This Matters
Agents waste cycles when:
- •No pre-commit hooks → waits 10min for CI instead of 5sec local feedback
- •Undocumented env vars → guesses, fails, guesses again
- •No CLAUDE.md → doesn't know project conventions
- •Missing test commands → can't verify changes work
These are environment problems, not agent problems. Prime helps fix them.
Input
Full request: $ARGUMENTS
Accepts:
- •No arguments (scans current repo)
- •
--report-onlyorreport only(skip remediation, just show report) - •
--fix-allorfix all(apply all agent readiness fixes without asking) - •Path to different repo root
Examples:
- •
/flow-next:prime - •
/flow-next:prime --report-only - •
/flow-next:prime ~/other-project
The Eight Pillars
Agent Readiness (Pillars 1-5) — Fixes Offered
| Pillar | What It Checks |
|---|---|
| 1. Style & Validation | Linters, formatters, type checking, pre-commit hooks |
| 2. Build System | Build tools, commands, lock files, monorepo tooling |
| 3. Testing | Test framework, commands, coverage, verification |
| 4. Documentation | README, CLAUDE.md, setup docs, architecture |
| 5. Dev Environment | .env.example, Docker, devcontainer, runtime version |
Production Readiness (Pillars 6-8) — Report Only
| Pillar | What It Checks |
|---|---|
| 6. Observability | Logging, tracing, metrics, error tracking, health endpoints |
| 7. Security | Branch protection, secret scanning, CODEOWNERS, Dependabot |
| 8. Workflow & Process | CI/CD, PR templates, issue templates, release automation |
Workflow
Read workflow.md and execute each phase in order.
Key phases:
- •Parallel Assessment — 9 haiku scouts run in parallel (~15-20 seconds)
- •Verification — Verify test commands actually work
- •Score & Synthesize — Calculate scores, determine maturity level
- •Present Report — Full report with all 8 pillars
- •Interactive Remediation — AskUserQuestion for agent readiness fixes only
- •Apply Fixes — Create/modify files based on selections
- •Summary — Show what was changed
Maturity Levels (Agent Readiness)
| Level | Name | Description | Score |
|---|---|---|---|
| 1 | Minimal | Basic project structure only | <30% |
| 2 | Functional | Can build and run, limited docs | 30-49% |
| 3 | Standardized | Agent-ready for routine work | 50-69% |
| 4 | Optimized | Fast feedback loops, comprehensive docs | 70-84% |
| 5 | Autonomous | Full autonomous operation capable | 85%+ |
Level 3 is the target for most teams. Don't over-engineer.
What Gets Fixed vs Reported
| Pillars | Category | Remediation |
|---|---|---|
| 1-5 | Agent Readiness | ✅ Fixes offered via AskUserQuestion |
| 6-8 | Production Readiness | ❌ Reported only, address independently |
Guardrails
General
- •Never modify code files (only config, docs, scripts)
- •Never commit changes (leave for user to review)
- •Never delete files
- •Respect .gitignore patterns
User Consent
- •MUST use AskUserQuestion tool for consent — never just print questions as text
- •Always ask before modifying existing files
- •Don't add dependencies without consent
Scope Control
- •Never create LICENSE files — license choice requires explicit user decision
- •Never offer Pillar 6-8 fixes — production readiness is informational only
- •Focus fixes on what helps agents work (not team governance)
Scouts
Agent Readiness (haiku, fast)
- •
tooling-scout— linters, formatters, pre-commit, type checking - •
claude-md-scout— CLAUDE.md/AGENTS.md analysis - •
env-scout— environment setup - •
testing-scout— test infrastructure - •
build-scout— build system - •
docs-gap-scout— README, ADRs, architecture
Production Readiness (haiku, fast)
- •
observability-scout— logging, tracing, metrics, health - •
security-scout— GitHub settings, CODEOWNERS, secrets - •
workflow-scout— CI/CD, templates, automation
All 9 scouts run in parallel for speed.