WORKFLOWS / ARCHITECTURE

계획과 복구의
실행 흐름

아래에는 Archidraw MCP로 만든 전체 skill 관계도와 `$dev-kit:code-viz`가 생성한 계획·복구 workflow 캡처를 함께 싣습니다. 관계도는 inventory와 ownership을, workflow 그림은 실제 실행 순서와 retry loop를 설명합니다.

ARCHIDRAW MCP / OVERALL SKILLS

dev-harness-kit 전체 skill 관계도

Created with Archidraw MCP · 44-skill relationship map

이 그림은 저장소의 실제 skills/*/SKILL.md 목록을 대조해 만든 전체 skill inventory입니다. 총 44개 skill을 실행 순서처럼 일렬로 나열하지 않고, 하니스 안에서 맡는 역할에 따라 7개 영역으로 묶었습니다.

  • Foundation & Integration: bootstrap, config, ci-setup, 버전·캐시·Linear 연동처럼 작업 환경을 준비하는 기반입니다.
  • Research & Planning: evidence-plan부터 plan까지 아이디어를 근거·제안·가치 판정·실행 계획으로 좁힙니다.
  • Build & Refactor: build, TDD, debug, verify, refactor, prune이 계획을 코드와 검증 가능한 단계로 바꿉니다.
  • Review & Security: review, security, security-metrics, CI 진단·triage, pr-verify가 merge 전 증거를 확인합니다.
  • Ship & Repair: babysit-pr, babysit-pr-local, bump, ship이 PR 복구와 릴리스 경계를 담당합니다.
  • Quality & Documentation: 문서·훅·학습·시각화·비용·토큰 효율을 점검하는 횡단 품질 도구입니다.
  • Evaluation & Operations: evaluate, harness-effectiveness, status, log, ci-update가 운영 상태와 하니스 효과를 측정합니다.

상단의 흐름은 user intent → foundation → plan → build → review gate → ship/repair라는 주 lifecycle입니다. 타원은 시작·종료 또는 외부 통합 표면, 사각형은 실행 단위와 skill family, 마름모는 판단 게이트, 화살표는 주 흐름을 뜻합니다. 하단의 Artifacts와 GitHub는 각각 PRD·상태·TraceLog와 PR·Actions·checks가 모이는 지속성 경계입니다. babysit-pr의 세부 repair loop는 이 전체 관계도에 덮어쓰지 않고 아래 별도 그림으로 유지합니다.

PLAN

모호성을 줄일 때 다시 어디로 가는가

Generated by `$dev-kit:code-viz` · plan: 5 steps + loop

Emit은 종착점이지만, 요구사항이 불명확하거나 가치 판정이 revise이면 Frame으로 돌아갑니다.

ARCHIDRAW MCP / BABYSIT-PR

실패한 PR을 현재 상태에서 계속 돌립니다

Created with Archidraw MCP · babysit-pr bounded repair loop

Archidraw의 별도 babysit-pr 탭을 기준으로 시작부터 opt-out 확인, fresh snapshot, 상태 분류, 로그 수집, 원인 재현, 최소 수정, 로컬 검증, repair wave push, 상태 저장, bounded retry, human merge hand-off까지 표현합니다.