company-haness/org-os/01-company/README.md

01-company — 회사 문맥 SoT (company-specific facts)

이 디렉터리는 **이 회사·이 제품에 특정한 사실(company-specific facts)의 단일 원천(SoT)**이다. 일반 프레임워크·베스트프랙티스(그건 role-working-methods.yaml·skill이 담당)가 아니라, **"우리 회사는 실제로 무엇을 하고, 어떤 제약·스택·사용자·최근 결정을 갖는가"**를 담는다.

에이전트가 판단을 내릴 때 이 폴더의 실데이터를 읽어 문맥을 접지(ground)한다. 여기 실데이터가 없으면 에이전트는 일반론으로 답하게 되고, 그 판단의 신뢰도는 아래 confidence 상한 규칙으로 강등된다.

파일

• company-context.yaml — 회사 사실·확정 전략·검증 중 가설과 프로젝트별 실행 manifest의 공식 SoT. 현재 Hyeonworks 문맥은 provisional이며, 확정된 제품 전략과 실제 제품 증거는 기록됐지만 시장·학습 효과·운영성 가설은 아직 검증 중이다.
• founder-context.yaml — 회사 정의보다 먼저 존재하는 창업자 제약·선호의 입력 SoT. 현재 filled이며, 확인되지 않은 시간·자본·사업 규모·유통·운영/리스크 값은 추론하지 않고 명시적으로 미확정 상태를 유지한다.
• vision.md, strategy.md, principles.md — (선택) 서술형 회사 방향 문서. 스키마가 아니라 산문.

company-context.yaml 상태·근거 정책 (P1)

• 공식 status는 3-상태: template → provisional → operating (bootstrap은 공식 status 아님 — 작성 중은 candidate 파일의 candidate-status: bootstrap로만 표현).
• company는 facts / strategic-decisions / hypotheses로 분리하며 항목별 provenance를 둔다(fact=provenance, decision=accepted-by/at/source-decision-id, hypothesis=validation-status/confidence/falsification-criteria). fact/decision/hypothesis(정보 종류)와 E1~E5(증거 강도)는 독립이다.
• 회사 인용 상한(finding #5)은 항목 단위: status != operating이면 company 인용 항목은 E2/Med 상한; hypothesis 항목 인용은 status 무관 Med 상한. 외부·코드·테스트 증거는 원등급 유지.
• 공식 파일은 commit_company_context.py(원자 교체)로만 갱신(직접 Edit/Write 차단). 내부 정합은 lint_company_context.py가 강제.
• 구 demo/populated는 읽기 호환(deprecation warning) + lint_company_context.py --migrate로 1회 변환.

Confidence 상한 규칙 (finding #5 — 불변 정책)

실제 회사·프로젝트 자료가 없는 판단의 confidence는 E1/E2로 상한(cap)된다.

근거: 이 하네스는 "모든 결론은 근거에 접지(E0~E5)"를 요구한다(CLAUDE.md 규칙). 그러나 회사에 특정한 사실(이 폴더의 실데이터, 또는 프로젝트 저장소의 실제 코드/문서)이 없으면 판단은 일반론일 뿐이다. 일반론에 High confidence를 붙이면 근거등급 체계가 무의미해진다. 따라서:

• E1 (약한 정황/추정) / E2 (일반 문헌·베스트프랙티스 근거) — 회사 실데이터 없이 내린 판단의 최대 등급. report-header.confidence는 이때 최대 Med.
• E3 이상 (프로젝트 산출물/실측/실행 receipt 근거) 은 이 폴더(또는 대상 프로젝트 저장소)의 실제 아티팩트를 인용할 때만 부여한다.
• E4/E5 (실행/실존 아티팩트) 는 receipt(evidence-ledger)로 검증되어야 한다(WP-6 계약). 회사 실데이터 부재 상태에서 자기신고만으로는 불가.
• 요약: 회사 문맥 부재 → confidence ≤ Med, 근거등급 ≤ E2. 이는 자기채점 금지 원칙의 연장이며, 실데이터가 채워질수록 상한이 풀린다.

이 규칙은 company-context.yaml 상단 주석에도 중복 명시되어 있다(에이전트가 스키마만 읽어도 상한을 인지하도록).

규칙

• 이 폴더는 회사 특정 사실만 담는다. 재사용 가능한 방법론/프레임워크는 00-role-registry의 role-working-methods.yaml과 skill에 있다(중복 금지).
• 실데이터는 민감할 수 있다(sensitivity 필드). 비밀/키/토큰은 여기에 평문으로 두지 않는다.
• 스키마 변경은 이 파일과 company-context.yaml을 함께 갱신한다.