docs(improvement): 리뷰·수정·리팩터링의 기준이 되는 개선 작업 매뉴얼을 둔다 #6
Closed
donghyeon.kang
wants to merge 10 commits from
docs/improvement-manual into main
pull from: docs/improvement-manual
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#6
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.
무엇을, 왜
리뷰·결함 수정·리팩터링·성능 최적화·구조 변경·테스트 구조 개선의 기준이 되는 이 repo 전용 매뉴얼을
docs/improvement/에 둔다.CLAUDE.md, 공용 리뷰 가이드(docs/reviews/TEMPLATE-MATURITY-REVIEW-GUIDE.md),SPEC.md,config/ci/gates.json, 리뷰 README 곳곳, 세션 기록이다. 그래서 작업마다 다시 찾고, 이미 정한 것을 다시 물었다.docs/manual/은 새 기능을 만드는 순서다. 독자가 달라서 따로 둔다.담은 것(파일 11개):
README.md: 목적, 적용 범위, 정본 표(무엇의 정본이 어디인가), 읽는 순서, 결정 기록01작업 종류별 절차,02리뷰 기준(이 repo의 결함 정의와 28개 관점 점검 위치)03폴더·모듈 구조,04코드 구조,05테스트 구조,06성능 측정 기준07검증과 게이트(무엇을 언제 어디서, merge 판정 방법),08결정과 기록(소유자 결정 색인),09작업 진행 방식(세션 분업, 리뷰 중 실행 방식, 반복 종료 조건)1105 리뷰에서 두 번 이상 나온 결함 모양 49개(P-01P-49)연결:
CLAUDE.md맨 위에 "개선 작업 기준" 절을 더해 매뉴얼을 가리킨다.docs/README.md§1에improvement/링크를 더한다. 이 목록에 있어야verify:documentation이 매뉴얼의 경로·script·게이트 ID를 검사한다.e9d9c36):CLAUDE.md전체 리뷰 절차 2단계가 명령 11개를 손으로 적고 있었다. 이 목록으로는 merge 게이트 14개 중 7개(001, 008, 009, 011, 012, 013, 020)가 전혀 돌지 않는다. 그래서 "merge 단계gateIds전부를 workflow env로ci:gate로 하나씩"으로 바꿨다. 2026-11-03 리뷰가 실제 CI에서 항상 실패하던 게이트 둘(1103/11-06, 12-09)을 놓친 경로다.고른 방법과 버린 대안
docs/improvement/.docs/reviews/안에 두기. 다운스트림이 지우는 작업 이력과 섞인다.docs/manual/뒤에 장 더하기. 독자가 다르다.docs/README.md§1 링크로 넣었다.위험과 영향
verify:documentation은 경로·script·게이트 ID가 있는지만 본다.docs/reviews/2026-11-05-maturity-review/)는 백틱 없이 적었다. 아직 main에 없어서다(PR #5). PR #5가 merge되면 백틱을 붙여 검사 범위에 넣는다.CLAUDE.md에 4줄이 더해져 지난 리뷰 문서가 적은CLAUDE.md줄 번호가 4줄씩 밀린다. 리뷰 기록은 고치지 않는다.AGENTS.md는 추적하지 않는 사본이라 이 변경을 받지 않는다(08장 M-10).검증
desktop에서 브랜치 끝
e9d9c36을 검사했다.verify:documentation: 옆에 백엔드 checkout이 없을 때와 있을 때 모두PASS_SCOPED다. 매뉴얼 11개 파일의 문제는 0건이다.실행하지 않은 것: merge 게이트 14개. 문서만 바꾼 PR이라서다.
verify:documentation은 FE-GATE-005·020 안에서도 돈다.리뷰어가 볼 곳
docs/improvement/README.md의 정본 표. 무엇을 이 매뉴얼이 새로 정하는지가 마지막 행에 있다.docs/improvement/09-working-method.md: 세션 분업, 리뷰 중 실행 방식, 반복 종료 조건docs/improvement/07-verification-gates.md: 무거운 실행 위치(desktop)와 merge 판정 방법CLAUDE.md의 두 변경: "개선 작업 기준" 절, 전체 리뷰 절차 2단계관련
clean-architecture-backend-template의docs/improvement/(별도 세션이 작성 중)docs/reviews/TEMPLATE-MATURITY-REVIEW-GUIDE.md,CLAUDE.md「리뷰 기준」Pull request closed