schema-version: 1
project-profile:
  primary: generic
  secondary:
    - workflow-harness
    - configuration-repository
audiences:
  primary:
    - 저장소를 처음 사용하는 운영자와 개발자
    - 하네스의 역할·워크플로·검증 계약을 변경하는 기여자
  secondary:
    - 에이전트 운영 모델과 증거 체계를 평가하는 기술 리더
reader-outcomes:
  - 이 저장소가 해결하는 운영 문제와 적용 범위를 30초 안에 설명한다.
  - 필수 도구와 워크스페이스를 설정하고 preflight 진입점을 찾는다.
  - cascade·wave·light·venture 경로 가운데 작업에 맞는 흐름을 고른다.
  - 역할·워크플로·훅·산출물의 정본과 변경 위치를 구분한다.
  - 정적 검증과 실제 실행 증거의 차이 및 현재 실증 한계를 확인한다.
project-story:
  value-proposition: 역할 선택부터 사람 승인, 산출물 검증, 증거 기록까지를 Claude Code 명령·계약·훅으로 연결하는 파일 기반 에이전트 운영 하네스다.
  problem: 여러 에이전트가 긴 작업을 수행하면 역할 경계, 선행 산출물, 승인 주체, 실행 증거가 산문과 대화 안에서 쉽게 분리된다.
  target-reader: Claude Code에서 복수 역할의 제품·개발·운영 워크플로를 일관된 계약으로 운용하려는 사용자와 기여자
  notable-traits:
    - text: workflow-contracts가 단계, 산출물 bundle, 검토 권한, exit gate를 한 그래프로 정의한다.
      fact-ids: [F-WORKFLOW-CASCADE, F-ARCH-STATE-ARTIFACT]
    - text: 역할 75개를 28개 family로 라우팅하고 현재 생성기 계약은 101개 agent card의 정합을 검사한다.
      fact-ids: [F-ARCH-ROLE-MODEL, F-ARCH-COLLABORATION]
    - text: Claude Code hook이 도구 사용, 증거 기록, subagent 수명주기, 종료 검증을 연결한다.
      fact-ids: [F-ARCH-HOOKS, F-ARTIFACT-PROVENANCE]
    - text: 프로젝트별 workspace에 불변 report와 append-only 상태·증거 기록을 분리한다.
      fact-ids: [F-ARTIFACT-LAYOUT, F-ARTIFACT-PROVENANCE]
    - text: 전체 테스트 진입점과 plain 대 harness 벤치마크는 존재하지만 현재 품질 우위 표본은 제한적이다.
      fact-ids: [F-VERIFY-SUITE, F-MATURITY-BENCHMARK]
  maturity: 실행 계약과 검증 코드는 구현되어 있으나 회사 컨텍스트는 template이고 품질 우위 실증은 초기 표본에 머문 상태
  limitations:
    - 강제 hook은 Claude Code가 이 프로젝트의 .claude/settings.json을 로드한 세션에서 적용된다.
    - 현재 company-context와 founder-context는 template 상태라 회사 수립 경로에 사람 입력이 필요하다.
    - 기록된 plain 대 harness 실행 표본은 두 저난도 과제뿐이며 모두 동률이다.
    - UI 렌더와 덱 출력 같은 일부 경로는 Node, 브라우저, D2 또는 Marp 같은 추가 도구에 의존한다.
narrative-variant: custom
reader-journey:
  - reader-question: 이 저장소는 무엇을 어떤 방식으로 운영하는가?
    section-id: overview
  - reader-question: 대화형 프롬프트와 다른 핵심 운영 원칙은 무엇인가?
    section-id: operating-model
  - reader-question: 사용 전에 무엇을 설치하고 어떤 workspace를 지정해야 하는가?
    section-id: quick-start
  - reader-question: 작업 크기와 목적에 맞는 workflow는 무엇인가?
    section-id: workflows
  - reader-question: 규칙과 실행 코드는 어디에 있고 서로 어떻게 연결되는가?
    section-id: architecture
  - reader-question: 실행 결과와 증거는 어디에 어떤 형태로 남는가?
    section-id: artifacts
  - reader-question: 저장소 정합과 품질 주장을 어떻게 검증하는가?
    section-id: verification
  - reader-question: 도입 전에 받아들여야 할 현재 한계는 무엇인가?
    section-id: limitations
  - reader-question: 세부 계약을 직접 확인하거나 변경하려면 어디를 읽는가?
    section-id: reference