Commit Graph
5 Commits
Author SHA1 Message Date
DongHyeonka 8105e00ceb fix(hooks): ssh 옵션 값과 bash 실행을 세고 모듈 README를 desktop 파일로 센다
frontend-quality-gates / FE-GATE-014 / config-compatibility (pull_request) Skipped
frontend-quality-gates / deploy-promoted-release (pull_request) Skipped
frontend-quality-gates / FE-GATE-021 / runbook-boot-config (pull_request) Skipped
frontend-quality-gates / FE-GATE-024 / runbook-telemetry (pull_request) Skipped
frontend-quality-gates / FE-GATE-018 / field-web-vitals (pull_request) Skipped
frontend-quality-gates / FE-GATE-022 / runbook-chunk-mismatch (pull_request) Skipped
frontend-quality-gates / merge / static checks (pull_request) Successful in 3m16s
frontend-quality-gates / merge / tests (pull_request) Failing after 14m49s
frontend-quality-gates / merge / browser tests (pull_request) Failing after 8m20s
frontend-quality-gates / FE-GATE-028 / manual-accessibility-review (pull_request) Skipped
frontend-quality-gates / FE-GATE-026 / lab-performance (pull_request) Skipped
frontend-quality-gates / FE-GATE-015 / immutable-release-candidate (pull_request) Skipped
frontend-quality-gates / external-vulnerability-provider (pull_request) Skipped
frontend-quality-gates / external-provenance-provider (pull_request) Skipped
frontend-quality-gates / promote-verified-immutable-candidate (pull_request) Skipped
frontend-quality-gates / FE-GATE-019 / hosting-header (pull_request) Skipped
frontend-quality-gates / FE-GATE-023 / runbook-api-degradation (pull_request) Skipped
frontend-quality-gates / FE-GATE-025 / runbook-release-rollback (pull_request) Skipped
frontend-quality-gates / FE-GATE-017 / diagram-review (pull_request) Skipped
frontend-quality-gates / main / checker self-tests (pull_request) Skipped
앞 두 커밋 뒤 확인 리뷰가 퇴행 하나와 빠진 곳 하나를 찾았다.

- 실행 판정을 다시 쓰면서 ssh 뒤 `-`로 시작하는 낱말만 뺐다. 값을 받는 옵션
  (`ssh -o BatchMode=yes desktop …`, `ssh -p 22 desktop …`)은 그 값을 호스트로
  읽어 desktop 실행으로 세지 않는다. `bash scripts/verify.sh merge`도 첫 낱말이
  verify.sh가 아니라 세지 않는다. origin/main 판은 셋 다 셌다.
- 노트북 파일에서 문서를 뺀 것이 `.claude/`뿐이다. `scripts/hooks/README.md`와
  `docs/ledger/README.md`도 desktop `verify:documentation`이 읽는다.

고른 방법: ssh 뒤 옵션은 값을 받는 것(-o -p -i -l -J -F 등)이면 다음 낱말까지
건너뛰고 남은 첫 낱말을 호스트로 본다. bash·sh를 감싸는 낱말에 더한다.
scripts/hooks/·scripts/tests/·docs/ledger/ 패턴에서도 `.md`를 뺀다. README
문장을 같이 고친다.

검증: python3 -m unittest discover -s scripts/tests 74개 통과(노트북). 새 경우
다섯(bash, ssh -o, ssh -p, 두 README)이 고치기 전 코드에서 실패했다.

Refs: 1112/08-04, 1112/08-09
2026-11-13 00:30:19 +09:00
DongHyeonka 8c887892e6 fix(hooks): verify.sh를 읽거나 dry-run만 한 명령을 desktop 실행으로 세지 않는다
편집 훅 N5는 desktop에서만 확인되는 파일을 고친 뒤 desktop 실행이 없으면
턴 끝에 한 번 알린다. 그런데 명령 안에 `scripts/verify.sh` 글자만 있어도
뒤 낱말을 단계로 보고 실행으로 셌다. `sed -n 1,80p scripts/verify.sh && ls`,
`grep … scripts/verify.sh config/ci/gates.json`, `git log -- scripts/verify.sh
docs/work`, `scripts/verify.sh merge --dry-run`, 로그를 읽기만 하는
`ssh desktop 'cat …log | grep vitest'`가 모두 알림을 지웠다. README는 "돌린
명령"만 센다고 적는다.

고른 방법: 명령줄을 ;·&&·||·|·( 로 나눠 한 명령씩 본다. 앞의 VAR=값과
timeout·nohup 같은 감싸는 낱말을 건너뛴 첫 낱말이 verify.sh이고, 다음
낱말이 단계 이름 꼴이며 docs·hooks가 아니고, --dry-run·--on here가 없을
때만 센다. ssh는 원격 명령이 읽기 명령(cat·grep·tail 등)뿐이면 세지 않는다.
버린 대안: config/ci/gates.json의 stage id를 읽어 대조하기(시험 repo와 다른
checkout에서도 같은 목록을 읽어야 한다. exec·gate·script도 단계 자리에 온다).

위험·한계: 처음 보는 감싸는 낱말(예: `flock <파일> scripts/verify.sh`)은
실행으로 세지 않아 알림이 한 번 더 뜬다. 막지는 않는다.

검증: python3 -m unittest discover -s scripts/tests 74개 통과(노트북). 새 시험
다섯 경우가 고치기 전 코드에서 실패했다.

Refs: 1112/08-09
2026-11-12 23:36:14 +09:00
DongHyeonka c0ddc0328e fix(hooks): 살아 있는 지침 문서 편집도 desktop 확인을 알린다
편집 훅 N5는 CLAUDE.md, src/**/AGENTS.md·CLAUDE.md, .claude/ 아래
문서를 노트북 검사(check-work-docs.py)로 끝나는 파일로 센다. 그러나
desktop 게이트 verify:documentation도 그 문서들을 읽는다(경로·명령·
script·FE-GATE ID). 그래서 지침 문서만 고친 턴은 desktop 실행 없이
끝나고, 루트 AGENTS.md와 experts.md도 노트북 검사만 안내한다.

고른 방법: LAPTOP_ONLY에서 문서(.md)를 빼고 .claude/의 문서 밖 파일
(설정·훅 상태)만 남긴다. AGENTS.md 검증 줄과 experts.md 경로표에
desktop verify:documentation을 더한다. 버린 대안: 훅은 두고 문서만
고치기(턴 끝 알림이 계속 빠진다).

위험·한계: 지침 문서만 고친 턴도 이제 desktop 실행 전까지 한 번
막힌다. 막지는 않고 이유를 알린다(N5 동작 그대로).

검증: python3 -m unittest discover -s scripts/tests 72개 통과(노트북).
새 시험 test_living_instruction_documents_need_the_desktop은 고치기 전
코드에서 다섯 경로 모두 실패했다.

Refs: 1112/08-04
2026-11-12 22:46:05 +09:00
DongHyeonka f117a5af41 docs(src): 계층 폴더마다 지역 규칙 AGENTS.md를 두고 CLAUDE.md가 가져온다
계층별 규칙이 Claude만 읽는 .claude/rules/에만 있어 다른 에이전트에는
보이지 않았다. 하네스 자료의 3단계는 레이어마다 그 폴더에 AGENTS.md다.

src/의 9개 계층 폴더마다 AGENTS.md(16~20줄)를 둔다: 그 폴더가 하는 일,
그 폴더에만 걸리는 import 금지(.dependency-cruiser.json에서 from이 그
폴더에 맞는 규칙을 뽑아 이름과 함께), 검사하는 게이트, 테스트 위치. 모든
폴더에 걸리는 규칙은 루트 AGENTS.md와 layers.md를 가리킨다. 옆에
@AGENTS.md 한 줄 CLAUDE.md를 둬 Claude Code가 그 폴더 파일을 열 때 같은
책을 읽는다(백엔드와 같은 짝).

- .claude/rules/adapters·features는 폴더 AGENTS.md를 가리키게 줄였다.
- scripts/check-work-docs.py: src/**/AGENTS.md도 이력 ID 0·200줄·짝·링크를
  본다. 훅 N5는 이 파일들을 노트북 확인 파일로 친다.
- docs/reviews/adapters/INVENTORY.md: check:adapter-inventory가 src/adapters
  아래 추적 파일을 모두 요구하므로 두 행(142·143)을 더했다.
- 루트 AGENTS.md 지도가 가장 가까운 src/<계층>/AGENTS.md와 비전·문제 정의
  양식을 가리킨다.

버린 대안: .claude/rules/만 두기(다른 에이전트가 못 읽는다), 폴더 CLAUDE.md
없이 AGENTS.md만(Claude Code는 같은 폴더에 CLAUDE.md가 없고 Read로 열 때만
읽어 백엔드와 갈린다).

위험·한계: 규칙 이름은 지금 규칙 파일에서 뽑았다. 규칙을 더하거나 바꾸면
이 문서도 손으로 고쳐야 한다(정본은 규칙 파일과 check:architecture).

검증: scripts/verify.sh docs rc=0(src/**/AGENTS.md 9개, 최대 20/200),
python3 -m unittest discover -s scripts/tests 62건 통과.
2026-11-08 22:57:03 +09:00
DongHyeonka 9961ecb106 feat(hooks): 편집 직후 경계·게이트 기준·문서 알림과 턴 끝 desktop 알림을 건다
경계 위반, 늘어난 skip·only, 작업 매뉴얼 규칙 위반은 desktop 게이트에서야
드러났고, desktop 검증 없이 턴을 끝내도 아무것도 알리지 않았다.

scripts/hooks/hooks.py(백엔드 hooks.py와 같은 모양, 표준 라이브러리와
git만)를 .claude/settings.json에 단다.
- N3: src TypeScript를 고치면 import를 .dependency-cruiser.json의 forbidden
  규칙(path·pathNot·$1)에 그대로 대 본다. 규칙 파일을 읽으므로 규칙이
  바뀌면 따라간다.
- N6: 테스트에 .skip·.only·.fixme·.todo가 마지막 커밋보다 늘거나, 예산·
  기준선·ungated 목록·스냅숏을 고치면 알린다.
- N2: .md를 고치면 scripts/check-work-docs.py의 실패 줄을 알린다.
- N5: desktop만 확인할 수 있는 파일을 고친 뒤 desktop 실행이 없으면 턴
  끝을 한 번 막고 이유를 준다.
모두 넛지다. repo 안 편집에 되돌릴 수 없는 것이 없어 차단 훅은 없다.

고른 방법: 노트북에서는 정적 검사만 하고 포맷·린트·타입은 desktop
scripts/verify.sh에 둔다(brief, 2026-11-08). 설계 13절 Q6은 편집 훅에서
한 파일 eslint를 골랐지만, 프론트 eslint는 pnpm·node_modules가 필요해
"pnpm은 desktop에서만" 규칙과 부딪친다.

위험·한계: N3는 정규식으로 import를 뽑아 주석 속 따옴표 같은 드문
모양을 놓칠 수 있다. 정본은 check:architecture다. 훅 시험은 아직 CI
workflow가 부르지 않는다. 훅은 세션 시작에 읽혀 이 세션에서는 돌지
않았다.

검증: python3 -m unittest scripts/tests/test_hooks.py 26건 통과. 실제
규칙과 src 377개 파일에서 N3 알림 0(거짓 양성 시험). 조건 하나씩 끈
변이 10개를 모두 시험이 잡았다.

Refs: design-docs harness/01-harness-design.md 5.2·5.3절
2026-11-08 17:27:39 +09:00