spec-bugfix-plan

Solid

Bugfix spec planning phase - investigate root cause, design fix, get approval

AI & Automation 1,733 stars 145 forks Updated 2 days ago NOASSERTION

Install

View on GitHub

Quality Score: 89/100

Stars 20%
100
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# /spec-bugfix-plan - Bugfix Planning Phase **Phase 1 (bugfix).** Investigates root cause, creates lean fix plan, gets approval. **Input:** Bug description (new) or plan path (continue unapproved) **Output:** Approved bugfix plan at `docs/plans/YYYY-MM-DD-<slug>.md` with `Type: Bugfix` **Next:** On approval → `Skill(skill='spec-implement', args='<plan-path>')` --- ## Iron Law ``` NO FIXES WITHOUT ROOT CAUSE INVESTIGATION FIRST ``` If you haven't completed Step 1.2, you cannot propose fixes. Symptom fixes are failure. --- ## Critical Constraints - **NEVER write code during planning** — planning and implementation are separate phases - **NEVER assume — verify by reading files.** Trace the bug to actual file:line. - **Right-size the plan** — small bugs get lean plans. Don't over-engineer. - **Plan file is source of truth** — survives across auto-compaction cycles - **ALWAYS use `AskUserQuestion` tool** for clarifications — never list numbered questions in plain text - **⛔ If `PILOT_PLAN_QUESTIONS_ENABLED` is `"false"` (from Step 0),** skip all `AskUserQuestion` calls (Steps 1.2.1, 1.2.5 escalation, 1.3 approach selection). Make reasonable default assumptions (including selecting the recommended fix approach) and document them in the plan. Continue autonomously. > **NOTE: During `/spec`, use the structured workflow below — not CC's native plan mode.** --- ## Step 0: Read Toggle Configuration **⛔ Run FIRST, before any other step.** Read all toggle env vars in a single...

Details

Author
maxritter
Repository
maxritter/pilot-shell
Created
7 months ago
Last Updated
2 days ago
Language
TypeScript
License
NOASSERTION

Integrates with

Similar Skills

Semantically similar based on skill content — not just same category

AI & Automation Solid

spec-plan

Spec planning phase - explore codebase, design plan, get approval

1,733 Updated 2 days ago
maxritter
AI & Automation Listed

ae-spec-and-plan

Use before implementation when a coding task is broad, ambiguous, risky, product-facing, or likely to touch multiple files. Convert intent into a decision-complete plan with success criteria, constraints, and tests.

0 Updated 4 days ago
deaglecodes
Testing & QA Solid

speci5.plan

Read a story spec and create a concrete implementation plan with tasks in .spec/features/<feature>/<story>/plan.md. Analyzes the codebase to produce specific, actionable tasks with file paths, function names, and unit test coverage aligned to the project tech stack. WHEN: /plan, create plan, plan story, break down story, implementation tasks, plan implementation, what to build. DO NOT USE FOR: brainstorming ideas (use brainstorm), writing specs (use specify), checking implementation (use check).

183 Updated 1 months ago
majiayu000
Testing & QA Listed

speci5.plan

Read a story spec and create a concrete implementation plan with tasks in .spec/features/<feature>/<story>/plan.md. Analyzes the codebase to produce specific, actionable tasks with file paths, function names, and unit test coverage aligned to the project tech stack. WHEN: /plan, create plan, plan story, break down story, implementation tasks, plan implementation, what to build. DO NOT USE FOR: brainstorming ideas (use brainstorm), writing specs (use specify), checking implementation (use check).

3 Updated 1 months ago
majiayu000
AI & Automation Solid

spec-verify

Spec verification phase - tests, execution, rules audit, code review

1,733 Updated 2 days ago
maxritter