Vibe Index
🎯

openspec-change-proposal

🎯Skill

from bacoco/bmad-skills

VibeIndex|
What it does

Generates lightweight, concise proposals and task outlines for small code changes and bug fixes with minimal overhead.

πŸ“¦

Part of

bacoco/bmad-skills(12 items)

openspec-change-proposal

Installation

npxRun with npx
npx bmad-skills --global
npxRun with npx
npx bmad-skills
npxRun with npx
npx bmad-skills --path /your/custom/path
Install ScriptRun install script
curl -fsSL https://raw.githubusercontent.com/bacoco/bmad-skills/main/scripts/install-to-home.sh | bash
git cloneClone repository
git clone https://github.com/bacoco/bmad-skills.git

+ 11 more commands

πŸ“– Extracted from docs: bacoco/bmad-skills
Need more details? View full documentation on GitHub β†’
3Installs
-
AddedFeb 4, 2026
View on GitHubBack to Skills

Skill Details

SKILL.md

Creates lightweight proposals for L0-1 work.

Overview

# OpenSpec Propose Skill

When to Invoke

Automatically activate when user:

  • Says "Fix this bug", "Small change", "Quick feature"
  • Asks "Simple fix for [issue]", "Minor update to [component]"
  • Mentions "bug fix", "small improvement", "quick change"
  • Has a Level 0-1 scoped change (small, low risk, no major unknowns)
  • Uses words like: bug, fix, small, quick, simple, minor, lightweight

Specific trigger phrases:

  • "Fix this bug: [description]"
  • "Small change to [component]"
  • "Quick feature: [simple feature]"
  • "Simple fix for [issue]"
  • "Minor update: [description]"
  • "Lightweight change proposal"

Prerequisites:

  • Change is Level 0-1 (small, well-defined)
  • No major unknowns or architectural changes
  • Existing codebase (not greenfield project)

Do NOT invoke when:

  • Complex feature requiring PRD (use BMAD instead)
  • Architectural changes needed (use bmad-architecture-design)
  • Multiple teams coordination (use BMAD)
  • Level 2+ complexity (escalate to BMAD)
  • Greenfield project (use BMAD workflow)

Auto-escalate to BMAD when:

  • Scope grows beyond Level 1
  • Major unknowns emerge
  • Requires cross-team coordination

Mission

Capture small change requests or bug fixes and translate them into concise proposals and task outlines without invoking the full BMAD workflow.

Inputs Required

  • change_request: description of the existing behavior and desired adjustment
  • impact_surface: files, services, or user flows likely affected
  • constraints: timeline, risk, or approvals that bound the solution

Outputs

  • proposal.md summarizing problem, desired behavior, and acceptance signals (template: assets/proposal-template.md.template)
  • tasks.md listing actionable steps sized for rapid implementation (template: assets/tasks-template.md.template)
  • specs/spec-delta.md capturing ADDED/MODIFIED/REMOVED requirements (template: assets/spec-delta-template.md.template)
  • Optional design.md scaffolded when deeper technical notes are required

scripts/scaffold_change.py creates this structure in openspec/changes// using the templates above.

Process

  1. Validate Level 0-1 scope using CHECKLIST.md.
  2. Run scripts/scaffold_change.py to create the workspace under openspec/changes/.
  3. Clarify current vs. target behavior and record feasibility notes in proposal.md.
  4. Draft tasks.md and populate specs/spec-delta.md using the templates in assets/.
  5. Highlight dependencies, approvals, and risks, then hand off for review or implementation scheduling.

Quality Gates

Ensure checklist items pass before finalizing. Escalate to BMAD if scope exceeds Level 1 or introduces major unknowns.

Error Handling

  • If information is insufficient, ask for missing context (screenshots, logs, reproduction steps).
  • When risks are high or ambiguity remains, recommend migrating to BMAD discovery-analysis.

More from this repository10

🎯
bmad-ux-design🎯Skill

Designs comprehensive user experiences by creating detailed wireframes, user flows, and design systems aligned with product requirements.

🎯
bmad-security-review🎯Skill

Conducts comprehensive security reviews, identifying vulnerabilities, threat models, and generating prioritized remediation plans for system hardening.

🎯
bmad-product-planning🎯Skill

Generates comprehensive product requirement documents (PRDs), breaks down features into epics, and creates structured roadmaps for product development.

🎯
core-skill-creation🎯Skill

Guides developers through creating specialized Claude skills by providing comprehensive workflows, best practices, and validation processes for extending Claude's capabilities.

🎯
bmad-development-execution🎯Skill

Implements software stories by writing code, creating tests, and generating implementation documentation with traceability and quality discipline.

🎯
bmad-observability-readiness🎯Skill

Establishes comprehensive observability foundations by designing instrumentation, metrics, logging, and alerting strategies for system performance and reliability.

🎯
main-workflow-router🎯Skill

Routes and tracks project workflows across OpenSpec (L0-1) and BMAD (L2-4) phases, intelligently guiding users through development stages based on project complexity and intent.

🎯
bmad-discovery-research🎯Skill

Brainstorms and researches project ideas by transforming vague concepts into structured discovery briefs with clear goals, constraints, and opportunities.

🎯
bmad-story-planning🎯Skill

Breaks down product epics into granular, developer-ready user stories with detailed acceptance criteria and task dependencies.

🎯
bmad-test-strategy🎯Skill

Generates comprehensive test strategies, ATDD scenarios, and quality checklists to ensure software meets defined standards and mitigates risks.