DongHyeonkaandClaude Opus 5
0650d91def
rewriting-technical-prose-naturally 를 서브에이전트 셋으로 나눠 56편에 적용했다. ai-tells.md 의 첫 절대로 다른 표현으로 바꾸는 대신 문장을 통째로 지웠다. 설명한 것의 중요성을 다시 평가하는 꼬리 19 이미 설명한 것을 추상어로 되풀이 19 독자에게 읽는 법을 지시하거나 오해를 가정 9 자료가 뒷받침하지 않는 덧붙인 이득 4 문서군 전체의 문형 편중도 풀었다 — 함께 27→7(한 묶음), 그대로 22→12(두 묶음), 하게 된다 1→0. 한 편에서 세 번 반복되던 「같은 병이 ~에서도 났다」와 두 기록에 같은 문장으로 있던 세 쌍을 갈랐다. 계약 제목 「여덟 자리」가 본문의 「여덟 곳」과 어긋나 있었다. 제목이 spatial-metaphor 규칙에도 걸리므로 계약과 기록을 함께 「여덟 곳」으로 맞췄다. 검사 넷 전부 통과한다 — check_prose 56편 error 0 · check_body PASS · check_evidence --repo 문제 없음 · verify-tech-log-tree error 0 warn 0. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
3.7 KiB
kind, slug, title, topic, topicName, project, status, questionStatus, sourceRevision, source
| kind | slug | title | topic | topicName | project | status | questionStatus | sourceRevision | source | ||
|---|---|---|---|---|---|---|---|---|---|---|---|
| QUESTION | nobody-signed-the-accessibility-evidence | 라우트마다 요구하는 수동 접근성 증거를 아무도 서명하지 않았다 | one-route-many-hand-kept-lists | 라우트 하나가 울리는 손 목록 | TechLog | 게시 전 | OPEN | tech-log@2026-09-02 |
|
라우트마다 요구하는 수동 접근성 증거를 아무도 서명하지 않았다
CI 게이트가 설치된 라우트마다 수동 접근성 증거 파일을 하나씩 요구한다. 파일은 라우트마다 있고 그중 사람이 서명한 것은 하나도 없다. 게이트는 파일의 존재만 세고 서명은 보지 않는다.
관계
- 라우트 하나가 건드리는 여덟 곳과, 그것들이 우는 시점 이 게이트가 그 목록의 한 줄이다.
- 가드는 결함을 되돌려 실제로 멈추는 것을 확인한 뒤 커밋한다 게이트가 무엇을 실제로 막는지 확인하는 기준이다.
- 가드는 작동했는데 제가 그것을 돌리지 않아 두 번 새어 나갔다 이 게이트를 빠뜨려 빨간 채로 지나간 사건이다.
사실
FE-GATE-009 는 설치된 라우트마다 증거 파일 하나를 요구하고, 그 집합이 정확히 일치하지 않으면 거절한다.
artifacts/tests/a11y-manual/*.md 는 전부 pending-manual-review 다.
review:a11y-manual 스크립트는 그래서 실패하는 것이 지금 정상이다.
라우트를 더할 때마다 이 증거 개수도 늘어, 커밋 넷에서 111 → 117 이 됐다.
가정
게이트가 파일의 존재만 세는 것이 의도라고 보고 있다. 서명을 조건에 넣으면 라우트를 더할 때마다 배포가 막히므로 그렇게 두었다고 짐작하지만, 그 판단이 적힌 곳을 찾지 못했다.
서명 절차 자체는 사람이 화면을 열어 확인하는 일이라고 보고 있다. 어떤 항목을 어디까지 보는지 정한 문서를 확인하지 않았다.
미지수
게이트가 서명 여부까지 보게 하면 지금 몇 개의 라우트가 막히는가.
서명을 요구하지 않기로 한다면 이 게이트가 파일 개수를 세는 것이 무엇을 막는가.
라우트 하나를 사람이 실제로 검토하는 데 얼마가 드는가.
제약
FE-GATE-009 는 라우트 집합과 증거 집합이 정확히 일치하기를 요구한다. 이 규칙은 바꾸지 않는다.
수동 접근성 증거는 사람이 만든다. 자동 검사로 대신하지 않는다.
선택지
서명을 게이트의 통과 조건으로 올린다 라우트마다 사람이 검토하고 서명해야 배포된다. 지금 상태에서는 모든 라우트가 막히므로 한 번에 올릴 수 없고, 라우트별로 나눠 올려야 한다.
서명을 요구하지 않기로 적고 게이트에서 파일 요구를 뺀다 게이트가 세는 것이 무엇인지 분명해진다. 수동 검토를 하지 않기로 하는 결정이므로 그 결과를 따로 적어야 한다.
게이트는 그대로 두고 서명 현황을 별도로 보고한다 배포는 막지 않고 서명되지 않은 라우트 수를 드러낸다. 막지 않는 지표가 읽히지 않게 되는 것을 감수한다.
다음 검증
- 라우트 하나를 골라 실제로 사람이 검토하고 서명해, 그 검토에 얼마가 드는지 잰다
- 게이트가 서명 여부까지 보게 고치고 나머지 라우트에서 실제로 빨개지는지 확인한다
- 빨개지는 라우트 수를 세어 한 번에 올릴 수 있는지 판단한다
닫는 조건 : 서명이 게이트의 통과 조건이 되면 닫는다. 서명을 요구하지 않기로 정하고 게이트에서 그 파일 요구를 빼도 닫는다