inspect

maestro:inspect

특정 요청(REQ) 또는 계획(PLN)의 연결 상태를 터미널에 표시합니다.

실행 프로토콜

경로 규칙 (MANDATORY): 이 스킬의 모든 .gran-maestro/ 경로는 절대경로로 사용합니다. 스킬 실행 시작 시 PROJECT_ROOT를 취득하고, 이후 모든 경로에 {PROJECT_ROOT}/ 접두사를 붙입니다.

PROJECT_ROOT=$(pwd)

{PLUGIN_ROOT}는 이 스킬의 "Base directory"에서 skills/{스킬명}/을 제거한 절대경로입니다. 상대경로(.claude/...)는 절대 사용하지 않습니다.

REQ-ID 입력 시 스크립트 우선 실행: python3 {PLUGIN_ROOT}/scripts/mst.py request inspect {REQ-ID} 실행. 성공 시 출력 그대로 사용. 실패 시 fallback.

Fallback (REQ-ID): $ARGUMENTS에서 REQ ID 파싱 → request.json 읽기 → 각 태스크 status.json 읽기 → 포맷팅 후 출력

PLN-ID 입력 시 (예: PLN-233):

• {PROJECT_ROOT}/.gran-maestro/plans/PLN-NNN/plan.json과 plan.md를 읽어 plan 제목/상태를 수집한다.
• {PROJECT_ROOT}/.gran-maestro/requests/*/request.json을 스캔해 source_plan == "PLN-NNN"인 child REQ를 추출한다.
• child REQ별로 id, title, status를 출력한다.
• child가 없으면 "연결된 REQ 없음"으로 출력한다.

스킬 실행 마커 (MANDATORY)

• 모든 응답의 첫 줄 또는 각 Step 시작 줄에 아래 마커를 출력한다.
• 기본 마커 포맷: [MST skill={name} step={N}/{M} return_to={parent_skill/step | null}]
• 필드 규칙:
  • skill: 현재 실행 중인 스킬 이름
  • step: 현재 단계(N/M) 또는 서브스킬 종료 시 returned
  • return_to: 최상위 스킬이면 null, 서브스킬이면 {parent_skill}/{step_number}
• 서브스킬 종료 마커: [MST skill={subskill} step=returned return_to={parent/step}]
• C/D 분리 마커 규칙을 추가로 사용하지 않는다. 반드시 단일 MST 마커만 사용한다.
• 예시:
  • [MST skill={name} step=1/3 return_to=null]
  • [MST skill={subskill} step=returned return_to={parent_skill}/{step_number}]

출력 형식

Gran Maestro — REQ-001 상세 상태
═══════════════════════════════════════

요청: "사용자 인증 기능 추가"
Phase: 2 (외주 실행)
생성: 2026-02-14 10:00
경과: 2h 30m

Phase 진행:
  [1] PM 분석    ████████████ 완료 (45m)
  [2] 외주 실행  ████████░░░░ 진행중
  [3] PM 리뷰    ░░░░░░░░░░░░ 대기
  [5] 수락/완료  ░░░░░░░░░░░░ 대기

태스크:
  01: JWT 미들웨어 구현
      Agent: codex-dev | Status: executing (45m)
      Worktree: {PROJECT_ROOT}/.gran-maestro/worktrees/REQ-001-01
  02: 로그인 UI 구현
      Agent: gemini-dev | Status: pending
      blockedBy: REQ-001-01
  03: 유저 모델 테스트
      Agent: codex-dev | Status: completed (38s)

종속성:
  blockedBy: []
  blocks: [REQ-002]

Gran Maestro — PLN-233 파생 요청
═══════════════════════════════════════

Plan: "plan → request 전환 사용성 개선"
Status: active

Child REQ:
  - REQ-349  "REQ-349 본 요청"  |  status: spec_ready
  - REQ-351  "후속 태스크"       |  status: pending

문제 해결

• "ID를 찾을 수 없음" → REQ-NNN 또는 PLN-NNN 형식 확인
• request.json 읽기 실패 → 파일 손상 가능; .gran-maestro/requests/{REQ-ID}/ 확인
• plan.json 읽기 실패 → plan 파일 손상 또는 경로 오타 가능; .gran-maestro/plans/{PLN-ID}/ 확인