From dso
Use when an agent or user needs to file a bug, report an issue, create a defect ticket, or capture a sub-agent blocker. Creates well-formatted, evidence-based bug tickets by collecting reproduction steps, expected vs. actual behavior, environment details, and logs, then writing the ticket via the ticket CLI using the shared bug report template. Trigger phrases include 'file a bug', 'report an issue', 'create a bug', 'open a ticket', 'log a defect', 'submit a bug report'.
How this skill is triggered — by the user, by Claude, or both
Slash command
/dso:create-bugThis skill is limited to the following tools:
The summary Claude sees in its skill listing — used to decide when to auto-load this skill
Reference skill for agents creating bug tickets. This skill is a thin workflow wrapper around the shared bug report template — the template is the source of truth for format, rules, and rubrics.
Reference skill for agents creating bug tickets. This skill is a thin workflow wrapper around the shared bug report template — the template is the source of truth for format, rules, and rubrics.
Before creating a bug ticket, read the template:
${CLAUDE_PLUGIN_ROOT}/skills/shared/prompts/bug-report-template.md
It defines: title format ([Component]: [Condition] -> [Observed Result]), priority rubric (integers 0–4, never "high/medium/low"), Zero Inference Rule (no root-cause speculation, no hindsight, no forced debugging, no low-value tickets), and the six description sections. Treat it as authoritative.
ticket show.# Capture stderr to a unique temp file so concurrent callers do not collide.
BUG_CREATE_ERR_FILE=$(mktemp /tmp/bug-create-err.XXXXXX)
BUG_CREATE_OUT=$(.claude/scripts/dso ticket create bug \
"[Component]: [Condition] -> [Observed Result]" \
--priority <priority> \
-d "$(cat <<'DESC'
### 1. Technical Environment
* **code_version:** [40-char SHA from `git rev-parse HEAD` at time of filing]
### 2. Incident Overview
* **Scenario Type:** [User-Flagged Behavior | Sub-Agent Blocker | Deferred Review Nitpick]
#### Expected Behavior
[What should have happened, referencing the contract/rule/skill that defines it.]
#### Actual Behavior
[Raw, factual output. No subjective adjectives.]
DESC
)" 2>"$BUG_CREATE_ERR_FILE")
BUG_CREATE_ERR=$(cat "$BUG_CREATE_ERR_FILE"); rm -f "$BUG_CREATE_ERR_FILE"
BUG_TICKET_ID=$(echo "$BUG_CREATE_OUT" | tail -1)
# Post-creation title gate — the only enforced check.
if echo "$BUG_CREATE_ERR" | grep -q "does not match required pattern"; then
.claude/scripts/dso ticket edit "$BUG_TICKET_ID" \
--title="[Component]: [Condition] -> [Observed Result]"
fi
.claude/scripts/dso ticket show "$BUG_TICKET_ID"
When to add: When a human user has directly and explicitly requested this bug be created in the current interactive session — e.g., "Create a bug for X", "File a ticket about Y", "Log this as a bug" — add --tags CLI_user to the create command. The calling agent (the one with direct knowledge of the user's request) is responsible for adding the tag; sub-agents that receive a task description but were not directly prompted by the user omit it.
When to omit: Autonomous creations — anti-pattern scans, debug discoveries, sub-agent blockers, error-pattern triage, end-session learnings — do not add --tags CLI_user even if the broader session was initiated by the user. The tag signals user-directed intent, not user-initiated sessions.
Downstream effect: CLI_user-tagged bugs skip the intent-search gate in /dso:fix-bug Phase B Step 1, since user-reported bugs have known intent. Missing the tag causes unnecessary intent-search dispatch on every user-reported bug.
When multiple Priority 4 (nitpick) findings share the same Component, consolidate into a single cleanup ticket. List each item as a bullet under §2 Actual Behavior and set Scenario Type to "Deferred Review Nitpick".
/dso:fix-bug (Phase G Step 1 anti-pattern scan), /dso:debug-everything (diagnostic discoveries), /dso:sprint (Phase F task failures), /dso:end-session (learnings triage), and any agent encountering unexpected behavior.
npx claudepluginhub navapbc/digital-service-orchestra --plugin dsoGuides creation, editing, and verification of skills for AI coding agents using test-driven development with subagent scenarios. Use when authoring or debugging skills.