# ops/findings/ — 발견 기록

ops 우산의 작업 중 드러난 **버그·불일치·예상 밖 동작**을 흘리지 않고 남기는 자리다.
규약의 정본은 `.claude/prds/ops-00-protocol.prd.md` §발견 기록 규약이다.

## 소유 경계

- **디렉터리와 기록 형식**은 `ops-00-protocol` 소유다.
- **각 파일의 본문**은 그 파일을 만든 PRD 소유다. 다른 PRD 의 파일을 편집하지 않는다.

## 파일명 규약

`<prd-id>.md` — PRD 파일명에서 `.prd.md` 접미를 뗀 값이다. **`ops-` 접두는 유지한다.**

| PRD 파일 | findings 파일 |
|---|---|
| `ops-00-protocol.prd.md` | `ops-00-protocol.md` |
| `ops-40-db-snapshot.prd.md` | `ops-40-db-snapshot.md` |

## 기록 형식

한 파일에 여러 발견을 담는다. 발견 하나가 `## ` 표제 하나이며, 그 아래 **필수 6항목**을
`### ` 표제로 이 순서 그대로 둔다. 비어 있는 항목은 항목이 없는 것과 같다.

항목 목록과 순서의 정본은 이 표가 아니라 `.claude/prds/ops-00-protocol.prd.md`
§발견 기록 규약의 `기록 필수 항목:` 문장이다. `verify-ops.sh` 가 그 문장에서 유도한 값과
이 표를 **순서까지** 대조한다 — 이 표만 고치면 실패한다.

**`발견 일시` 와 `상태` 는 열거 필드다.** 그 값 하나만 적는다. 단서·유보·설명은
`관찰 사실` 이나 `심각도` 로 간다.

| # | 항목 | 담는 것 |
|---|---|---|
| 1 | 발견 일시 | `YYYY-MM-DD` **하나만**. 관찰한 날이지 기록한 날이 아니다 |
| 2 | 관찰 사실 | 무엇을 보았는가. 해석 없이 |
| 3 | 재현 절차 | 같은 것을 다시 보게 하는 최소 절차. 도구·환경·입력 |
| 4 | 근거 앵커 | `파일:행` 또는 요청/응답. **행 번호는 동결 SHA 를 병기**한다 |
| 5 | 심각도 | 노출·손실·오동작 중 무엇이며 범위가 어디까지인가 |
| 6 | 상태 | `미판정` / `사용자 통보` / `처리 결정됨` 중 하나. **그 값 하나만** |

## 적지 않는 것

**판단이나 수정 제안을 적지 않는다.** 사실만 남긴다.

이 우산의 축은 문서화이고 수정 여부는 사용자 판단 사항이라는 것이 하나, 제안이 섞이면 다음
사람이 *"이미 처리 방향이 정해진 건"* 으로 읽어 사실 확인을 건너뛴다는 것이 둘이다.
검증하지 않은 범위는 **미검증이라고 적는다** — 추정으로 메우지 않는다.