agent: integrate plan-issue workflow into make-task-issue and update issue templates

[p-iknow]

Context

현재 /make-task-issue와 /plan-issue 사이에 중복되는 부분이 있으며, GitHub issue를 만들 때부터 관련 작업에 대한 context를 모으고 계획을 세워야 합니다:

• 문제: make-task-issue는 단순히 템플릿을 채우는 방식이고, plan-issue는 이미 생성된 issue를 분석하여 구현 계획을 세웁니다
• 중복: 컨텍스트 수집과 요구사항 분석이 두 단계로 나뉘어져 있어 비효율적입니다
• 개선 필요: issue 생성 단계부터 체계적으로 문제를 정의하고 솔루션을 설계해야 합니다

Requirement

/make-task-issue 명령어가 다음과 같은 인터랙티브 워크플로우를 포함하도록 개선:

1. Context Gathering (컨텍스트 수집)

• 문제 해결에 필요한 배경 정보 수집
• 관련 파일, 코드, 문서 탐색
• 기존 패턴과 의존성 파악
• 사용자와 인터랙션하며 컨텍스트 확인/승인

2. Requirement Definition (요구사항 정의)

• 수집된 컨텍스트를 바탕으로 문제/요구사항 명확히 정의
• What (무엇을), Why (왜), Expected Outcome (기대 결과) 구조화
• 제약사항 및 고려사항 파악
• 사용자와 인터랙션하며 요구사항 확인/승인

3. Solution Definition (솔루션 정의)

• 요구사항을 해결하는 접근 방법 설계
• 아키텍처 및 주요 설계 결정사항
• 대안 검토 및 트레이드오프 분석
• 사용자와 인터랙션하며 솔루션 확인/승인

4. Test Plan (테스트 방법)

• 구현 완료 여부를 확인할 수 있는 성공 기준 정의 (간략하게)
• 테스트해야 할 주요 항목 나열
• 사용자와 인터랙션하며 테스트 계획 확인/승인

5. Issue Template Structure Update

bug 템플릿을 제외한 모든 템플릿의 구조를 다음과 같이 통일:

• Context: 배경 및 컨텍스트
• Requirement: 문제/요구사항 정의
• Solution: 해결 방안
• Test Plan: 테스트 방법 (간략)
• Reference: 참고 자료

6. Separation of Concerns

• /make-task-issue: 문제 정의, 솔루션 정의, 테스트 방법 정의에 집중
• /plan-issue: issue에 정리된 내용을 바탕으로 구체적인 implementation steps 생성 및 실행 계획 수립에 집중

Solution

/make-task-issue Command Enhancement

1. Add interactive workflow stages:

   • Each stage (Context → Requirement → Solution → Test) presented step-by-step
   • User reviews and approves each stage before proceeding
   • Allow iteration if user wants changes
   • Similar to plan-issue's step-by-step review process

2. Workflow implementation:

   1. Determine template type (existing logic)
   2. Get issue title (existing logic)
   3. [NEW] Context Gathering Stage
      - Use Read/Glob/Grep to gather relevant context
      - Present findings to user
      - Get user approval
   4. [NEW] Requirement Definition Stage
      - Analyze and structure the requirement
      - Present What/Why/Expected Outcome
      - Get user approval
   5. [NEW] Solution Definition Stage
      - Design solution approach
      - Present Strategy/Architecture/Trade-offs
      - Get user approval
   6. [NEW] Test Plan Stage
      - Define success criteria (brief)
      - Present test items
      - Get user approval
   7. Create issue with structured content
   8. Set issue type and add to project (existing logic)
   

3. Add required tools:

   • Add Read, Glob, Grep to allowed-tools list
   • These are needed for context gathering

Issue Template Updates

Update these templates with new structure:

• feat.md
• fix.md
• doc.md
• config.md
• refactor.md
• agent.md
• test.md
• perf.md

Note: Keep bug.md as-is (bug reports have different structure)

New template structure:

---
name: {type}
about: {description}
title: "{type}: "
labels: {type}
assignees: ""
---

## Context


## Requirement


## Solution


## Test Plan


## Reference

Test Plan

• Test /make-task-issue with interactive mode - verify all 4 stages work
• Test that user can iterate on each stage
• Test that final issue contains properly structured content
• Verify all templates (except bug) follow new structure
• Test creating issues with new templates
• Verify /plan-issue still works with new issue structure

Reference

• .claude/commands/make-task-issue.md
• .claude/commands/plan-issue.md
• .github/ISSUE_TEMPLATE/