Communitygithub.com

tuana-vn/system-reverse-engineer

GitHub Copilot용 증거 기반 리버스 엔지니어링 에이전트 및 스킬입니다.

system-reverse-engineer란 무엇인가요?

이 스킬은 검증된 설계 문서로부터 구현 작업 분류 체계(WBS)를 생성하기 위한 엄격한 방법론을 제공합니다. 요구사항 분석, 갭 분석, TDD, 설계 산출물 등 검증된 입력만 사용하여 작업을 도출하며, 작업은 명확한 결과물, 구체적인 소스 앵커, 명시적 종속성, 검증 가능한 완료 기준을 갖도록 세분화됩니다. 안정적인 WBS ID(WBS-001 등)를 사용하고, 각 작업의 기본 구현 산출물이 참조된 설계 산출물이 실제로 소유하는지 의미적 동일성을 증명해야 합니다. 종속성 DAG를 통해 구현 순서를 도출하고, 모든 코드 변경 작업에 검증 경로를 매핑하며, 요구사항에서 검증까지 전체 추적성을 유지합니다. GitHub Copilot과 같은 AI 코딩 에이전트에서 사용하도록 설계되었으며, 시간/스토리 포인트 추정은 포함하지 않습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add tuana-vn/system-reverse-engineer

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

구현 WBS 생성

목적

WBS는 구현해야 할 무엇(WHAT) 을 정의하며, 노력 추정치가 아닙니다.

TDD 산문에서 직접 일반적인 작업으로 건너뛰지 마십시오.

입력에는 검증된 상세 설계가 포함되어야 합니다.

요구사항
→ 갭
→ TDD
→ 설계 산출물
→ 검증된 상세 설계
→ WBS 작업
→ 검증

입력

  • 권위 있는 요구사항
  • 검증된 갭 분석
  • 검증된 TDD
  • 설계 산출물 레지스트리
  • 모든 DD_VERIFIED 상세 설계
  • 상세 설계 검증 보고서
  • 테스트 설계 (있는 경우)
  • 현재 저장소

1. 작업 도출

검증된 설계 결정으로부터만 작업을 도출하십시오.

작업 범주:

  • 프로덕션 코드
  • API/계약
  • 통합
  • 데이터/지속성
  • 구성
  • 마이그레이션/호환성
  • 테스트
  • 빌드/배포
  • 문서화
  • 승인된 설계에 필요한 경우에만 정리

"있으면 좋은" 리팩터링은 추가하지 마십시오.

2. 작업 세분성

작업은 다음을 가질 수 있을 만큼 충분히 작아야 합니다.

  • 하나의 명확한 결과물
  • 구체적인 소스/설계 앵커
  • 명시적 종속성
  • 검증 가능한 완료 기준

그러나 기계적 편집을 수십 개의 의미 없는 마이크로태스크로 분할하지 마십시오.

3. 안정적인 ID

사용:

WBS-001, WBS-002, ...

3A. WBS ↔ 설계 의미적 동일성

WBS 행에 기존 산출물 ID가 포함되어 있다고 해서 추적 가능성이 충족되는 것은 아닙니다.

모든 WBS 작업에 대해 기본 구현 산출물을 식별하고, 참조된 설계 산출물이 해당 산출물을 소유함을 증명하십시오.

필수 의미 체인:

WBS 작업 제목 / 목표 / 기본 산출물
↔ 레지스트리 산출물 이름 + 책임
↔ 검증된 DD가 소유한 구현 단위
↔ TDD 설계 결정

규칙:

  1. 산출물 ID 참조는 필요 조건이지만 충분 조건은 아닙니다.
  2. 유형/클래스/인터페이스가 DD에서 단순히 언급, 임포트, 참조 또는 링크되었다고 해서 해당 산출물이 해당 구현 단위를 소유함을 증명하지 않습니다.
  3. WBS 작업의 기본 산출물이 하위 유형인 경우, 다음 중 하나가 참이어야 합니다.
    • 레지스트리/DD가 해당 하위 유형을 소유 산출물 범위 내에 명시적으로 선언하거나,
    • 설계 산출물 분해를 별도로 추적하도록 수정해야 합니다.
  4. 구성 요소/유형 A에 대한 작업을 구성 요소/유형 B에 대한 책임이 등록된 산출물에 매핑하지 마십시오. 단, 산출물이 명시적으로 A를 소유하는 경우는 예외입니다.
  5. 의미적 소유권을 증명할 수 없는 경우, WBS_BLOCKED_DESIGN_GAP으로 중단하십시오. 인근 TDD 산문에서 매핑을 조작하지 마십시오.

WBS를 내보내기 전에 내부/노출 일관성 테이블을 작성하십시오.

WBS ID기본 산출물참조된 산출물 ID레지스트리 책임DD 소유 단위의미적 일치?증거

필요 임계값:

WBS ↔ 산출물 의미적 동일성 = 100%

4. WBS 테이블

WBS ID설계 산출물 ID작업기존 소스 앵커 / 제안된 위치변경 유형종속성요구사항 IDTDD/DD 참조검증완료 기준

변경 유형:

  • ADD
  • MODIFY
  • REMOVE
  • CONFIGURE
  • MIGRATE
  • TEST
  • DOCUMENT
  • VERIFY

5. 종속성 DAG

산출물 종속성 및 코드/런타임 종속성으로부터 구현 순서를 도출하십시오.

생성:

WBS ID종속 대상종속 이유하드/소프트

순환 종속성을 감지하십시오.

파일 순서만으로 순서를 임의로 만들지 마십시오.

6. 검증 매핑

모든 코드 변경 작업에는 검증 경로가 필요합니다.

매핑 대상:

  • 업데이트할 기존 테스트
  • 새 테스트 ID/관점
  • 소스/빌드 검증
  • 런타임/통합 검증
  • 자동화가 불가능한 경우에만 수동 검증

7. 추적 가능성

생성:

요구사항 ID갭 IDTDD 결정 ID산출물 IDDDWBS ID테스트/검증 ID커버리지

검증된 설계 산출물이 고아가 되어서는 안 됩니다.

8. WBS 게이트

WBS_READY_FOR_VERIFICATION 전에:

[ ] 모든 DD_VERIFIED 산출물에 구현/검증 작업 커버리지가 있음
[ ] 모든 WBS 작업이 검증된 설계로 다시 매핑됨
[ ] 모든 WBS 작업의 기본 산출물이 참조된 산출물의 책임/소유 단위와 의미적으로 일치함
[ ] 단순히 언급된 DD/TDD 기호를 산출물 소유권 증거로 사용하는 작업이 없음
[ ] 소스 앵커/제안된 위치가 구체적임
[ ] 종속성이 명시적임
[ ] 코드 변경 작업에 완료 기준 및 검증이 있음
[ ] 필요할 때 구성/마이그레이션/문서/테스트 작업이 포함됨
[ ] 승인되지 않은 아키텍처/리팩터링이 추가되지 않음
[ ] HIGH/CRITICAL 소스 갭이 작업 내에 숨겨지지 않음

상태:

  • WBS_READY_FOR_VERIFICATION
  • WBS_BLOCKED_DESIGN_GAP
  • WBS_BLOCKED_SOURCE_GAP

중요

이 스킬에서는 시간/일/스토리 포인트를 추정하지 마십시오. 노력 추정은 별도의 고려 사항입니다.

관련 스킬