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