journey-ai
Journey-ai is stage 3f of the Butterbase guided journey that configures AI gateway defaults including model selection and bring-your-own-key settings. Use it when the journey orchestrator reaches the ai stage, or directly invoke it after preflight checks pass, provided the plan includes an AI section requiring LLM or embeddings usage.
git clone --depth 1 https://github.com/butterbase-ai/butterbase-skills /tmp/journey-ai && cp -r /tmp/journey-ai/skills/journey-ai ~/.claude/skills/journey-aiSKILL.md
# Journey: AI Stage 3f of the guided journey. Configure AI gateway defaults (model, BYOK). ## When to use - Dispatched by `journey` when `current_stage: ai`. - Directly via `/butterbase-skills:journey-ai`. - Skipped (annotated `(n/a)`) if the plan has no AI section. ## 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 AI section. - `docs/butterbase/00-state.md` — for `app_id`. ## Procedure 0. **Refresh docs.** Call `butterbase_docs` with `topic: "ai"`. For BYOK and model lists, also WebFetch `https://docs.butterbase.ai/ai`. Skip if cache is fresh. 1. Read the AI section. Print it back: `"About to configure AI: default model=<m>, BYOK=<yes/no>. Proceed?"`. Wait for `yes`. 2. Invoke `butterbase-skills:ai` via the Skill tool with the AI plan and `app_id`. The wrapped skill calls `manage_ai action: update_config` (and per-provider key updates if BYOK). 3. Smoke: call `manage_ai action: chat` with a tiny prompt (`"say ok"`) to confirm the gateway responds. 4. Append one line to `docs/butterbase/04-build-log.md`: `<ISO timestamp> ai manage_ai ok` 5. Tick `- [x] ai` in `00-state.md`, set `current_stage:` to the next unchecked stage. 6. Return to `journey` orchestrator (or ask `"Continue to the next stage? (yes/no)"`). ## Outputs - Configured AI gateway defaults. - One line in `04-build-log.md`. ## Anti-patterns - ❌ Echoing BYOK keys back to the user. - ❌ Picking a model not in `manage_ai action: list_models` — list first.
Claude Code plugin for Butterbase — 30+ guided skills and auto-configured MCP for the AI-native backend-as-a-service.
Use when calling the app's AI gateway from agent tools — chat completions, embeddings, listing models, configuring defaults or BYOK, reading token/cost usage
Configure OAuth providers, auth hooks, JWT lifetimes, and service keys for a Butterbase app
Use when building a new Butterbase app from scratch, creating a full-stack application, or when the user asks to set up a complete backend with database, auth, and deployment
Use when users report access denied errors, see wrong data, RLS policies are not working, or when troubleshooting Row-Level Security issues in Butterbase
Deploy a frontend (React, Next.js, or static HTML) to a live URL on Butterbase
Use when building stateful per-key actors — chat rooms, multiplayer rooms, rate limiters, long-running agents, leaderboards — that need persistent in-memory + storage state across requests
Develop, deploy, or debug a Butterbase serverless function