ai-fob

Research-driven assets for AI coding assistants.

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

Why AI-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.

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

AI-FOB commands enforce a pipeline that gathers version-matched documentation and maps existing codebase files before any code is written.

Installation

# Interactive mode
npx ai-fob

# Install coding preset to current project
npx ai-fob --preset coding

# Install everything globally
npx ai-fob --preset all --global

Options

| Flag | Short | Description | |------|-------|-------------| | --preset <name> | -p | Select preset (coding, cc-assets, all) | | --local | -l | Install to ./.claude/ (default) | | --global | -g | Install to ~/.claude/ | | --list | | List available presets and their contents | | --dry-run | | Show what would be installed without doing it | | --force | -f | Overwrite all files, even locally modified ones | | --help | -h | Show help |

Presets

coding

The full research-driven coding workflow. Includes planning, research, building, and validation.

Skills: brainstorm-plan, convex-best-practices, vercel-react-best-practices, reverse-engineering, testing-and-validation, agent-browser, retrospective-analysis, feature-documentation, FOB-state-context

Agents: architect, builder, build-validator, plan-validator, explorer, docs-researcher

Commands: plan-project, setup-project, create-highlevel-plan-phases, build-phase-V2, build-feature, plan-features, reverse-engineer-from-code, quick-fix, update-docs, learnings, add-todo, handoff

cc-assets

Tools for building Claude Code primitives (skills, agents, commands).

Skills: claude-code-primitives, brainstorm-plan

Agents: meta-agent, meta-architect-agent, meta-validator-agent

Commands: plan-cc-assets-phases, build-cc-assets-phases

all

Everything from both presets.

How Updates Work

Run npx ai-fob@latest --preset coding to upgrade.

• Unmodified files are updated to the latest version
• Locally modified customizable files (like testing-and-validation/SKILL.md) are preserved -- the new version is saved as .ai-fob-new for you to compare
• Your custom assets (agents, skills, commands you created) are never touched
• settings.json is deep-merged -- your existing settings are preserved, new keys are added

A .ai-fob.json file in your .claude/ directory tracks what was installed and detects modifications.

License

MIT