tmpdot/troublemaker

README excerpt

troublemaker Deliberately inject a small, known bug into a disposable git worktree, so learners can practice finding and fixing it. 中文说明 troublemaker is a teaching tool . It makes trouble on purpose — but only inside a disposable git worktree it creates for you, never in your real code — and it grades the learner's fix against a probe-oracle pipeline. Status: v0.1.0 — teaching prototype. Read Current limitations before relying on it for anything beyond practice. - Zero runtime dependencies. Needs plain Node.js ( = 18) and git on PATH . - npm package: dsh-troublemaker (CLI binary: troublemaker ). Source: github.com/wonderfulcode1/troublemaker. Why this exists (teaching philosophy) Debugging is a skill you learn by debugging. Real codebases are too big, too noisy, and too precious to practice on; synthetic bugs in throwaway exercises are too artificial to be motivating. troublemaker sits in between: it takes your repository (or the bundled example), checks out a disposable worktree, and injects one small, known, describable bug — a single-character mutation like an off-by-one. The learner then: 1. reads the bug description, 2. finds the mutation in the worktree, 3. fixes it by hand, …

Category