recreate-fob

A research-first planning toolkit for AI coding assistants.

FOB deploys slash commands, agents, and skills into your project for Claude Code, OpenCode, and Codex. It enforces a structured workflow: plan the task, research the documentation, design the implementation, then build.

Why FOB?

LLM training data goes stale. When AI coding agents skip documentation research because an API seems "standard" or "well-known," they produce implementations built on outdated assumptions. These fail against current library versions, costing far more in rework than upfront research would have.

Prefer retrieval-based reasoning over pre-training-led reasoning.

FOB commands enforce a pipeline that gathers version-matched documentation and maps existing codebase files before any code is written. The result is implementation plans verified against real docs, not stale training data.

The Workflow

FOB structures feature development into four stages:

1. Plan -- Create a high-level plan that categorizes the task, assesses complexity, and outlines scope
2. Research -- Scrape version-matched documentation and map relevant codebase files (run in parallel)
3. Design -- Build a detailed implementation plan informed by the research, reviewable before any code is written
4. Build -- Implement with confidence against a validated, research-backed plan

| Stage | Command(s) | |-------|-----------| | Plan | /FOB:create_highlevel_plan | | Research | /FOB:get_docs_for_highlevel_plan + /FOB:get_files_for_highlevel_plan | | Design | Detailed implementation plan (informed by research outputs) | | Build | Implementation and verification |

For greenfield projects, FOB also provides a project initialization pipeline: /FOB:plan_project -> /FOB:iterate_spec -> /FOB:init_project -> /FOB:plan_features.

Installation

npx recreate-fob --local

Installs FOB assets to your current project directory.

Options

• --local -- Install to the current directory (default)
• --global -- Install to your home directory (~/)
• --help -- Show help information

What Gets Installed

Configuration files for multiple AI coding assistants:

• Claude Code (.claude/) -- Commands, agents, and skills
• OpenCode (.opencode/) -- Mirrored assets
• Codex (.codex/) -- Mirrored assets

Plus a shared forward-operating-base/ directory containing version tracking and templates.

Commands

Task Planning Pipeline

| Command | Description | |---------|-------------| | /FOB:create_highlevel_plan | Categorize a task and generate a starting-point plan (feature, bug fix, or chore) | | /FOB:get_docs_for_highlevel_plan | Scrape version-matched documentation for a plan's technology stack | | /FOB:get_files_for_highlevel_plan | Map existing codebase files and integration points relevant to a plan |

The docs and files commands are independent and can be run in parallel for the same plan.

Project Initialization

| Command | Description | |---------|-------------| | /FOB:plan_project | Interactive prompt to gather requirements and generate a codebase spec | | /FOB:iterate_spec | Iterate on the codebase spec through guided questions | | /FOB:init_project | Scaffold a project from a spec (frontend, backend, Docker, scripts) | | /FOB:plan_features | Build or extend the FEATURES.md backlog interactively |

Utilities

| Command | Description | |---------|-------------| | /FOB:add-todo | Capture and categorize todos, routing to the appropriate spec file | | experts/codebase/self-improve | Validate and update codebase expertise against actual implementation |

Agents

| Agent | Description | |-------|-------------| | FOB-docs-scraper | Documentation scraping specialist for fetching and saving docs as markdown |

Skills

| Skill | Description | |-------|-------------| | FOB-state-context | Ensures project state files (STATE.md, FEATURES.md, TODO.md) exist before task execution |

How Updates Work

When you run npx recreate-fob@latest --local:

• commands/FOB/ directory is fully replaced with the latest versions
• FOB-prefixed agents and skills are replaced with the latest versions
• Your custom content (agents, skills, and commands without the FOB prefix) is preserved

License

MIT