quick-task · diff

git:20260618.6202ee7 to git:20260619.a07a367

1 added, 1 removed. Audit A to A.

---
name: quick-task
description: Short workflow for small tasks and bug fixes that don't warrant a full 3-phase spec. Use for clearly-scoped changes and bugs in this repo.
---
# /quick-task — Short workflow for small changes and bug fixes
The lightweight counterpart to `/spec-create`. No requirements/design/tasks files — just gather context, agree on an approach, implement, verify. If the change turns out to be larger than expected (touches many files, needs design decisions), stop and suggest `/spec-create` instead.
## Steps
1. **Gather context.** Ask for (or extract from `$ARGUMENTS`):
- What needs to change, or the bug description.
- For a bug: expected vs actual behavior, and steps to reproduce if known.
- Check `TODO.md` / recent `CHANGELOG.md` entries / `docs/decisions/` — report if it's already planned, shipped, or covered by an ADR.
2. **Read context — scoped, not whole-repo:**
- `grep` for the symbols, strings, or behavior named in the request to find the function(s) involved.
- Read only the relevant functions/sections, targeting lines around each hit. Don't load entire files when a few functions suffice.
- For broad "where does X happen across the repo" questions, delegate to the Explore agent so file bulk stays out of this conversation.
- - Remember: instruction templates under `templates/claude/instructions/*.md.template` are mirrored to `.github/instructions/` by `mirrorInstructionsToGithub`.
+ - Remember: instruction templates live under `templates/claude/instructions/**` (overviews + `index.md` + `reference/`/`conventions/`/`gotchas/`); the template tree → `.claude/` is the single source of truth (Claude-only, no `.github/` mirror).
3. **Propose:**
- For a bug: root-cause hypothesis (one or two sentences).
- Minimal change (which files, what change).
4. **STOP. Ask the user to approve the approach before editing.**
5. **Implement the change.** Touch only the files in the approved approach. Apply `CLAUDE.md` conventions (template variables, `.template` stripping, English-only committed files).
6. **Verify.** No test suite — verify manually:
- CLI/scaffold logic: `node cli.js -v` / `-h`, or scaffold into a scratch dir and inspect.
- Template/skill/doc edits: re-read the produced file.
- Check recent `ide_diagnostics` for any `Error` in a touched file; fix before finishing.
7. **Wrap up.** Keep `CLAUDE.md` / `README.md` in sync if behavior changed; tick the `TODO.md` item if one applies. Propose a commit message (title + body) based on the diff — do not run `git commit` unless the user says so.