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-only or report only (skip remediation, just show report)--fix-all or fix 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 checkingclaude-md-scout — CLAUDE.md/AGENTS.md analysisenv-scout — environment setuptesting-scout — test infrastructurebuild-scout — build systemdocs-gap-scout — README, ADRs, architecture
Production Readiness (haiku, fast)
observability-scout — logging, tracing, metrics, healthsecurity-scout — GitHub settings, CODEOWNERS, secretsworkflow-scout — CI/CD, templates, automation
All 9 scouts run in parallel for speed.
1---2name: flow-next-prime3description: Comprehensive codebase assessment for agent and production readiness. Scans 8 pillars (48 criteria), verifies commands work, checks GitHub settings. Reports everything, fixes agent readiness only. Triggers on /flow-next:prime.4---5
6# Flow Prime
7
8Comprehensive codebase assessment inspired by [Factory.ai's Agent Readiness framework](https://factory.ai/news/agent-readiness).
9
10**Role**: readiness assessor, improvement proposer
11**Goal**: full visibility into codebase health, targeted fixes for agent readiness
12
13## Two-Tier Assessment
14
15| Category | Pillars | What Happens |
16|----------|---------|--------------|
17| **Agent Readiness** | 1-5 (30 criteria) | Scored, maturity level calculated, fixes offered |
18| **Production Readiness** | 6-8 (18 criteria) | Reported for awareness, no fixes offered |
19
20This gives you **full visibility** while keeping remediation focused on what actually helps agents work.
21
22## Why This Matters
23
24Agents waste cycles when:
25- No pre-commit hooks → waits 10min for CI instead of 5sec local feedback
26- Undocumented env vars → guesses, fails, guesses again
27- No CLAUDE.md → doesn't know project conventions
28- Missing test commands → can't verify changes work
29
30These are **environment problems**, not agent problems. Prime helps fix them.
31
32## Input
33
34Full request: $ARGUMENTS
35
36Accepts:
37- No arguments (scans current repo)
38- `--report-only` or `report only` (skip remediation, just show report)
39- `--fix-all` or `fix all` (apply all agent readiness fixes without asking)
40- Path to different repo root
41
42Examples:
43- `/flow-next:prime`
44- `/flow-next:prime --report-only`
45- `/flow-next:prime ~/other-project`
46
47## The Eight Pillars
48
49### Agent Readiness (Pillars 1-5) — Fixes Offered
50
51| Pillar | What It Checks |
52|--------|----------------|
53| **1. Style & Validation** | Linters, formatters, type checking, pre-commit hooks |
54| **2. Build System** | Build tools, commands, lock files, monorepo tooling |
55| **3. Testing** | Test framework, commands, coverage, verification |
56| **4. Documentation** | README, CLAUDE.md, setup docs, architecture |
57| **5. Dev Environment** | .env.example, Docker, devcontainer, runtime version |
58
59### Production Readiness (Pillars 6-8) — Report Only
60
61| Pillar | What It Checks |
62|--------|----------------|
63| **6. Observability** | Logging, tracing, metrics, error tracking, health endpoints |
64| **7. Security** | Branch protection, secret scanning, CODEOWNERS, Dependabot |
65| **8. Workflow & Process** | CI/CD, PR templates, issue templates, release automation |
66
67## Workflow
68
69Read [workflow.md](workflow.md) and execute each phase in order.
70
71**Key phases:**
721. **Parallel Assessment** — 9 haiku scouts run in parallel (~15-20 seconds)
732. **Verification** — Verify test commands actually work
743. **Score & Synthesize** — Calculate scores, determine maturity level
754. **Present Report** — Full report with all 8 pillars
765. **Interactive Remediation** — AskUserQuestion for agent readiness fixes only
776. **Apply Fixes** — Create/modify files based on selections
787. **Summary** — Show what was changed
79
80## Maturity Levels (Agent Readiness)
81
82| Level | Name | Description | Score |
83|-------|------|-------------|-------|
84| 1 | Minimal | Basic project structure only | <30% |
85| 2 | Functional | Can build and run, limited docs | 30-49% |
86| 3 | **Standardized** | Agent-ready for routine work | 50-69% |
87| 4 | Optimized | Fast feedback loops, comprehensive docs | 70-84% |
88| 5 | Autonomous | Full autonomous operation capable | 85%+ |
89
90**Level 3 is the target** for most teams. Don't over-engineer.
91
92## What Gets Fixed vs Reported
93
94| Pillars | Category | Remediation |
95|---------|----------|-------------|
96| 1-5 | Agent Readiness | ✅ Fixes offered via AskUserQuestion |
97| 6-8 | Production Readiness | ❌ Reported only, address independently |
98
99## Guardrails
100
101### General
102- Never modify code files (only config, docs, scripts)
103- Never commit changes (leave for user to review)
104- Never delete files
105- Respect .gitignore patterns
106
107### User Consent
108- **MUST use AskUserQuestion tool** for consent — never just print questions as text
109- Always ask before modifying existing files
110- Don't add dependencies without consent
111
112### Scope Control
113- **Never create LICENSE files** — license choice requires explicit user decision
114- **Never offer Pillar 6-8 fixes** — production readiness is informational only
115- Focus fixes on what helps agents work (not team governance)
116
117## Scouts
118
119### Agent Readiness (haiku, fast)
120- `tooling-scout` — linters, formatters, pre-commit, type checking
121- `claude-md-scout` — CLAUDE.md/AGENTS.md analysis
122- `env-scout` — environment setup
123- `testing-scout` — test infrastructure
124- `build-scout` — build system
125- `docs-gap-scout` — README, ADRs, architecture
126
127### Production Readiness (haiku, fast)
128- `observability-scout` — logging, tracing, metrics, health
129- `security-scout` — GitHub settings, CODEOWNERS, secrets
130- `workflow-scout` — CI/CD, templates, automation
131
132All 9 scouts run in parallel for speed.
majiayu000