문서 지도 + 작성 순서 게이트

<!-- 문서 지도 + 작성 순서 게이트 v0.1 · https://namtank96.github.io/assets/a15-docs-index -->

# 문서 목록 (Docs Index)

> 이 프로젝트의 문서가 몇 개이고, 무엇이 무엇에 의존하며, 어떤 순서로 써야 하는지의 단일 지도.
> 새 문서를 만들면 **같은 커밋에서** 이 표를 갱신한다.

## 0. 이 프로젝트가 만드는 것 (한 줄)

{한 문장. 이 줄이 안 써진다면 문서를 더 쓸 때가 아니다. 범위부터 정한다.}

## 1. 문서 계층

문서를 종류가 아니라 **바뀌는 속도**로 나눈다. 아래층이 바뀌면 위층은 대개 안 바뀐다.

| 층 | 무엇 | 바뀌는 빈도 |
|---|---|---|
| **L0 정체성** | 원칙. 규격들이 왜 그 모양인지의 근거 | 거의 안 바뀜 |
| **L1 규격 (SSOT)** | 입력·도출·출력의 형식. 기계 검증본과 항상 동기 | 결정이 갈릴 때 |
| **L2 운영** | 매 세션 지킬 규칙, 검증 방법, 배포 절차 | 자주 |
| **L3 실행** | 하네스, 스크립트, 축적 규칙 | 자주 |

**규칙이 규격과 어긋나면 규격이 이긴다. 규격이 원칙과 어긋나면 원칙이 이긴다.**

## 2. 문서 일람

층마다 표 하나. 각 행에 **상태**를 반드시 단다. 상태가 없으면 읽는 사람이 그 문서를 믿어도 되는지 판단할 수 없다.

| 문서 | 역할 | 상태 |
|---|---|---|
| `{경로}` | {한 줄} | 확정 v1.0 / 작성 중 / 초안 / **폐기** |

- **초안을 일람에서 빼지 않는다.** 빼면 같은 문서를 다시 만든다.
- **폐기 문서는 일람 맨 아래 별도 절에 사유와 함께 남긴다.**

## 3. 의존 관계

```
L0 원칙
  └─ L1 규격 A ──┬─ L1 규격 B (A의 출력을 입력으로 받음)
                 └─ L2 운영 규칙 (A·B를 요약해 매 세션 적용)
                        └─ L3 하네스 (B의 산출을 검증)
```

- **화살표를 거슬러 올라가는 참조를 만들지 않는다.**
  L1 규격이 L3 하네스를 참조하기 시작하면 순환이 생기고, 그때부터 어느 것이 먼저인지 아무도 모른다.
- 문서 A를 고칠 때 **아래로 흐르는 문서를 같은 커밋에서 확인한다.**

## 4. 작성 순서와 게이트

**이 절이 이 문서의 존재 이유다.** 진행이 어디까지 왔는지의 기준점이 여기 있다.

```
1. 원칙 (L0)              ← 여기서 갈릴 결정의 기준을 먼저 잡는다
2. 입력 규격 (L1)
3. 도출 규격 (L1)
4. 출력 규격 (L1)
5. ★ 첫 건을 손으로 완주   ← 게이트
6. 하네스 (L3)
7. 검증 (L3)
8. 축적 (L3)
```

**게이트 규칙**

- **5번을 손으로 완주하기 전에 6~8번에 착수하지 않는다.**
  손으로 한 번 끝까지 가보기 전에는 어디가 반복이고 어디가 판단인지 알 수 없다.
  그 상태에서 만든 자동화는 판단해야 할 곳을 자동화하고 반복을 남겨둔다.
- **규격 1개를 확정하면 즉시 1건에 적용해 교정한다.** 여러 개를 쌓아두고 한 번에 검증하지 않는다.
  결함이 한꺼번에 쏟아지면 어느 규격이 원인인지 분리되지 않는다.
- 순서를 앞당겨야 하면 **왜 앞당기는지 적고 확인을 받는다.** 조용히 건너뛰지 않는다.
- **현재 위치를 이 문서에 표시한다.** `← 현재` 한 줄이면 된다.
  여러 문서에 진행 상태를 흩어두면 어디가 진짜인지 모르게 된다.

## 5. 폐기 문서

| 문서 | 폐기일 | 사유 | 대체 |
|---|---|---|---|
| `{경로}` | YYMMDD | {왜 버렸는지} | `{경로}` 또는 없음 |

지운 이유가 다음 사람의 자산이다. 파일은 보관 폴더로 옮기고 표에 남긴다.

---

## 유지 규칙

- **새 문서 = 같은 커밋에서 이 표 갱신.** 별도 작업으로 미루면 반드시 어긋난다.
- 이 문서가 길어지면 문서가 너무 많은 것이다. 지도를 손보지 말고 문서 수를 줄인다.
- 문서 상태를 낙관적으로 적지 않는다. **"작성 중"을 "확정"으로 적는 순간 이 지도는 못 쓰게 된다.**