workspace-manager/.workspace-ops/skills/pre-implementation-review/SKILL.md

name	version	description
pre-implementation-review	1.0.0	큰 구현을 시작하기 전에 관련 하위 Git repository, roadmap/current milestone, 구현 잠금, 선행 조건, 책임 경계, 테스트 기준을 확인해 진행 가능 여부를 판정하는 사전 점검 스킬. 사용자가 "구현 전 점검", "이 작업 시작해도 돼?", "pre-implementation review"를 요청할 때 사용한다.

Pre-Implementation Review

목적

큰 구현을 시작하기 전에 관련 repository와 milestone을 확인해 지금 구현으로 내려가도 되는지 판정한다. 결과는 진행 가능, 조건부 진행, 보류 중 하나로 낸다.

언제 호출할지

• 사용자가 특정 기능 구현을 시작하기 전에 점검을 요청할 때
• 여러 repository에 걸친 변경을 시작하기 전에 책임 경계를 확인해야 할 때
• roadmap의 구현 잠금 또는 선행 milestone이 구현을 막는지 확인해야 할 때
• 테스트/검증 기준이 충분한지 구현 전에 확인해야 할 때

입력

• workspace-root: 분석할 workspace root. 없으면 현재 작업 디렉터리
• feature: 구현하려는 기능 또는 변경 설명
• candidate-repos: 사용자가 지정한 관련 repository 목록. 선택
• candidate-paths: 관련 파일 또는 경로. 선택
• include-archives: archive 디렉터리 읽기 여부. 기본값은 false

먼저 확인할 것

• 구현하려는 기능 또는 변경 범위
• 관련 repository 후보
• .workspace-ops/shared/target-discovery.md의 제외 규칙
• 관련 repository의 진입 파일과 agent-roadmap/current.md
• 선택된 milestone의 구현 잠금 상태

실행 절차

1. 요청 범위 정리

   • feature, 관련 repo, 관련 경로, 기대 산출물을 짧게 정리한다.
   • 범위가 너무 넓으면 구현 단위를 나눌 후보를 제시한다.

2. 관련 repository 선정

   • 사용자가 지정한 repo를 우선한다.
   • 지정이 없으면 요청 키워드, 경로, roadmap/current milestone, 최근 변경을 보고 후보를 고른다.
   • .workspace-ops/**는 후보 repository에서 제외한다.

3. 규칙과 roadmap 확인

   • 각 후보 repo의 진입 파일, agent-ops/rules/project/rules.md, agent-roadmap/current.md를 확인한다.
   • 활성 milestone 중 관련 문서만 읽는다.
   • archive milestone은 사용자가 명시적으로 요청하지 않으면 읽지 않는다.

4. 구현 잠금과 선행 조건 판정

   • 관련 milestone의 구현 잠금이 잠금이거나 섹션이 없으면 구현 보류 또는 조건부 진행으로 판정한다.
   • 책임 경계, API/protocol, schema, 테스트 기준이 확정되어 있는지 확인한다.

5. 변경 범위와 테스트 기준 확인

   • 어떤 repo가 소유하는 변경인지 분리한다.
   • 필요한 테스트, smoke, 문서 갱신, cross-repo sync 여부를 정리한다.

6. 판정 작성

   • .workspace-ops/shared/output-format.md의 구현 전 점검 형식을 따른다.
   • 사용자가 구현도 요청하지 않았다면 분석에서 멈춘다.

출력 형식

## 판정

<진행 가능 | 조건부 진행 | 보류>

## 근거

- <근거>

## 막는 항목

- <구현 전 결정해야 할 항목>

## 구현 시작 조건

1. <조건>
2. <조건>
3. <조건>

실행 결과 검증

• .workspace-ops/**가 구현 대상 repository로 포함되지 않았는가
• 관련 repository의 규칙과 roadmap/current를 확인했는가
• 관련 milestone의 구현 잠금 상태를 확인했는가
• 책임 경계와 테스트 기준을 확인했는가
• 사용자가 구현을 명시하지 않은 경우 파일을 수정하지 않았는가

금지 사항

• 구현 잠금이 걸린 milestone을 사용자 승인 없이 우회하지 않는다.
• protocol, schema, API, 파일 구조를 근거 없이 확정하지 않는다.
• .workspace-ops/**를 제품 코드 변경 대상으로 삼지 않는다.
• 사전 점검만 요청받은 상태에서 구현을 시작하지 않는다.