docs: 살아 있는 문서·편집 훅·결정 색인을 지금 코드와 결정에 맞춘다 #29
Closed
donghyeon.kang
wants to merge 0 commits from
donghyeon.kang/fix/r9-living-docs-sync AGit into main
pull from: donghyeon.kang/fix/r9-living-docs-sync
merge into: :main
:main
:fix/r9-structure-locale
:fix/r9-adapter-carryover
:test/shared-build-lock-order
:ci/dependency-cache-same-filesystem
:ci/release-tag-for-a11y-review
:ci/merge-dependency-cache
:fix/test-timeouts-measured
:fix/feature-residue-word-boundary
:fix/provider-wait-stderr
:fix/provider-job-host-requirements
:fix/ungated-vitest-spec
:fix/a11y-evidence-routes
:fix/verify-parts-diagnostics
:claude/w2-fe-ci-perf-dce080
:fix/child-process-test-timeouts
:chore/layout-rules-r2-r5
:claude/fe-b-docs-korean-645f55
:chore/ci-merge-jobs
:chore/layout-3-merge
:claude/fe-c-harness-0ae061
:chore/layout-2-sample-removal
:chore/layout-1-cleanup
:docs/review-guide-pointer
:fix/maturity-review-2026-11-06
:fix/maturity-review-2026-11-05-b
:docs/improvement-manual
:fix/maturity-review-2026-11-05
:fix/session-subject-required
:fix/ui-design-audit-2026-11-01
:fix/maturity-review-2026-09-25
:lane/D
:lane/B
:fix/src-review-round3
:refactor/domain-scalable
:develop
:feature-frontend-optional-adapter-recipes
:feature-frontend-supply-chain-verification
:feature-frontend-test-registry-evidence-hardening
:frontend-test-registry-evidence-hardening
:feature-frontend-diagnostics-telemetry-runtime
:feature-frontend-i18n-message-formatting-contract
:feature-frontend-design-system-platform
:feature-frontend-form-page-platform
:feature-frontend-reference-feature-vertical-slice
:feature-frontend-routing-release-recovery-runtime
:feature-frontend-http-query-contract-execution
:feature-frontend-application-boundary-runtime
:feature-frontend-typescript-tooling-foundation
:feature-frontend-platform-capability-review
:feature-frontend-performance-route-contract
:feature-frontend-starter-experience-quality-contract
:feature-frontend-responsive-theme-contract
:feature-frontend-ui-primitives-gallery-contract
:feature-frontend-app-shell-navigation-contract
:feature-frontend-runtime-composition-contract
:feature-frontend-ci-quality-gates-contract
:feature-web-vitals-performance-budget-contract
:feature-frontend-release-cache-rollback-contract
:feature-accessibility-baseline-contract
:feature-frontend-project-bootstrap-toolchain-contract
:feature-frontend-operational-runbook-contract
:feature-frontend-contract-compatibility-governance
:feature-frontend-contract-registry-governance
:feature-frontend-browser-security-boundary-contract
:feature-frontend-build-bundle-supply-chain-contract
:feature-tailwind-design-token-styling-contract
:feature-sample-feature-slice-contract-fixture
:feature-frontend-render-recovery-boundary-contract
:feature-routing-navigation-guard-contract
:feature-boundary-mapper-viewmodel-contract
:feature-async-ui-state-contract
:feature-frontend-observability-logging-trace-contract
:feature-frontend-storage-registry-contract
:feature-server-state-caching-contract
:feature-frontend-auth-session-integration-contract
:feature-frontend-error-classification-boundary-contract
:feature-runtime-schema-validation-contract
:feature-api-client-response-envelope-contract
:feature-frontend-env-runtime-config-contract
:feature-frontend-architecture-enforcement-lint-contract
:feature-frontend-test-taxonomy-contract
:feature-frontend-clean-architecture-layering-contract
No Reviewers
Labels
No items
No labels
Milestone
No items
No Milestone
Projects
Clear projects
No projects
Assignees
donghyeon.kang (동현 강)
Clear assignees
No Assignees
Notifications
Due Date
No due date set.
Dependencies
No dependencies set.
Reference: donghyeon.kang/clean-architecture-frontend-template#29
Reference in New Issue
Block a user
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
무엇을, 왜
2026-11-07~08 정리(문서 이동, 참조 기능 삭제, CI 재편) 뒤 살아 있는 문서와 편집 훅이 지금 코드와 다른 말을 한다. 커밋 다섯이다.
c0ddc032훅 N5: 지침 문서(CLAUDE.md,src/**/AGENTS.md,.claude/문서)를 노트북 검사로 끝나는 파일로 센다. desktopverify:documentation도 그 문서를 읽는다(1112/08-04).06ffafa2낡은 문장 20건: 현재 계약 문서가 기록(docs/design/)을 정본으로 가리킴(02-06), 실시간 대응표 둘이 기록에만 있음(09-02), 실행 격리 변수 목록(08-17), 계약 소유 절 이름·pin 시험 게이트·drift 범위(02-07), INVENTORY 머리 숫자(02-08), 검증 안내(08-04·05·07·10·11·16), create:feature 참조(08-08·19), 라운드 없는 리뷰 ID 17곳(08-15), secret scan 범위(07-03), 이월 1103/16-06·0929/14-02·14-03·13-10·1106/14-02.8c887892훅 N5: 명령 안에scripts/verify.sh글자만 있어도(sed -n … scripts/verify.sh,git log -- scripts/verify.sh,--dry-run, 로그 읽기 ssh) desktop 실행으로 셌다(08-09).372b5237결정 색인(docs/work/reference/decisions.md)에 빠진 것: FE-GATE-029 단계 결정(08-14), 지난 리뷰의 결정 대기 15행(10-02), round9 결정 R9-D1~D12와 새 결정 대기 R9-D13.8105e00cPR 전 자체 리뷰가 찾은 훅 퇴행과 빠진 곳: 실행 판정을 다시 쓰면서 ssh의 값 받는 옵션(ssh -o BatchMode=yes desktop …,ssh -p 22 …)과bash scripts/verify.sh …를 세지 못하게 됐다(origin/main 판은 셌다).scripts/hooks/README.md·docs/ledger/README.md를 아직 노트북 파일로 셌다.고른 방법과 버린 대안
LAPTOP_ONLY에서 문서(.md)를 빼고.claude/의 설정·훅 상태만 남긴다. 버린 안: 훅은 두고 문서만 고치기(턴 끝 알림이 계속 빠진다).bash·sh를 감싸는 낱말에 더한다.scripts/hooks/·scripts/tests/·docs/ledger/에서도.md는 desktop 파일로 센다.;·&&·||·|·(로 나눠 첫 낱말이 verify.sh이고 다음 낱말이 단계 꼴이며docs·hooks·--dry-run·--on here가 아닐 때만 센다. ssh는 원격 명령이 읽기 명령뿐이면 세지 않는다. 버린 안:config/ci/gates.json의 stage id와 대조(다른 checkout에서도 같은 목록을 읽어야 한다).docs/architecture/optional-adapter-recipes.md로 옮기고, 숫자는 정본을 가리킨다. 기록 문서는 머리 블록만 고친다.위험과 영향
flock <파일> scripts/verify.sh)은 실행으로 세지 않아 알림이 한 번 더 뜬다.declare module문제(1112/09-01)는 고치는 방향이 check:architecture 규칙과 부딪쳐 R9-D13으로 남겼다.AGENTS.md28·29행이 붙어 있어 병합 충돌이 난다. 나중에 병합하는 쪽이 두 줄(FE-GATE-013 문장, 문서 검증 문장)을 다 살리면 된다.검증
python3 -m unittest discover -s scripts/tests: 74개 통과. 새 시험이 고치기 전 코드에서 실패했다(N5 다섯 경로, 실행 판정 다섯 경우, 자체 리뷰 뒤 다섯 경우).scripts/verify.sh docs: OK.64f9c13b·8a310cf4): FE-GATE-017 rc=1, FE-GATE-005 rc=1(documentation-readiness.test.ts가 같은 문서 검사를 돌린다), FE-GATE-010 rc=0. 원인 둘: 옮긴 실시간 표가 백엔드 경로를 이 repo 경로(src/adapter/inbound/…)로 적었고, 결정 색인 한 행이 아직 main에 없는 round9 README 경로를 적었다. 앞의 것은 짝 repo 이름(clean-architecture-backend-template/…)으로, 뒤의 것은 다른 행처럼 「round9 README 7절」로 고쳐 각 커밋에 합쳤다.8b718a6e= head8105e00c의 트리): documentation(FE-GATE-017) rc=0, FE-GATE-005 rc=0, FE-GATE-010 rc=0. 로그/tmp/claude-gates/r9f8-docs4/,/tmp/claude-gates/r9f8-gates2/.scripts/hooks/hooks.py,scripts/tests/test_hooks.py),config/repository-layout.json한 줄,src/adapters/realtime/polling/bounded-poll-coordinator.ts주석 3줄이다. FE-GATE-002·003은 따로 돌리지 않았다. round9 묶음을 합친 통합 merge 실행에서 본다.리뷰어가 볼 곳
scripts/hooks/의runs_only_reads,command_words와scripts/tests/test_hooks.py.docs/work/reference/decisions.md2.2·3.1절.관련
docs/reviews/2026-11-round9-02-structure.md,-08-guardrails-docs.md,-09-adapters.md,-10-prior-new.md(PR #23)#40으로 병합됐다(main
ee47480c). 이 PR의 head50d623c4가 #40 브랜치에 merge 커밋으로 들어 있고, #40의 runner merge job 셋이 그 합친 트리로 초록이었다. runner 대기를 줄이려고 이번만 쓴 방식이다(소유자 승인, 2026-11-13).Pull request closed