feature-workflow-runnerlisted
Install: claude install-skill ridsync/devoks-team-harness
# feature-workflow-runner
FRD 초안 → **정련 FRD → PLAN(작업 분해) → 태스크 단계 실행 → 마무리** 를 끊김 없이 잇는 4 Phase 통합 워크플로.
요구사항이 빠짐없이 작업으로 변환되고(추���성), 작업이 합리적 PR 단위로 쪼개지며(분리), 진행 상태가
세션을 넘어 유지되도록(PLAN.md SSOT) 한다.
## 왜 이 워크플로우인가
거친 아이디어에서 바로 코딩에 들어가면 (1) 빠진 요구사항이 구현 끝에 드러나고, (2) 거대한 단일 PR이
되어 리뷰·롤백이 어렵고, (3) 어디까지 했는지 추적이 안 된다. 이 스킬은 **EARS로 요구를 검증 가능하게
고정 → 각 작업에 `traces`를 달아 커버리지를 보장 → PR 경계로 분해 → PLAN 체크박스로 진행을 영속**시켜
이 세 실패를 막는다. FRD/PLAN은 사람이 읽는 산출물이자 에이전트가 재개 가능한 상태 저장소다.
## 호출 방법
```
/devoks-sdlc:feature-workflow-runner [frd=<FRD 초안 경로 또는 본문>] [out=<산출물 디렉터리>]
```
- `frd` 없으면 현재 대화에서 초안을 받는다.
- `out` 없으면 기본 워크스페이스 **`.claude/workspace/{feature-name}-{date}/`**. → `references/output-location.md`
- 워크스페이스에는 `FRD.md`·`PLAN.md`와 입력 초안·리소스 사본을 모은다. **생성/수정 코드는 워크스페이스가 아니라 프로젝트 본래 위치**에 둔다.
## 핵심 원칙
- **추적성 우선** — 모든 `AC/CTR/EDGE`는 최소 한 Task의 `traces`에 등장한다(누락 0). 근거 없는 Task도 두지 않는다.
- **검증 가능한 요구** — AC는 EARS로 써서 그대로 테스트가 된다. 통과/실패를 판정 못 하는 문장은 요구가 아니다.
- **설계는 제안 후 확인** — 요구 누락은 묻고(추측 금지), 설계 공백은 합리적 안을 먼저 제안한 뒤 확인한다. 복잡도 임계(파일 3개 초과(기계적 일괄 변경 제외)·신규 모듈/계층·아키텍처 변경·새 패턴·상태 소유 위치 변경) 초과 시 FRD §4에 컴포넌트 구조·패턴(`DSN`)·모듈 배치를 채운다. → `references/design-spec.md`
- **증분 분해·PR 분리** — 머지해도 안 깨지는 크기로 쪼개고, 필요할 때만(기본은 PR 1개) 독립 가치/위험 단위로 PR을 나눈다.
- **PLAN이 진행 SSOT** — 완료는 검증 통과 후에만 `[x]`. 세션 도구는 미러일 뿐 PLAN을 이긴다.
- **실행은 태스크까지** — 구현 착수 전 브랜치·이슈 사전체크(제안→확인→적용) 후, 태스크 구현·검증은 `size` 라우팅(S 직접/M 위임/L 분해 재검토)에 따라 `code-implementer` 위임(기본 경로)·직접 실행으로 처리하고, 리포트 판정·인계 노트 윈도잉·진행 갱신은 메인 루프가 수행. → `reference