release-plan

Plans release components through a structured conversation and files them into the Marshall store.

Updated Jul 15, 2026
One-click install
npx skills add https://github.com/builtbyberry/marshall-claude-plugin --skill release-plan-builtbyberry
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: release-plan
Source: https://github.com/builtbyberry/marshall-claude-plugin/tree/main/marshall/skills/release-plan
Command: npx skills add https://github.com/builtbyberry/marshall-claude-plugin --skill release-plan-builtbyberry

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Scoping a release usually means ad-hoc notes, duplicated tracker issues, and a plan that drifts from what actually ships. This Skill runs a structured planning conversation and writes each confirmed component directly into the shared Marshall store, so the plan is live and consistent across machines, people, and agents. ## Core Features & Use Cases - Structured planning conversation: Walks theme, per-category component sweep (driven by the release's project_type), deploy-safety and breaking-change questions, and an out-of-scope sweep — one cluster at a time. - Store-native component filing: Files each confirmed component via component_create with a strict shape (title, branch type, slug, deploy safety, breaking flag, structured notes), one per confirmation, never batched. - Add and amend modes: Append a single component to an existing release with add, or patch an already-filed component's fields via component_update without duplicating it. - Use Case: A team lead says "plan v0.5.0" — the Skill confirms the seeded release, sweeps categories like API changes and migrations, drafts each component for approval, and files them so they appear immediately on the release-detail screen. ## Quick Start Ask the AI to plan release v0.5.0 with a one-line theme and confirm each drafted component as it is filed into the Marshall store.

Frequently Asked Questions about release-plan

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I plan a release with the Marshall store?

Invoke /marshall:release-plan with a version or slug, optionally with a one-line theme. The Skill confirms the release is seeded via release_get, then walks a structured sweep of categories and files each confirmed component with component_create.

How do I add a single component to an existing release?

Use add mode: /marshall:release-plan <release> add. It skips the full sweep, drafts one component with deploy-safety and breaking questions, runs the confirmation loop, and files it with a single component_create call.

Does release planning create GitHub or Linear issues automatically?

On a tracked project, the Marshall store files the tracker issue server-side when component_create runs and stamps the back-link in external_ref. The Skill itself never calls a tracker API; on untracked projects no issue is created.

Can I edit a component after it has been filed?

Yes, use component_update with the component's ULID to patch fields like title, deploy_safety, notes, or external_ref. Never file a second component_create to fix a typo, since duplicate slugs are refused and tracker creation is not idempotent.

What happens if the release is not seeded yet?

The Skill stops and directs you to /marshall:release-init to create the release, or to import an existing tracker collection. It never creates the release itself, since it only writes components.

Why did my component land without a tracker link?

A tracker failure never blocks planning: the component is filed with a null external_ref and the store logs the failure. Do not re-run component_create; report it to the operator and repair the link deliberately instead.