claude/commands/xdev-draft.md

   1 Help the user draft a well-structured issue for their project's
   2 issue tracker.
   3
   4 ## Process
   5
   6 1. Ask the user to describe what they want in their own words.
   7 2. Ask clarifying questions (one at a time) to understand:
   8    - What is the problem or desired outcome?
   9    - What is the current behavior vs expected behavior?
  10    - Are there constraints or preferences?
  11 3. Draft a structured issue with:
  12    - Title: `type(scope): concise description`
  13    - Body:
  14      - **Context**: why this is needed (1-2 sentences)
  15      - **Goal**: what should change (concrete, testable)
  16      - **Acceptance criteria**: how to verify it's done
  17      - **Constraints** (if any): what NOT to do, what to preserve
  18 4. Present the draft to the user for review.
  19 5. If the user approves, submit using whatever tool is available
  20    (gh, glab, MCP), or output the formatted text for manual submission.
  21
  22 ## Principles
  23
  24 - Intent-driven: describe WHAT and WHY, not HOW to implement.
  25 - Give implementation space: do not over-specify the approach.
  26 - One issue = one change. If the idea is too big, suggest splitting
  27   into multiple issues.
  28 - Include acceptance criteria so the implementer knows when it's done.