Skip to content

Commit 0f848d8

Browse files
knowledge: add Decision Log block to the flush report
Required by the RTB decision-log PR gate: intent, rejected alternatives, and reviewer focus points (including the qa/index.md conflict with PR choiyounggi#10).
1 parent 1ff1aaf commit 0f848d8

1 file changed

Lines changed: 42 additions & 0 deletions

File tree

.dev-loop/INGEST_REPORT.md

Lines changed: 42 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -161,3 +161,45 @@ Body lines 83 / 82 / 93 (limit 120) · all four required sections present on eac
161161
every `related:` id and inline `[page-id]` resolves (13 checks, 0 misses) · each new page
162162
listed in its domain index with a multi-use-case "load when" · every index relative link
163163
resolves · no banned vague qualifiers · `log.md` entry appended.
164+
165+
## Decision Log
166+
167+
**의도**
168+
- 큐에 쌓인 4건을 3페이지로 인그레스트한다. qa 2건(자기참조 grep · 어휘 게이트/앵커)은
169+
"게이트가 걸린 문서를 편집하는 쪽"이라는 **한 케이스**라서 1페이지로 합쳤다
170+
(`AGENTS.md` "one case per page" + 지시문이 서로를 필요로 함).
171+
- 후보의 *why*를 그대로 받지 않고 실측으로 교정했다: `--body-file` 차단 원인은
172+
"따옴표 때문"이 아니라 **따옴표=추출 실패 / 미확장 변수=경로 부재**의 두 모드이고
173+
따옴표 친 리터럴 경로도 실패한다(본문 표에 5변형 실측).
174+
- 열린 PR(#6~#10)까지 중복 검사 대상에 포함했다. `main`만 보면 커버리지를 과소평가해
175+
#10과 같은 페이지를 또 만들 위험이 있었다.
176+
- `INDEX.md`**의도적으로 건드리지 않았다**#10이 이미 qa 라우트 라인을 갱신하므로
177+
충돌면을 `wiki/qa/index.md` 한 훅으로 줄였다.
178+
179+
**배제한 대안**
180+
- *insight 1을 `background-services`에 병합* → 기각. 그 페이지의 케이스는 *지속성*이고,
181+
블로킹 stdin을 넣으면 "load when"이 흐려진다(양방향 링크로 대체).
182+
- *insight 2를 `portable-shell-scripts`에 병합* → 기각. 그 페이지 규칙은 "모든 확장을
183+
따옴표로 감싸라"인데 이 건은 한 인자를 리터럴로 쓰라는 것 — 트리거도 다르고 규칙이
184+
충돌해 보인다. 새 페이지에 "이 페이지는 인자 하나만 좁히며 다른 곳의 무따옴표 확장을
185+
허용하지 않는다"를 명시.
186+
- *insight 2용 새 카테고리(`policy-gates`)* → 기각. 두 번째 멤버가 안 보이는 1페이지
187+
카테고리. 메커니즘이 확장 타이밍이라 `shells`가 맞다.
188+
- *insight 1을 `debugging`으로* → 기각. 바꾸는 산출물이 호출 명령이므로 소유 도메인 우선
189+
규칙에 따라 platforms(진단 절반은 `debugging-methodology-reproduce-first`로 링크).
190+
- *qa 2건을 #10 머지까지 보류* → 기각. 범위 축소는 소유자 판단이므로, 대신 충돌 위치와
191+
해소법(헤딩 1개 + 행 2개)을 위에 명시했다.
192+
- *#10 브랜치를 base로 스택 PR* → 기각. 스킬이 `--base main`을 요구하고, 리뷰 diff에
193+
#10 변경이 섞인다.
194+
195+
**리뷰어가 볼 곳**
196+
1. `wiki/qa/index.md`#10과 충돌 예정 지점. **헤딩 1개 유지 + 행 2개**로 해소.
197+
2. `wiki/qa/document-verification/editing-a-gated-document.md`#10의 페이지와
198+
중복이 아닌지(저자 측 vs 게이트 저자 측 분담)가 이 PR의 핵심 판단.
199+
3. `command-text-inspected-before-execution.md`의 Field context 5변형 표 —
200+
`hooks/pre-flush-pr-gate.sh:56` 패턴으로 재현 가능.
201+
4. confidence 등급: 1·2는 `verified`(공식 문서+재현), 3+4는 `field-tested`
202+
(위험은 문서화되어 있으나 지시문은 현장 유래). 1번 페이지의 클라이언트/서버 분리
203+
단계는 문서 근거가 아니라 현장 유래라서 Field context로 분리해 표기했다.
204+
5. **[추정]** `platforms/shells`에 2페이지(이식성 + 확장 타이밍)가 앞으로도 응집적으로
205+
남을 것이라는 판단은 추정이다 — 유사 사례가 더 쌓이면 별도 카테고리가 나을 수 있다.

0 commit comments

Comments
 (0)