plan-to-bmad

Convert plans, issues, and review notes into BMAD-ready Markdown and JSON.

1|Updated Jan 13, 2026
One-click install
npx skills add https://github.com/jongensutrecht/demo-ai-stack --skill plan-to-bmad
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plan-to-bmad
Source: https://github.com/jongensutrecht/demo-ai-stack/tree/main/.claude/skills/plan-to-bmad
Command: npx skills add https://github.com/jongensutrecht/demo-ai-stack --skill plan-to-bmad

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill converts a plan, issue description, or review result into BMAD-ready Markdown and JSON so teams can move from vague intent to structured implementation input without losing CTO guardrails.

Core Features & Use Cases

  • Direct analysis: Investigates a request and turns it into actionable BMAD input.
  • Plan transformation: Converts an existing plan or CTO review into the standard BMAD template.
  • Governance-aware output: Captures scope, risks, invariants, constraints, and repo-10x guardrails for later story generation.

Quick Start

Ask the skill to transform your plan or issue into BMAD-ready Markdown and JSON for a process-specific main-merge worktree.

Frequently Asked Questions about plan-to-bmad

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

FAQPage Schema
How do I convert a project plan into BMAD-ready Markdown and JSON?

To convert a project plan into BMAD-ready Markdown and JSON, you provide the plan or issue description to the skill, which then applies deterministic scope mapping, P0/P1/P2/P3 structuring, and touched-path allowlisting to generate governance-aware output templates for downstream story generation.

What is BMAD structuring in governance-heavy Claude Code projects?

BMAD structuring in governance-heavy Claude Code projects is the process of transforming vague intent into standardized implementation input by capturing scope, risks, invariants, constraints, and repo-10x guardrails for later story generation within a process-specific main-merge worktree.

Can I use this to transform CTO review notes into structured implementation input?

Yes, you can use this to transform CTO review notes into structured implementation input. The skill acts as a Universal CTO intake capture mechanism, converting existing plans or review results into the standard BMAD template without losing CTO guardrails.

Does plan-to-bmad require a specific worktree setup for output generation?

Plan-to-bmad targets a process-specific main-merge worktree for output generation. It requires deterministic scope mapping and output templating to ensure the resulting Markdown and JSON files are correctly structured for downstream story generation in governance-heavy environments.

What is the best way to structure plan analysis for downstream story generation?

The best way to structure plan analysis for downstream story generation is to enforce P0/P1/P2/P3 structuring alongside invariants and constraints. This approach ensures the resulting BMAD-ready Markdown and JSON capture all necessary repository research and guardrails.

When do I need to apply touched-path allowlisting in plan transformation?

You need to apply touched-path allowlisting in plan transformation when working in governance-heavy Claude Code projects. It restricts scope to approved repository paths, ensuring the BMAD-ready Markdown and JSON output adheres to deterministic scope mapping and CTO guardrails.