Skip to main content
skill CX Codex

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

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add ai-driven-dev/framework
/plugin install aidd-pm@aidd-framework
Open on GitHub

What 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-framework

This 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-code

3Manually: put the files in place

~/.claude/skills/09-defect/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/09-defect/

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

Similar skills

All skills for Notes, tasks and projects →
om-backlog open-mercato om-backlog turns a product brief or a spec into a tracker tree: epics, stories with acceptance criteria, tasks. Shows the whole tree and waits before writing. CX Codex +1 2,300installs iterate-refinement-notes product-on-purpose iterate-refinement-notes — a skill for Claude Code and Codex that turns a backlog refinement session into structured notes. Run it during or after the meeting to capture estimates, open questions, and decisions for the whole team. CX Codex +1 796installs backlog-capture mvschwarz backlog-capture — a skill for Claude Code and five other coding agents that turns rough notes into structured backlog entries. Fire it after meetings or calls to grab an idea before it slips away. CX Codex +1 ★ 8,928repo stars user-stories phuryn A skill for Claude Code, Codex, Cursor and other agent CLIs that turns a feature into user stories built on the 3 C's and INVEST. Reach for it when a feature needs to become backlog items. CX Codex +1 3,500installs prioritize-features phuryn prioritize-features is a Claude Code skill that ranks a backlog of feature ideas based on impact, effort, and risk. Outputs the top five recommendations aligned with strategic product goals. CX Codex +1 3,100installs epic-breakdown-advisor deanpeters epic-breakdown-advisor breaks down unwieldy epics into vertical user stories through Richard Lawrence's Humanizing Work patterns. Useful when a backlog item feels too large for sprint planning. CX Codex +1 3,100installs

From the same set80

The whole set →
01-brainstorm The 01-brainstorm skill clarifies a rough idea through questions, then turns the discussion into a short brief. Use it when a request is ambiguous or you want to explore an idea together. CX Codex +1 ★ 571repo stars 3-cli-process 3-cli-process sets the conventions for a CLI process: how it shuts down, which channel gets which output, and what exit code it returns. CX Codex +1 ★ 571repo stars 02-project-memory 02-project-memory reads codebase architecture and decisions to build project memory and hook it into AI assistants. Useful for initial setups and drift audits. CX Codex +1 ★ 571repo stars 07-epic 07-epic is a Claude Code skill that shapes and reviews product backlog Epics. It checks readiness, resumes saved work, and supports approval before saving. CX Codex +1 ★ 571repo stars 06-agent-generate 06-agent-generate generates agent and subagent scaffolds across the AI coding tools configured in your project from a role prompt. CX Codex +1 ★ 571repo stars 02-challenge 02-challenge is a Claude Code skill that checks completed work against an agreed plan and returns a structured report. Its findings help decide whether to ship, revise, or rework the result. CX Codex +1 ★ 571repo stars 05-spike 05-spike turns one blocking unknown into a bounded spike: frames the question, gathers evidence, writes the outcome. CX Codex +1 ★ 571repo stars 0-contexts 0-contexts enforces one-way imports across bounded contexts and keeps business logic out of the shared kernel in TypeScript projects. CX Codex +1 ★ 571repo stars

Project sponsors

Companies that keep this analytics open