Skip to content

sliekens/engineering-workflow

v2.16.0MIT

Engineering skills for issue backlog burn-down with runbook-driven validation, bug reports, one-issue wakes that resume from the issue tracker, and workspace setup, product mapping, build-failure diagnosis, complexity, consistency and conformance analysis, test design, scenario analysis, technical debt reviews, parallel change, yak-shave planning, whole-codebase untangling, capturing an unowned practice as a skill built from a catalog of primitives, one-step rabbit-hole teaching, and controlled technical writing.

fix-loop

Harden a sound architecture one issue at a time — fix one issue, validate every phase against a repository validation runbook, file every out-of-scope problem found along the way as a new issue, then take the next issue — until only blocked issues remain or a release is needed to verify more. A simple bug gets the smallest change. A larger change, including a module rewrite, is in scope when it removes local accidental complexity instead of stacking it. Use analyze-complexity before choosing the shape. Use when asked to fix an issue, work the backlog, burn down issues, or run the fix loop, or when the user runs /fix-loop, optionally with a starting issue. Do not use when the architecture is unsound or the goal needs a capability the architecture cannot hold (yak-shave), for a single exploratory investigation with no fix (flaky-build-investigation, analyze-complexity), for untangling the whole codebase in one pass instead of issue by issue (untangle-codebase), or for cutting or deploying releases. When the user describes a defect that is not yet an issue, stop and use bug-report. A person decides blocked issues with backlog. On a choice-like turn where the answer might be obvious, load duh before you treat the choice as the user's. When work-once runs this skill, finish one issue, return a WorkResult, and do not load the next skill or take another issue.

Read SKILL.md at the source

Pinned to revision 59ea847bc601, so it is the text this page describes rather than whatever the author pushed since.

Files

Every link opens the file at its source, pinned to the revision this page describes.