Commit Graph
3 Commits
Author SHA1 Message Date
DongHyeonka 01b4495214 docs(improvement): 이 repo의 결함 정의와 28개 관점 점검 위치를 적는다
문제: 가이드는 공용 일반론이라 이 repo에서 무엇을 결함으로 보고 어떤
등급을 줄지, 28개 관점마다 어디를 볼지 정해져 있지 않다. 라운드마다
같은 모양의 등급 조정을 다시 했다.

고른 방법: 이 repo가 스스로 한 약속(지원 범위, 현재 계약, 게이트,
생성 명령, 제거 가능성, 짝 계약)으로 결함을 정의하고, 지난 라운드의
등급 판정 예(게이트가 틀린 답을 내면 Medium·P1 등), 증거 규칙, 28개
관점별 볼 곳·검사·대표 발견, 지난 발견 재판정 방법, README·영역
문서 절 순서를 적는다. 심각도 체계는 가이드 35.2·35.3 하나만 쓴다.

위험·한계: 관점별 "볼 곳"은 지난 리뷰의 판정표에서 뽑은 것이라
빠진 곳이 있을 수 있다.

검증: 로컬 정적 대조. desktop 검사는 연결 커밋 뒤.
2026-11-05 22:15:22 +09:00
DongHyeonka 44961d7561 docs(improvement): 작업 종류별 절차와 세션 분업·반복 종료 조건을 적는다
문제: 리뷰·결함 수정·리팩터링·성능·구조·테스트 개선마다 시작 조건과
완료 기준이 어디에도 한곳에 없다. 총괄 세션 운영, 리뷰 중 실행 방식,
수정→리뷰 반복의 멈춤 조건은 사용자 지시와 리뷰 README에만 있다.

고른 방법: 01장에 여섯 작업의 시작 조건·단계·산출물·완료 기준을,
09장에 역할, brief, 리뷰 라운드 운영, "게이트는 한 번 돌리고 함께
읽는다", 멈춤 조건(새 High 0·새 P1 0·merge 14개 통과 뒤 그 라운드
Medium·Low 수정), 수정 라운드 운영, 총괄이 자주 한 실수를 적는다.
소유자 환경에 묶인 것은 09장 7절에만 둔다.

위험·한계: 스킬 기록 규칙과 대기 종료 조건 일반화는 [제안]으로
표시했다. 멈춤 기준의 3라운드 상한은 그동안 repo 밖 메모에만 있었다.

검증: 로컬 정적 대조. desktop 검사는 연결 커밋 뒤.
2026-11-05 22:15:22 +09:00
DongHyeonka ed6fad9cb9 docs(improvement): 개선 작업 매뉴얼의 정본 표와 읽는 순서를 둔다
문제: 리뷰·수정·리팩터링·최적화를 할 때 기준으로 삼을 이 repo 전용
문서가 없다. 기준이 CLAUDE.md, 리뷰 가이드, SPEC.md, gates.json,
리뷰 README 곳곳과 세션 기록에 흩어져 있어, 작업마다 다시 찾고
이미 정한 것을 다시 묻는다.

고른 방법: docs/improvement/README.md에 목적, 적용 범위, 정본 표
(무엇의 정본이 어디인가), 읽는 순서, 근거 표기, 결정 기록 M-1~M-10을
둔다. 규칙을 다시 쓰지 않고 정본을 가리킨다. 장 번호·파일 이름은
짝 백엔드 매뉴얼과 같게 맞췄다. 버린 대안: docs/reviews/ 안에 두기
(복사본이 지우는 작업 이력과 섞인다), docs/manual/ 뒤에 장 추가
(독자가 다르다).

위험·한계: 정본과 설명이 맞는지는 검사하지 않는다. 4라운드 리뷰는
아직 main에 없어 그 경로를 백틱 없이 적었다. 합쳐지면 바꿔야 한다.

검증: 로컬 정적 대조로 백틱 경로·script·FE-GATE ID가 있음을 확인했다.
verify:documentation과 문서 unit 테스트는 연결 커밋 뒤 desktop에서
돌린다.
2026-11-05 22:15:22 +09:00