Journey Storage

Orchestrates the storage configuration step in the Butterbase app building journey. It reads the Storage section from your plan document, delegates the actual bucket setup to the storage skill (which calls manage_storage to configure visibility and size limits), then runs a quick smoke test by requesting upload and download URLs to confirm presigned URL generation works. Gets skipped entirely if your plan has no file uploads. The main value is keeping you from calling manage_storage directly for each bucket, it batches the config work and keeps the build log in sync. If you're building outside the guided journey or need granular storage control, you'd call the storage skill directly instead.

GitHub stars: 532
last updated: Jun 11, 2026

View on GitHub

Install

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

Installs into .claude/skills of the current project.

Files

Journey: Storage

Stage 3d of the guided journey. Configure storage buckets/ACLs from the plan.

When to use

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

Procedure

Refresh docs. Call butterbase_docs with topic: "storage". For presigned URL patterns, also WebFetch https://docs.butterbase.ai/storage. Skip if cache is fresh.

SKILL.md on GitHub