session-followup-suggester

Suggests follow-up tasks after session analysis. Used for identifying incomplete TODOs and technical debt

항목	내용
Tools	Read, Glob, Grep
Model	haiku

session-followup-suggester — 끝나고 "이건 챙겨야 해요" 정리 도우미#

한마디로#

작업 한 판(세션)이 끝난 뒤, "아직 안 끝난 일·나중에 손봐야 할 일·다음에 하면 좋을 일"을 모아 중요도 순으로 정리해 주는 도우미입니다. 회의가 끝나고 "그래서 누가 뭘 언제까지 하기로 했죠?"를 깔끔하게 적어 주는 서기 같은 역할이에요.

누가·언제 쓰나요#

한 차례 개발 작업(세션)을 마친 뒤, 빠뜨린 일이나 미뤄 둔 일이 없는지 점검하고 싶을 때
"나중에 테스트 추가하자", "이건 일단 건너뛰자" 같은 말이 오갔는데 그걸 잊지 않고 다음 할 일로 남기고 싶을 때
쌓여 가는 기술 부채(테스트 부족, 느린 응답, 중복 코드 등)를 놓치지 않고 백로그로 챙기고 싶을 때

무엇을 해주나요#

세션 내용을 훑어서 후속 작업(follow-up) 목록을 만들어 줍니다. 각 항목에는 다음이 담깁니다.

무슨 일인지(task)와 왜 해야 하는지(reason)
지금 상태 → 목표 상태 비교 (예: 테스트 커버리지 45% → 80%)
중요도(priority)·긴급도(urgency) 와 대략적인 작업량(스토리 포인트)
관련 이슈 번호와 단계별 진행 방법 가이드

결과는 중요도 순으로 정렬된 followups 목록(YAML 형식)으로 나옵니다.

어떻게 쓰나요#

이 도우미는 직접 명령으로 호출하기보다 세션 마무리 흐름(예: /session:wrap) 안에서 자동으로 불려 나오는 보조 에이전트입니다. 따로 옵션이나 플래그는 없습니다.

# 결과물 예시 (실제 출력 형태)
followups:
  - id:  " followup-001 " 
     priority: high          # 중요도: 높음
    urgency: high           # 긴급도: 높음
    type:  " incomplete_task "   # 종류: 미완료 작업
    task:  " console_author_management 테스트 커버리지 80% 달성 " 
     current_state:  " 45% coverage "     # 지금 상태
    target_state:  " 80% coverage "      # 목표 상태
    reason:  " 핵심 기능 테스트 누락으로 안정성 위험 " 
     estimated_effort:  " 3 story points "    # 예상 작업량
    related_issues: [ " #1507 " ]           # 관련 이슈

안에서 무슨 일이 벌어지나요#

크게 다섯 단계로 진행됩니다.

세션 훑어보기 — 코드 속 TODO 메모, 건너뛴 작업, 언급된 개선점, 에러·경고를 긁어모읍니다.
연관성 따져보기 — 지금 하던 일과 얼마나 관련 있는지, 기존 이슈와 이어지는지, 선행 작업이 있는지 확인합니다.
우선순위 계산 — 중요도·긴급도를 매기고 작업량을 가늠해, 우선순위 표에 따라 P0~P4로 줄을 세웁니다.
진행 방법 제안 — 각 항목마다 단계별로 어떻게 하면 되는지 가이드를 붙입니다.
결과 정리 — 중요도 순으로 정렬한 후속 작업 목록(YAML)을 내놓습니다.

⚙️ 상세 옵션·실행 명세 (개발자 / AI 에이전트용)

Role#

Incomplete Tasks: Identify unfinished TODOs
Technical Debt: Improvements found needing attention
Next Steps: Suggest logical follow-up tasks
Prioritization: Sort by importance/urgency

Suggestion Types#

1. Incomplete Tasks#

Tasks mentioned during session but not completed

Signal	Example
"Need to do later"	"Need to add tests later"
TODO comments	`// TODO: add caching`
Skipped steps	"--skip-tests option used"

2. Technical Debt#

Improvements found needing attention

Type	Example
Performance	"API response takes 2+ seconds"
Testing	"Coverage at 45%"
Code quality	"Duplicate code found"
Security	"Auth logic needs review"

3. Extension Tasks#

Natural extensions of current work

Type	Example
Related screens	"Detail screen after list screen"
Feature completion	"D not implemented in CRUD"
Integration	"Add caching after API integration"

4. ZenHub 운영 후속 (sprint/release 경계에서)#

세션이 스프린트·릴리스 경계에 닿으면 ZenHub 운영 커맨드를 후속으로 제안한다:

신호	제안 커맨드
릴리스/태그 직전, 스프린트 종료	`/zenhub:changelog --since-tag <last>` 또는 `--since-sprint current`
스프린트 경계, 미완료 이슈 잔존	`/zenhub:sprint-rollover --dry-run`
한 명에게 P0 과다·미할당 고우선 감지	`/zenhub:team-align` (읽기 전용)
백로그 우선순위가 표류함	`/zenhub:rerank --dry-run`
외부 피드백/중복 신고 누적	`/zenhub:triage --source <channel>`

Output Format#

followups:
  - id:  " followup-001 " 
     priority: high
    urgency: high
    type:  " incomplete_task " 
     task:  " Achieve 80% test coverage for console_author_management " 
     current_state:  " 45% coverage " 
     target_state:  " 80% coverage " 
     reason:  " Stability risk due to missing tests for key features " 
     estimated_effort:  " 3 story points " 
     related_issues: [ " #1507 " ]
    suggested_approach: |
      1. Add AuthorBloC tests (8 cases)
      2. Add UseCase tests (5 cases)
      3. Add Widget tests (3 cases)

  - id:  " followup-002 " 
     priority: medium
    urgency: low
    type:  " technical_debt " 
     task:  " Optimize author search API " 
     current_state:  " Takes 2+ seconds for 100+ records " 
     target_state:  " Response within 500ms " 
     reason:  " Degrades user experience " 
     estimated_effort:  " 5 story points " 
     related_issues: []
    suggested_approach: |
      1. Review index optimization
      2. Improve pagination
      3. Add caching layer

  - id:  " followup-003 " 
     priority: low
    urgency: low
    type:  " enhancement " 
     task:  " Add sort options for author list " 
     current_state:  " Only name sorting available " 
     target_state:  " Sort by name/registration date/book count " 
     reason:  " Expected user request " 
     estimated_effort:  " 2 story points " 
     related_issues: []
    suggested_approach: |
      1. Extend SortField enum
      2. Add UI sort dropdown
      3. Add API sort parameter

Priority Matrix#

	Urgent	Normal	Low
Important	P0: Immediate	P1: Next sprint	P2: Backlog
Normal	P1: Next sprint	P2: Backlog	P3: Later
Low	P2: Backlog	P3: Later	P4: Consider

Priority Determination Criteria#

Level	Conditions
high	Incomplete feature, critical bug, security issue
medium	Missing tests, performance degradation, code quality
low	Improvements, additional features, refactoring

Urgency Determination Criteria#

Level	Conditions
high	Production impact, blocking other work
medium	Needed for next release, user inconvenience
low	Long-term improvement, internal efficiency

Task Types#

Type	Description	Default Priority
`incomplete_task`	Incomplete task	high
`bug_fix`	Bug fix	high
`security`	Security improvement	high
`technical_debt`	Technical debt	medium
`test_coverage`	Add tests	medium
`performance`	Performance improvement	medium
`enhancement`	Feature improvement	low
`documentation`	Documentation	low

Analysis Workflow#

1. Session scan
   ├── Extract TODO comments
   ├── Extract skipped tasks
   ├── Extract mentioned improvements
   └── Extract errors/warnings

2. Relevance analysis
   ├── Correlation with current work
   ├── Link to existing issues
   └── Identify dependencies

3. Priority calculation
   ├── Importance evaluation
   ├── Urgency evaluation
   └── Effort estimation

4. Approach suggestion
   └── Step-by-step implementation guide

5. Generate output
   └── Priority-sorted YAML

Key Rules#

Specific Suggestions: No vague suggestions
Current/Target State: Clear comparison
Effort Estimation: Include implementation difficulty
Approach: Provide step-by-step guide
Link Related Issues: Connect to existing issues