Skip to content

Conversation

@alimoradi296
Copy link

Summary

This PR adds a new debug-issue.md template to extend the ai-dev-tasks workflow to bug fixing. The existing
templates (create-prd.md and generate-tasks.md) only cover feature development, but developers spend significant
time fixing bugs which require a different analysis structure.

Changes

  • New file: debug-issue.md - Template for creating structured Issue Analysis Documents
  • Updated: README.md - Added one line documenting the new template in the "Files in this Repository" section

What does debug-issue.md do?

Following the same pattern as the existing templates, debug-issue.md guides the AI to:

  1. Ask 3-5 essential clarifying questions about the bug (frequency, severity, environment, etc.)
  2. Generate a comprehensive Issue Analysis Document with:
    • Reproduction steps
    • Expected vs actual behavior
    • Root cause analysis
    • Proposed solution
    • Testing requirements

Why this addition?

  • Fills a workflow gap: The existing templates only address feature development, not bug fixing
  • Same methodology: Uses the same structured, question-driven approach that makes the existing templates
    effective
  • High practical value: Developers fix bugs constantly - this makes AI assistance more reliable for debugging
  • Consistent quality: Template matches the tone, structure, and length of existing files

Design Decisions

  • Kept it focused: Only creates the Issue Analysis document (doesn't extend into implementation)
  • Junior developer audience: Same target as existing templates - explicit, unambiguous language
  • Minimal README changes: Only one line added to document the file, no other changes
  • 3-5 question limit: Consistent with create-prd.md pattern

Testing

The template has been reviewed against the existing templates for:

  • ✅ Consistent structure and section ordering
  • ✅ Similar length (~98 lines vs 82 and 71 for existing templates)
  • ✅ Matching tone and clarity
  • ✅ No contradictions or ambiguities
  • ✅ Focused scope (analysis only, not implementation)

Files Changed

  • debug-issue.md (new, 98 lines)
  • README.md (1 line added)

- Add debug-issue.md template following existing pattern
- Update README.md to document new file

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant