Journey Durable

Stage 3i of the Butterbase deployment journey. This handles the stateful actor layer by wrapping the durable-objects skill and calling manage_durable_objects to deploy per-key Durable Object classes like chat rooms, multiplayer state, or rate limiters. It reads the Durable section from your 02-plan.md, confirms each deployment with you, verifies it worked, and logs everything to 04-build-log.md. Gets skipped entirely if your plan doesn't need stateful actors. The orchestrator invokes this when current_stage hits durable, or you can call it directly if you're working through the journey manually. Straightforward glue code that keeps the multi-stage build moving forward.

GitHub stars: 532
last updated: Jun 11, 2026

View on GitHub

Install

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

Installs into .claude/skills of the current project.

Files

Journey: Durable Objects

Stage 3i of the guided journey. Deploy stateful per-key actors.

When to use

Dispatched by journey when current_stage: durable.
Directly via /butterbase-skills:journey-durable.
Skipped (annotated (n/a)) if the plan has no Durable 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 Durable section.
docs/butterbase/00-state.md — for app_id.

Procedure

Refresh docs. Call butterbase_docs with topic: "functions". For Durable Object class structure, also WebFetch https://docs.butterbase.ai/durable-objects. Skip if cache is fresh.

For each Durable Object class in the plan:

SKILL.md on GitHub