grahama1970/agent-status

agent-status은(는) 무엇을 하나요?

프로젝트 에이전트가 다단계 작업을 수행 중이고 인간이 실제로 무슨 일이 일어나고 있는지 알아야 할 때마다 이 스킬을 사용하세요.

이 스킬은 의도적으로 대시보드 생성기가 아닙니다. 기계가 읽을 수 있는 아티팩트로 뒷받침되는 진실 표면을 생성합니다:

.plan-iterate/<campaign-id>/status/
  status.json
  events.jsonl
  proof_manifest.json
  STATUS.html

HTML은 현재 상태 아티팩트만 렌더링합니다. 진행률, 백분율 또는 완료 주장을 임의로 만들면 안 됩니다.

핵심 원칙

상태 아티팩트 우선 → HTML이 아티팩트를 렌더링 → 인간이 증명 검사 가능

절대 이렇게 하지 마세요:

예쁜 페이지 우선 → 모호한 초록색 언어 → 인간이 진행 추론

필요한 첫 뷰포트 답변

생성된 상태 페이지는 다음 질문에 답해야 합니다:

1. 에이전트가 완료하려는 것은 무엇인가?
2. 정확히 현재 위치는 어디인가?
3. 방금 통과한 것은 무엇인가?
4. 아직 입증되지 않은 것은 무엇인가?
5. 다음 행동은 무엇인가?
6. 에이전트가 실행 중, 차단됨, 유휴 상태, 또는 인간을 기다리는 중인가?
7. 현재 주장을 뒷받침하는 증명은 무엇인가?
8. 에이전트가 다음에 하지 말아야 할 것은 무엇인가?

상태 모델

허용되는 상태:

• not_started
• running
• needs_attention
• blocked
• failed
• passed_scoped_gate
• done
• idle

중요한 구분:

passed_scoped_gate != done

최종 명시된 목표에 대한 명시적인 최종 증명 아티팩트가 있을 때만 done을 사용하세요.

일반 명령어

캠페인 초기화:

./run.sh init \
  --campaign refactor-harness-e2e \
  --goal "범위가 지정된 리팩터 하네스 E2E 증명 완료"

게이트를 실행 중으로 표시:

./run.sh update \
  --campaign refactor-harness-e2e \
  --state running \
  --current-step "강화된 동시 LLM + OpenCode 요약 게이트 실행"

범위 통과 게이트 기록:

./run.sh gate-passed \
  --campaign refactor-harness-e2e \
  --label "A01-A18 강화된 동시 LLM + OpenCode 요약" \
  --verdict PASS_SPEC \
  --proof ".plan-iterate/refactor-harness-e2e/proof/refactor-concurrent-mixed.json" \
  --next-action "리뷰어 패킷 + 리뷰어 팬인 단계 시작" \
  --not-proven "Transport Room B1 UI" \
  --not-proven "build_review_packet 리뷰어 팬인" \
  --not-proven "전체 OpenCode 메시지 전달"

인간에게 결정 요청:

./run.sh needs-human \
  --campaign refactor-harness-e2e \
  --question "에이전트가 다음에 실행해야 할 캠페인은 무엇입니까?" \
  --option "A=하네스 계속: 리뷰어 패킷 + 리뷰어 팬인" \
  --option "B=Transport UI: Transport Room B1 시작" \
  --option "C=안정화만: 체크포인트 및 중지"

상태 페이지 다시 렌더링:

./run.sh render --campaign refactor-harness-e2e

대시보드 극장 방지 규칙

1. 백분율 없음.
2. 최종 목표 증명이 없으면 녹색 "완료" 표시 금지.
3. 모든 PASS는 해당 증명 아티팩트를 명명해야 함.
4. 모든 상태는 입증되지 않은 것을 표시해야 함.
5. 모든 유휴 상태는 에이전트가 유휴 상태인 이유를 명시해야 함.
6. 모든 인간 대기 상태는 결정 메뉴를 포함해야 함.
7. 모든 차단 상태는 누락된 아티팩트, 서비스, 게이트 또는 결정을 명명해야 함.
8. 자동 새로고침은 페이지가 status.json을 읽는 경우에만 허용됨.
9. status.json이 오래된 경우 페이지에서 오래됨(stale)을 표시해야 함.
10. 리뷰어 평결은 완료 증명이 아닌 영수증임.

사용 시기

다음과 같은 경우에 사용하세요:

• /plan-iterate
• /orchestrate
• /review-design
• /review-code
• /debugger
• /ask deep-review
• /code-runner
• /subagent-runner
• 한 번의 집중 명령어 이상 지속되는 모든 다단계 프로젝트-에이전트 작업

아티팩트 기대 사항

status.json이 진실 공급원입니다.

events.jsonl은 추가 전용이며 상태 전환을 기록합니다.

proof_manifest.json은 상태 주장에서 명명된 증명 아티팩트를 나열합니다.

STATUS.html은 생성되며, 지연 인식 기능이 있고 브라우저에서 열어도 안전합니다.

완료 기준

장기 실행 에이전트 작업에 대한 최종 답변은 현재 상태 아티팩트를 요약하고 가능한 경우 STATUS.html 경로를 링크하거나 인용해야 합니다.

다음 경우가 아니면 완료를 주장하지 마세요:

• 상태가 done인 경우;
• last_completed.proof_path가 최종 증명 아티팩트를 가리키는 경우;
• not_proven이 비어 있거나 명시적으로 범위를 벗어난 경우;
• 차단 항목이 비어 있는 경우.