conductor-context.md

Conductor Context — Universal Protocol

이 파일은 모든 conductor 커맨드가 공통으로 참조하는 프로토콜과 규칙을 정의합니다.

Universal File Resolution Protocol

파일을 찾을 때 반드시 이 프로토콜을 따릅니다:

1. 인덱스 확인: 해당 컨텍스트의 index.md를 읽고 링크를 찾습니다.

   • 프로젝트 컨텍스트: conductor/index.md
   • Track 컨텍스트: conductor/tracks/<track_id>/index.md

2. 경로 해결: index.md 기준 상대 경로로 해석합니다.

3. 폴백: index.md가 없거나 링크가 없으면 아래 기본 경로를 사용합니다.

4. 검증: 해결된 파일이 실제 존재하는지 반드시 확인합니다.

기본 경로 (프로젝트)

이름	기본 경로
Product Definition	conductor/product.md
Tech Stack	conductor/tech-stack.md
Workflow	conductor/workflow.md
Product Guidelines	conductor/product-guidelines.md
Tracks Registry	conductor/tracks.md
Tracks Directory	conductor/tracks/

기본 경로 (Track)

이름	기본 경로
Specification	conductor/tracks/<track_id>/spec.md
Implementation Plan	conductor/tracks/<track_id>/plan.md
Metadata	conductor/tracks/<track_id>/metadata.json

상태 마커 규칙

plan.md 및 tracks.md에서 사용하는 상태 마커:

마커	의미
[ ]	대기 중 (Pending)
[~]	진행 중 (In Progress)
[x]	완료 (Completed)

Task 완료 시 커밋 SHA 7자리를 마커 뒤에 기록합니다:

• 예: - [x] Task: 사용자 모델 생성 a1b2c3d

환경 검증 프로토콜

커맨드 실행 전 conductor 환경이 올바르게 설정되어 있는지 확인합니다:

1. 다음 파일의 존재를 확인:

   • conductor/product.md
   • conductor/tech-stack.md
   • conductor/workflow.md

2. 하나라도 없으면:

   "Conductor가 설정되지 않았습니다. /conductor-setup을 실행하여 환경을 초기화해주세요."

   • 더 이상 진행하지 않습니다.

커밋 메시지 규칙 (Conductor 내부)

• Track 생성: chore(conductor): Add new track '<description>'
• Task plan 업데이트: conductor(plan): Mark task '<task name>' as complete
• Phase 체크포인트: conductor(checkpoint): Checkpoint end of Phase '<Phase Name>'
• Phase plan 업데이트: conductor(plan): Mark phase '<Phase Name>' as complete
• 리뷰 수정: fix(conductor): Apply review suggestions for track '<track_name>'
• Track 아카이브: chore(conductor): Archive track '<track_name>'
• Track 삭제: chore(conductor): Delete track '<track_name>'

템플릿 경로

기본 템플릿은 ~/.claude/templates/conductor/에 위치합니다:

• workflow.md — 워크플로우 기본 템플릿
• code_styleguides/ — 언어별 스타일 가이드 템플릿