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을 함께 갱신한다.