Journey Agents

Automates the agent-building stage of a Butterbase journey by reading your plan, registering MCP servers, validating specs, and creating each agent with a smoke test. It delegates to the agents skill for the heavy lifting but adds orchestration: MCP probes must pass before dependent agents are built, write-capable public agents trigger a safety gate, and everything gets logged to your build history. The real win is that it writes specs to your repo as JSON files, not just the database, so agents survive cloning. If you're hand-rolling agents or debugging one-off issues, reach for the agents skill directly. This is for when you have a plan doc and want the whole pipeline to run soup-to-nuts.

GitHub stars: 532
last updated: Jun 11, 2026

View on GitHub

Install

$ npx -y skills add butterbase-ai/butterbase-skills --skill journey-agents --agent claude-code

Installs into .claude/skills of the current project.

Files

Journey: Agents

Build the agents described in 02-plan.md. Order: MCP servers first (probe must pass before any agent references them) → agents → smoke runs.

When to use

Dispatched by journey when current_stage: agents.
Directly via /butterbase-skills:journey-agents.
Skipped (annotated (n/a)) if the plan lists no agents.

Preflight

If docs/butterbase/03-preflight.md is missing, older than 24 hours, or 00-state.md has app_id: null, invoke butterbase-skills:journey-preflight first. Wait for it to return successfully before proceeding.

Inputs

docs/butterbase/02-plan.md — the Agents section (names, purpose, tool list, visibility, MCP servers needed).
docs/butterbase/00-state.md — for app_id.
Any handcrafted spec files under agents/ in the project (preferred — version-controlled and survives clones).