231 lines
12 KiB
YAML
231 lines
12 KiB
YAML
schema-version: 1
|
|
claims:
|
|
- id: C-IDENTITY
|
|
type: factual
|
|
statement: Org OS 하네스는 제품·개발·운영·GTM 업무를 여러 AI 역할에 배분하고, 단계별 산출물과 사람 승인을 파일 계약으로 연결하는 Claude Code 프로젝트 하네스입니다.
|
|
section: overview
|
|
sources: [{fact-id: F-IDENTITY-CORE}, {fact-id: F-WORKFLOW-CASCADE}]
|
|
status: supported
|
|
- id: C-VALUE
|
|
type: factual
|
|
statement: 워크플로 그래프, 역할·권한, typed artifact, 실행 증거를 각각 정본 파일과 hook으로 연결합니다.
|
|
section: overview
|
|
sources: [{fact-id: F-ARCH-STATE-ARTIFACT}, {fact-id: F-ARCH-HOOKS}, {fact-id: F-ARTIFACT-PROVENANCE}]
|
|
status: supported
|
|
- id: C-ENTRY-MODEL
|
|
type: factual
|
|
statement: 일반적인 새 작업은 `/ceo-intake`에서 의도와 작업 규모를 구조화한 뒤, 선택된 plan에 따라 discovery·decision·design·build·verification·acceptance로 진행됩니다.
|
|
section: overview
|
|
sources: [{fact-id: F-WORKFLOW-ENTRY}, {fact-id: F-WORKFLOW-CASCADE}, {fact-id: F-WORKFLOW-WAVE-LIGHT}]
|
|
status: supported
|
|
- id: C-CONTRACT-MODEL
|
|
type: factual
|
|
statement: "`workflow-contracts.yaml`이 stage, command, artifact bundle, reviewer capability, exit gate를 정의하고 `state_engine.py`가 그 그래프를 읽습니다."
|
|
section: operating-model
|
|
sources: [{fact-id: F-ARCH-STATE-ARTIFACT}]
|
|
status: supported
|
|
- id: C-COLLAB-MODEL
|
|
type: factual
|
|
statement: 현재 family 정책은 판단·설계·분석을 멤버별로 격리하는 fan-out과 코드·실행을 한 concrete worker로 모으는 collapse를 구분합니다.
|
|
section: operating-model
|
|
sources: [{fact-id: F-ARCH-COLLABORATION}]
|
|
status: supported
|
|
- id: C-HUMAN-BOUNDARY
|
|
type: factual
|
|
statement: 전체 cascade는 방향 수용과 release 승인 같은 사람 결정 지점에서 멈추도록 정의되어 있습니다.
|
|
section: operating-model
|
|
sources: [{fact-id: F-WORKFLOW-CASCADE}, {fact-id: F-WORKFLOW-SPECIALIZED}]
|
|
status: supported
|
|
- id: C-PROVENANCE-MODEL
|
|
type: factual
|
|
statement: workflow와 artifact는 append-only event 및 id+SHA-256 snapshot으로 연결되고, report는 새 시도마다 새 파일로 발급됩니다.
|
|
section: operating-model
|
|
sources: [{fact-id: F-ARCH-STATE-ARTIFACT}, {fact-id: F-ARTIFACT-PROVENANCE}]
|
|
status: supported
|
|
- id: C-HOOK-MODEL
|
|
type: factual
|
|
statement: Claude Code가 이 프로젝트의 `.claude/settings.json`을 로드하면 PreToolUse, PostToolUse, SubagentStart, SubagentStop, Stop 이벤트가 각각 도구 경계·증거 원장·subagent 등록·종료 검증에 연결됩니다.
|
|
section: operating-model
|
|
sources: [{fact-id: F-ARCH-HOOKS}]
|
|
status: supported
|
|
- id: C-PREREQUISITES
|
|
type: factual
|
|
statement: 핵심 hook과 테스트에는 Python 3.10 이상과 PyYAML 6.0 이상이 필요합니다. `requirements.txt`는 PyYAML 6.0.1과 jsonschema 4.10.3을 고정합니다.
|
|
section: quick-start
|
|
sources: [{fact-id: F-PREREQ-TOOLS}]
|
|
status: supported
|
|
- id: C-INSTALL-COMMAND
|
|
type: factual
|
|
statement: pip install -r requirements.txt
|
|
section: quick-start
|
|
sources: [{fact-id: F-PREREQ-TOOLS}]
|
|
status: supported
|
|
- id: C-WORKSPACE-RESOLUTION
|
|
type: factual
|
|
statement: 산출물 경로는 `ORGOS_WORKSPACE` 환경변수를 먼저 사용하고, 없으면 `.orgos-workspace`의 첫 유효 줄을 사용합니다. 둘 다 없으면 strict 운영 hook은 exit 2로 중단합니다.
|
|
section: quick-start
|
|
sources: [{fact-id: F-ARTIFACT-LAYOUT}]
|
|
status: supported
|
|
- id: C-DOCTOR-COMMAND
|
|
type: factual
|
|
statement: python3 .claude/hooks/doctor.py
|
|
section: quick-start
|
|
sources: [{fact-id: F-CI-WORKFLOW}, {fact-id: F-ARTIFACT-LAYOUT}]
|
|
status: supported
|
|
- id: C-DOCTOR-SCOPE
|
|
type: factual
|
|
statement: "`doctor.py`는 hook 배선, 참조 스크립트, Python 의존성, workspace, 참조 무결성을 점검하고 hard failure가 있으면 비영점으로 종료합니다."
|
|
section: quick-start
|
|
sources: [{fact-id: F-VERIFY-SUITE}, {fact-id: F-CI-WORKFLOW}]
|
|
status: supported
|
|
- id: C-FIRST-COMMAND
|
|
type: factual
|
|
statement: Claude Code에서 일반적인 새 제품·개발·운영 요청은 `/ceo-intake`로 시작합니다.
|
|
section: quick-start
|
|
sources: [{fact-id: F-WORKFLOW-ENTRY}, {fact-id: F-WORKFLOW-SPECIALIZED}]
|
|
status: supported
|
|
- id: C-WORKFLOW-CASCADE
|
|
type: factual
|
|
statement: "`/ceo-intake` → `/ground` → `/decide` → `/design` → `/spec` → `/build` → `/review-output` → `/release-check` → `released`"
|
|
section: workflows
|
|
sources: [{fact-id: F-WORKFLOW-CASCADE}]
|
|
status: supported
|
|
- id: C-WORKFLOW-WAVE
|
|
type: factual
|
|
statement: "`/ceo-intake` → `/plan-wave` → `/run-wave` → `/review-output` → `/release-check` → `released`"
|
|
section: workflows
|
|
sources: [{fact-id: F-WORKFLOW-WAVE-LIGHT}]
|
|
status: supported
|
|
- id: C-WORKFLOW-LIGHT
|
|
type: factual
|
|
statement: "`/ceo-intake` → `/run-wave` → `/review-output` → `acceptance`"
|
|
section: workflows
|
|
sources: [{fact-id: F-WORKFLOW-WAVE-LIGHT}]
|
|
status: supported
|
|
- id: C-WORKFLOW-VENTURE
|
|
type: factual
|
|
statement: founder context를 채운 뒤 `/ceo-intake --plan venture-bootstrap` → `/venture-validate` → `/company-bootstrap` → `bootstrap-complete`
|
|
section: workflows
|
|
sources: [{fact-id: F-WORKFLOW-VENTURE}]
|
|
status: supported
|
|
- id: C-SPECIALIZED-WORKFLOWS
|
|
type: factual
|
|
statement: "`/run-cascade`는 cascade의 현재 stage와 다음 command를 계산하는 상위 드라이버입니다. `/design-direction`은 제품 cascade에 종속된 방향 탐색 child workflow이고, `/design-system`과 `/consult`는 각각 코드 UI 검증과 독립 자문 산출물에 초점을 둡니다."
|
|
section: workflows
|
|
sources: [{fact-id: F-WORKFLOW-SPECIALIZED}]
|
|
status: supported
|
|
- id: C-CASCADE-VISUAL
|
|
type: factual
|
|
statement: 다음 흐름은 `workflow-contracts.yaml`에 정의된 cascade stage와 사람 결정 경계를 요약합니다.
|
|
section: workflows
|
|
sources: [{fact-id: F-WORKFLOW-CASCADE}, {fact-id: F-WORKFLOW-SPECIALIZED}]
|
|
status: supported
|
|
- id: C-ARCH-SOURCE
|
|
type: factual
|
|
statement: 실행 그래프의 정본은 `org-os/06-agent-work/workflow-contracts.yaml`입니다. 역할·권한 정책은 `org-os/00-role-registry/`에 있고, Claude Code용 command·agent·skill·hook은 `.claude/` 아래에서 이 계약을 소비하거나 검증합니다.
|
|
section: architecture
|
|
sources: [{fact-id: F-ARCH-STATE-ARTIFACT}, {fact-id: F-ARCH-DIRECTORIES}]
|
|
status: supported
|
|
- id: C-DIRECTORY-MAP
|
|
type: factual
|
|
statement: 저장소 구조와 책임
|
|
section: architecture
|
|
sources: [{fact-id: F-ARCH-DIRECTORIES}]
|
|
status: supported
|
|
- id: C-ROLE-MODEL
|
|
type: factual
|
|
statement: 현재 registry는 75개 AI 역할과 최종 사람 소유자 `HUMAN-001`, 28개 routing family, 12개 평가 lens를 정의합니다. agent generator의 현재 정합 계약은 101개 agent card입니다.
|
|
section: architecture
|
|
sources: [{fact-id: F-ARCH-ROLE-MODEL}]
|
|
status: supported
|
|
- id: C-GENERATED-AGENTS
|
|
type: factual
|
|
statement: 기여할 때는 산출된 `.claude/agents/*.md`만 직접 고치기보다 역할·family·method·tool 정본을 먼저 수정하고 생성기 정합 검사를 통과시키는 구조를 따르십시오.
|
|
section: architecture
|
|
sources: [{fact-id: F-ARCH-DIRECTORIES}, {fact-id: F-ARCH-ROLE-MODEL}]
|
|
status: supported
|
|
- id: C-WORKSPACE-LAYOUT
|
|
type: factual
|
|
statement: "`ORGOS_WORKSPACE`가 상대 경로이면 저장소 루트 아래 프로젝트 디렉터리로 해석되고, 절대 경로이면 그대로 사용됩니다."
|
|
section: artifacts
|
|
sources: [{fact-id: F-ARTIFACT-LAYOUT}]
|
|
status: supported
|
|
- id: C-REPORT-RECEIPTS
|
|
type: factual
|
|
statement: report는 `<workspace>/completion-records/<workflow>/<role>-<UTC timestamp>.report.yaml` 형식으로 새로 발급됩니다. 실행 command와 exit code, 작성 파일 경로와 SHA-256은 evidence ledger의 receipt로 남길 수 있지만, workspace를 해석하지 못한 계측 hook은 기록을 생략할 수 있습니다.
|
|
section: artifacts
|
|
sources: [{fact-id: F-ARTIFACT-PROVENANCE}]
|
|
status: supported
|
|
- id: C-CMD-DOCTOR
|
|
type: factual
|
|
statement: python3 .claude/hooks/doctor.py
|
|
section: verification
|
|
sources: [{fact-id: F-CI-WORKFLOW}]
|
|
status: supported
|
|
- id: C-CMD-AGENTS
|
|
type: factual
|
|
statement: python3 .claude/hooks/gen_agents.py --check
|
|
section: verification
|
|
sources: [{fact-id: F-ARCH-ROLE-MODEL}, {fact-id: F-CI-WORKFLOW}]
|
|
status: supported
|
|
- id: C-CMD-TESTS
|
|
type: factual
|
|
statement: python3 .claude/tests/run_all.py
|
|
section: verification
|
|
sources: [{fact-id: F-VERIFY-SUITE}]
|
|
status: supported
|
|
- id: C-CMD-BENCHMARK
|
|
type: factual
|
|
statement: python3 .claude/hooks/benchmark.py list
|
|
section: verification
|
|
sources: [{fact-id: F-MATURITY-BENCHMARK}]
|
|
status: supported
|
|
- id: C-TEST-RUNNER
|
|
type: factual
|
|
statement: "`run_all.py`는 artifact registry check, doctor, reference lint를 거친 뒤 `.claude/tests/test_*.py`를 suite별 제한시간과 함께 순차 실행합니다. 하나라도 실패하거나 timeout이면 exit 1입니다."
|
|
section: verification
|
|
sources: [{fact-id: F-VERIFY-SUITE}]
|
|
status: supported
|
|
- id: C-CI
|
|
type: factual
|
|
statement: GitHub Actions는 Python 3.12와 Node 20, `_sandbox` workspace에서 의존성을 설치하고 doctor, reference lint, agent generation check, 전체 test suite를 분리해 실행하도록 정의돼 있습니다.
|
|
section: verification
|
|
sources: [{fact-id: F-CI-WORKFLOW}]
|
|
status: supported
|
|
- id: C-BENCHMARK-STATUS
|
|
type: factual
|
|
statement: 벤치마크에는 13개 golden task가 정의돼 있지만 현재 실행 ledger에는 GT-01과 GT-R2의 plain·harness 표본만 있습니다. 두 과제는 first-pass acceptance, test pass rate, unnecessary change lines에서 모두 동률이므로 현재 데이터는 하네스의 품질 우위를 입증하지 않습니다.
|
|
section: verification
|
|
sources: [{fact-id: F-MATURITY-BENCHMARK}]
|
|
status: supported
|
|
- id: C-LIMIT-CONTEXT
|
|
type: factual
|
|
statement: "`company-context.yaml`과 `founder-context.yaml`은 현재 `template` 상태입니다. 회사 수립 경로를 사용하려면 사람이 founder context를 채우고 venture-bootstrap을 거쳐야 합니다."
|
|
section: limitations
|
|
sources: [{fact-id: F-MATURITY-CONTEXT}, {fact-id: F-WORKFLOW-VENTURE}]
|
|
status: supported
|
|
- id: C-LIMIT-HOOKS
|
|
type: factual
|
|
statement: 강제 hook은 Claude Code가 이 저장소의 `.claude/settings.json`을 로드한 세션 경계 안에서 동작합니다. 다른 실행 환경에서 같은 강제를 자동으로 보장하지 않습니다.
|
|
section: limitations
|
|
sources: [{fact-id: F-ARCH-HOOKS}]
|
|
status: supported
|
|
- id: C-LIMIT-UI
|
|
type: factual
|
|
statement: UI preview는 DOM mount, bundle, 대비, focus, 반응형 screenshot 같은 render health를 검사하지만 시각적 차별성·타이포그래피·비례·spacing의 미학 품질을 판정하지 않습니다.
|
|
section: limitations
|
|
sources: [{fact-id: F-PREREQ-UI}]
|
|
status: supported
|
|
- id: C-LIMIT-TOOLS
|
|
type: factual
|
|
statement: Node 18 이상과 D2 0.6 이상은 관련 기능의 권장 도구이고, Marp 3 이상은 선택 사항입니다. 전체 UI render에는 Chrome 또는 Chromium 계열 실행 파일도 필요합니다.
|
|
section: limitations
|
|
sources: [{fact-id: F-PREREQ-TOOLS}, {fact-id: F-PREREQ-UI}]
|
|
status: supported
|
|
- id: C-LIMIT-EVIDENCE
|
|
type: factual
|
|
statement: plain 대 harness의 현재 실행 표본은 저난도 bugfix 두 과제뿐이며 결과는 동률입니다. 설계·문서·의사결정 과제에 대한 품질 향상은 아직 실증되지 않았습니다.
|
|
section: limitations
|
|
sources: [{fact-id: F-MATURITY-BENCHMARK}]
|
|
status: supported
|