09-defect — Claude Code skill: file and refine backlog defects
09-defect turns an observed product mismatch into a backlog defect: capture, assessment, then a confirmed write.
MIT ★ 571 updated 2026-10-29
/plugin marketplace add ai-driven-dev/framework
/plugin install aidd-pm@aidd-frameworkWhat 09-defect does
The skill runs a three-step flow. Capture frames a single product mismatch, assess pulls together evidence and impact plus readiness, finalize persists the defect or moves it to another state. Each step reads only the file for the next action, and the flow loops back to capture when something needs rework.
Product and lifecycle calls stay with you. Evidence, decisions, and assumptions are kept apart, source links survive edits, and nothing gets written until you approve it or hand the skill a bounded authority up front. It records the mismatch and stops there, with no diagnosis and no fix. Incident response and debugging are out of scope as well.
What it helps with
- turn a spotted mismatch into a defect in the backlog
- keep evidence apart from assumptions before anything is written
- link a defect to an existing one and order the two
- move a defect through statuses once you approve it
- check whether a defect carries enough evidence to be ready
Example prompts for the agent
- Log a defect: the order total doesn't recalculate after I change the quantity.
- Assess the evidence and impact on this defect, then move it to the next status.
- Link this defect to the existing one and tell me which should come first.
How to install 09-defect
1Plugin marketplace
/plugin marketplace add ai-driven-dev/framework/plugin install aidd-pm@aidd-frameworkThis installs the whole aidd-pm plugin with all its skills
2Skills CLI (Vercel)
npx skills add ai-driven-dev/framework --skill 09-defect -a claude-code3Manually: put the files in place
~/.claude/skills/09-defect/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/09-defect/
1Skills CLI (Vercel)
npx skills add ai-driven-dev/framework --skill 09-defect -a codex2Manually: put the files in place
.agents/skills/09-defect/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add ai-driven-dev/framework --skill 09-defect -a cursor2Manually: put the files in place
.cursor/skills/09-defect/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install ai-driven-dev/framework plugins/aidd-pm/skills/09-defect2Manually: put the files in place
.github/skills/09-defect/SKILL.md1Skills CLI (Vercel)
npx skills add ai-driven-dev/framework --skill 09-defect -a gemini-cli2Platform CLI
gemini skills install https://github.com/ai-driven-dev/framework --path plugins/aidd-pm/skills/09-defectManually: put the files in place
.devin/skills/09-defect/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add ai-driven-dev/framework --skill 09-defect -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about 09-defect
How to install 09-defect in Claude Code?
Add the marketplace with /plugin marketplace add ai-driven-dev/framework, then install the plugin: /plugin install aidd-pm@aidd-framework.
What does 09-defect do?
It takes an observed product mismatch to a backlog defect: frames it, gathers evidence and impact, then records it or changes its status.
Does it write anything on its own?
No. A write happens only after you confirm it, or when you granted bounded authority in advance. Otherwise the flow halts before finalize.
Source text
SKILL.md · MIT
--- name: 09-defect description: Produces or refines a backlog Defect from an observed product mismatch. Use when the user wants to report, assess, link, order, transition, or verify a defect. Not for incident response, debugging, or implementation. argument-hint: report | defect --- # Defect ```mermaid flowchart LR source([report or Defect]) --> capture --> assess --> finalize source -->|"already persisted"| finalize assess -->|"revise"| capture finalize -->|"revise"| capture finalize -->|"authorized"| done([Defect]) ``` ## Actions Run the flow above. Read only the next action file. | Action | Does | | -------- | ----------------------------------------- | | capture | frame one observed product mismatch | | assess | establish evidence, impact, and readiness | | finalize | persist or transition the Defect | ## Transversal rules - Keep product and lifecycle decisions with the user. - Separate evidence, decisions, and assumptions. - Preserve source links and existing edits. - Ask natural questions; never expose actions, references, or unchanged state. - Require explicit approval or caller-provided bounded authority before any write. - Record the mismatch; never diagnose or implement its fix.
© AI-Driven Dev · MIT · ai-driven-dev/framework