bug-fix

Stars0

Forks0

UpdatedJuly 7, 2026 at 03:22

Runs a quality-gated debugging pipeline with root-cause analysis, fix planning, TDD repair, autonomous code review, mandatory QA replay of the reproduction scenarios with human-readable evidence, and integration. Use when a bug needs structured diagnosis and verified repair. --codex enables adversarial review.

Installation

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

Source

neko-neko

neko-neko/belt

View GitHub Repository View Creator Repositories

Download

Related occupationsSOC

Based on SOC occupation classification

Software DevelopersComputer and Mathematical Occupations·SOC 15-1252

File Explorer

3 files

SKILL.md

readonly

name	bug-fix
description	Runs a quality-gated debugging pipeline with root-cause analysis, fix planning, TDD repair, autonomous code review, mandatory QA replay of the reproduction scenarios with human-readable evidence, and integration. Use when a bug needs structured diagnosis and verified repair. --codex enables adversarial review.
user-invocable	true
argument-hint	[--codex]

bug-fix

Composed belt pipeline: diagnose → checkpoint → build → qa → integrate. pipeline.yml declares four invoke.pipeline references plus the integrate leaf; belt-agent init expands them inline, so next returns namespaced leaf phases (diagnose/rca, build/execute, qa/qa, ...) in a single run.

Human touchpoints are exactly three: the diagnosis approval (fix-plan-review presents the RCA summary and the fix plan together), the checkpoint pause, and integrate.

Stage Skills

When next returns a phase, load the owning stage's SKILL.md before executing it — entry checks, phase execution steps, and red flags live there:

diagnose/* → plugins/belt/skills/diagnose/SKILL.md
pre-execute-handover/* → (none — follow the phase description: /belt:handover, /clear, /belt:resume)
build/* → plugins/belt/skills/build/SKILL.md
qa/* → plugins/belt/skills/qa/SKILL.md (replays rca-scenarios.yml)
integrate → plugins/belt/skills/feature-dev/SKILL.md, Phase: integrate (the leaf definition is identical by contract)

Smaller runs: /belt:diagnose for diagnosis-only work, /belt:build when a fix plan already exists, /belt:qa for QA alone.

Red Flags

Never execute a stage phase without loading its stage SKILL.md.
Never skip diagnose: root cause must precede fix. "Fix first" is the anti-pattern (enforced by the diagnose stage's own red flags).
Never bypass the pre-execute-handover checkpoint.

References

plugins/belt/skills/diagnose/SKILL.md — diagnose stage contract
plugins/belt/skills/build/SKILL.md — build stage contract
plugins/belt/skills/qa/SKILL.md — QA stage contract
plugins/belt/skills/design/references/path-convention.md — docs/features/<YYYY-MM-DD-topic>/ naming rules (SSOT)

More from this repository

same repository

wayfinder

neko-neko/belt

Experimental (mattpocock/skills wayfinder port, MIT). Charts a foggy effort as a shared Linear decision map, resolves its decision tickets across bounded sessions, and hands one graduated effort to /belt:requirements. Upstream of /belt:feature-dev; one run graduates exactly one effort.

2026-07-190

build

neko-neko/belt

Runs the shared build stage: TDD implementation from the plan document's task list and two-agent code review with autonomous triage. Use standalone with an existing plan.md/fix-plan.md, or composed as the build stage of /belt:feature-dev and /belt:bug-fix. QA runs as its own stage (/belt:qa) after build; integration happens at the orchestrator's integrate phase.

2026-07-180

design

neko-neko/belt

Runs the feature design stage: goal-sheet intake (/belt:goal) followed by a design document (architecture + key decisions) reviewed by belt:spec-reviewer. Use standalone for design-only work, or composed as the first stage of /belt:feature-dev. Task breakdown lives in the plan stage (/belt:plan), not here. --codex enables adversarial spec review.

2026-07-180

diagnose

neko-neko/belt

Runs the bug diagnosis stage: root-cause analysis with a failing reproduction test and reproduction scenarios, fix planning, and adversarial plan review. Use standalone for diagnosis-only work, or composed as the upstream stage of /belt:bug-fix. --codex enables adversarial plan review.

2026-07-180

feature-dev

neko-neko/belt

Quality-gated feature pipeline from ticket to integration: goal-sheet intake, design document with spec review, implementation plan with QA scenarios, context-reset checkpoint, TDD implementation, autonomous code review, mandatory QA with human-readable evidence (screenshots / transcripts), and integration with evidence publishing. Accepts a Linear id, URL, free text, or a requirements.md path. --codex enables adversarial review.

2026-07-180

plan

neko-neko/belt

Runs the implementation planning stage: writes plan.md (test strategy + task list) and scenarios.yml (QA replay scenarios) from an approved design.md, then reviews the plan via belt:spec-reviewer. Use standalone when a design already exists, or composed between the design and build stages of /belt:feature-dev. --codex enables adversarial plan review.

2026-07-180

name	bug-fix
description	Runs a quality-gated debugging pipeline with root-cause analysis, fix planning, TDD repair, autonomous code review, mandatory QA replay of the reproduction scenarios with human-readable evidence, and integration. Use when a bug needs structured diagnosis and verified repair. --codex enables adversarial review.
user-invocable	true
argument-hint	[--codex]

bug-fix

Human touchpoints are exactly three: the diagnosis approval (fix-plan-review presents the RCA summary and the fix plan together), the checkpoint pause, and integrate.

Stage Skills

When next returns a phase, load the owning stage's SKILL.md before executing it — entry checks, phase execution steps, and red flags live there:

diagnose/* → plugins/belt/skills/diagnose/SKILL.md
pre-execute-handover/* → (none — follow the phase description: /belt:handover, /clear, /belt:resume)
build/* → plugins/belt/skills/build/SKILL.md
qa/* → plugins/belt/skills/qa/SKILL.md (replays rca-scenarios.yml)
integrate → plugins/belt/skills/feature-dev/SKILL.md, Phase: integrate (the leaf definition is identical by contract)

Smaller runs: /belt:diagnose for diagnosis-only work, /belt:build when a fix plan already exists, /belt:qa for QA alone.

Red Flags

Never execute a stage phase without loading its stage SKILL.md.
Never skip diagnose: root cause must precede fix. "Fix first" is the anti-pattern (enforced by the diagnose stage's own red flags).
Never bypass the pre-execute-handover checkpoint.

References

plugins/belt/skills/diagnose/SKILL.md — diagnose stage contract
plugins/belt/skills/build/SKILL.md — build stage contract
plugins/belt/skills/qa/SKILL.md — QA stage contract
plugins/belt/skills/design/references/path-convention.md — docs/features/<YYYY-MM-DD-topic>/ naming rules (SSOT)