Start with Outfitter โ scaffold new projects or adopt patterns in existing codebases. Detects context, scans for adoption candidates, and orchestrates phased conversion.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
A direct command skips the review prompt. Inspect the source before running it.
Start with Outfitter โ scaffold new projects or adopt patterns in existing codebases. Detects context, scans for adoption candidates, and orchestrates phased conversion.
Delete the plan directory when adoption is complete
Stage 1: Assess
Run the setup script to scan the codebase and generate the plan.
What to Run
# From the plugin directory (when installed):
./skills/outfitter-start/scripts/setup.sh [project-root]
# Or use the skill's scan functionality directly
The script will refuse to run if a plan already exists (won't override).
What Gets Generated
.agents/plans/outfitter-start/
โโโ PLAN.md # Entry point with navigation
โโโ SCAN.md # Scan results, effort estimates
โโโ stages/ # Task files for each stage
What to Review in SCAN.md
Finding
Meaning
0 throws, 0 custom errors
Greenfield โ skip to Foundation, use fieldguide presets
1-5 throws
Low effort โ straightforward conversions
6-15 throws
Medium effort โ plan your approach
16+ throws
High effort โ work through stages methodically
Custom error classes
Map each to taxonomy (see stages/errors.md)
High console count
Lots of logging to convert (see stages/handlers.md)
Package Discovery table
Review all @outfitter/* options before installing
High blast radius handlers
Split into caller-focused sub-phases before converting
@outfitter/types should be treated as optional unless the target project
has clear branded-type or utility adoption points.
Decision Point
After reviewing SCAN.md:
Greenfield? โ Load fieldguide, use its presets directly
Migration? โ Continue to Stage 2
Stage 2: Configure
Adjust the plan based on your assessment.
What to Do
Open stages/overview.md
Review the status dashboard
Adjust stage order if needed (Paths can run parallel with Handlers)
Add notes about decisions or blockers
Stage Dependencies
Foundation (required first)
โ
โโโ Paths (can run parallel)
โ
โโโ Handlers
โ
โโโ Errors
โ
โโโ Adapters
โ
โโโ Documents (last)
Unknowns: Review throughout, resolve before Documents
Stage 3: Execute
Work through stages in order, updating stages/overview.md as you go.