issue-work

개요

이슈 단위로 스펙·실행 계획·수행 요약 파일을 생성하고 관리하는 워크플로우입니다.

관련 skill

• ai-workspace (권장): .ai/ 구조가 이미 존재하면 해당 구조를 따릅니다. 구조가 없으면 필요한 디렉토리를 직접 생성합니다.
• issue-audit (권장): 계획의 마지막 고정 Task(교차모델 검증)에서 사용합니다. 구현 모델과 다른 벤더 모델로 사용자가 직접 issue-audit를 실행하고, 그 결과를 issue-<번호>-summary.md의 모델 기록 표 audit 모델 행과 Task별 수행 결과(audit 발견 건수)에 반영합니다. 구현 AI는 이 Task를 자동 실행·종료하지 않습니다.

참조 문서

• 공통 규칙: .ai/10_rules/context-loading.md — 있으면 따르며, 이미 적재되어 있으면 재로딩하지 않습니다.
• 스킬 고유 추가 참조:
  • .ai/30_contract/index.md, .ai/40_domain/index.md, .ai/50_adr/index.md — 새 이슈 시작 시 훑어 spec의 "연관 문서" 후보 제안
  • .ai/90_issues/active/ 하위 전체
  • .ai/10_rules/writing-principles.md·.ai/10_rules/writing-principles-local.md — 있으면 산출물 작성 원칙으로 참조 (충돌 시 local 우선; 없으면 본문의 "산출물 접기 기준"이 기본값)

---

디렉토리 구조

.ai/90_issues/
├── active/     ← 현재 진행 중인 이슈 디렉토리 (항상 읽음)
│   ├── issue-workflow.md         ← 작업 절차 가이드 (컨텍스트 초기화 후에도 절차 유지)
│   └── issue-<번호>/
│       ├── issue-<번호>-spec.md      ← 목표, 요구사항, 완료의 정의, 전제, 연관 문서
│       ├── issue-<번호>-plan.md      ← 실행 Task 목록 + 완료 체크박스
│       └── issue-<번호>-summary.md   ← 다음 작업, Task별 수행 결과
└── archive/    ← 완료 또는 종료된 이슈 디렉토리 (명시적 요청 시에만 읽음)
    └── issue-<번호>/   ← 이슈 디렉토리 단위로 active에서 이관

AI 컨텍스트 적재 규칙:

• active/ 하위 파일은 작업 시작 시 항상 읽는다.
• archive/ 하위 파일은 사용자가 명시적으로 언급하지 않는 한 읽지 않는다.

---

새 이슈 시작 시

1. active/ 안에 있는 기존 이슈 디렉토리를 모두 archive/로 이동한다.
2. active/issue-workflow.md가 없으면 이 skill 디렉토리의 templates/issue-workflow-template.md를 참조하여 생성한다. 이미 있으면 템플릿과 내용을 비교해, 다르면 최신 템플릿으로 갱신(덮어쓰기)하고 동일하면 그대로 둔다. (템플릿이 SSoT이며 이 파일은 그 사본이므로, 템플릿 개선이 자동 반영된다.)
3. active/issue-<번호>/ 디렉토리를 생성하고 이 skill 디렉토리의 templates/를 참조하여 3개 파일을 생성한다.
   • .ai/30_contract/index.md, .ai/40_domain/index.md, .ai/50_adr/index.md를 훑어 spec의 "연관 문서" 섹션 후보를 제안한다.
4. plan 작성을 끝내기 직전에 plan 템플릿의 설계 종료 게이트(## Tasks 앞 고정 블록)를 수행한다. spec/plan만 보고 작성에 참여하지 않은 쪽이 구현할 수 있는지 자기점검하고, 문서에 없는 전제를 spec ## 전제 (Assumptions)에 남긴다. 발견이 없으면 그 섹션에 "없음" 한 줄을 남긴다.