Journey

This is the top-level orchestrator that walks you from "I want to build X" all the way to a deployed Butterbase app, and if you're in a hackathon, through submission too. It reads a state file in your project to figure out where you left off (idea, schema, auth, deploy, etc.) and dispatches to the matching stage skill. You get prompted at each handoff so you can jump ahead or redo steps. The real win is that you don't have to remember the seventeen-step checklist yourself: it tracks which stages are done, skips the ones you don't need (RAG, durable actors, whatever), and knows the right order. If you just want to tweak your schema without the full ceremony, use the standalone stage skills instead.

GitHub stars: 532
last updated: Jun 11, 2026

View on GitHub

Install

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

Installs into .claude/skills of the current project.

Files

Butterbase Guided Journey

End-to-end orchestrator. Walks the user from idea to deployed Butterbase app, and (in hackathon mode) on through submission. Each stage writes a markdown artifact under docs/butterbase/ in the user's project. The orchestrator reads docs/butterbase/00-state.md to know the cursor and dispatches the matching journey-* stage skill.

When to use

Invoke automatically when the user signals end-to-end intent: "I want to build…", "let's build an app", "ship this", "help me build a hackathon project". Invoke explicitly when the user runs /butterbase-skills:journey.

If the user wants to do a single stage only (e.g., just design a schema), defer to the matching standalone skill (schema-design) or per-stage command (/butterbase-skills:journey-schema) instead of starting the full journey.