bug-fix

Estrellas0

Forks0

Actualizado7 de julio de 2026 a las 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.

Instalación

Instalar con Codex o Claude Copia este prompt, pégalo en Codex, Claude u otro asistente, y deja que revise la página de la skill y la instale por ti.

Fuente

neko-neko

neko-neko/belt

Abrir repositorio de GitHub Ver repositorios del creador

Descarga

Ocupaciones relacionadasSOC

Basado en la clasificación ocupacional SOC

Desarrolladores de softwareOcupaciones informáticas y matemáticas·SOC 15-1252

Explorador de archivos

3 archivos

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)

Más de este repositorio

mismo repositorio

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)