e2daf8e0120e1c6121e8e35d90daa3c1fcf9b1db
15
Commits
| Author | SHA1 | Message | Date | |
|---|---|---|---|---|
|
|
8de1403b92 |
ci(gates): 선택 runtime 제거 드릴 셋을 main 단계의 FE-GATE-030으로 옮긴다
문제: runner PR 1회(merge job 셋, capacity 1이라 차례로)가 28.5분이다 (run 151). tests job의 FE-GATE-020이 13분 13초로 가장 크고, 그 안의 선택 runtime 제거 드릴 셋(optional recipe, browser file/storage, realtime)이 약 7분이다. worker를 늘리지 않는 대책을 다 넣어도 25분 목표에 닿지 않는다. 고른 방법(소유자 결정 p, 2026-11-12): 그 드릴 셋을 새 게이트 FE-GATE-030 `optional-removability`로 떼어 main 단계(`main_gate`, FE-GATE-029 다음)에서 돌린다. 샘플 제거와 scaffold 드릴은 merge의 FE-GATE-020에 남는다. 짝 백엔드가 무거운 lane을 nightly로 옮긴 것과 같은 모양이다. - 계약: 정규 게이트 ID를 001..030으로, MAIN_READY를 029·030으로, main_gate job의 게이트를 029·030으로 바꾼다. 계약 보고서의 gateCount는 29(016은 은퇴). - scaffold 드릴의 제외 목록에서 셋을 뺀다. 이제 merge 명령이 아니라서, 계약 검사가 「merge 밖 명령을 제외하면 숨긴다」고 거절했다. - main job 이름을 `main / self-tests and removal drills`로 바꾼다. - 시험: 020은 merge·merge_test에서 sample·scaffold만, 030은 main·main_gate에서 셋을 돈다고 단언한다. 승격 공식 시험에 030을 더한다. - 문서: 결정 색인(decisions.md 2.2), 구조·시험·리뷰 기준·CI 문서, fe-structure 스킬의 드릴 명령. 위험·한계: 선택 runtime을 바꾼 PR의 제거 회귀는 병합 뒤 main run에서 본다. main이 빨강이면 다음 PR이 고친다. 그런 PR은 `scripts/verify.sh gate FE-GATE-030`을 직접 돌려야 한다(structure.md 12절에 적음). 파생 프로젝트가 main job 이름을 필수 검사로 걸었으면 이름이 바뀐다. 검증(desktop): generate:ci-workflow, 생성 시험 스냅샷 갱신, ci-workflow-generation·promotion-readiness·feature-scaffold-drill· removal-drill-test-paths·example-feature-rules 등 483개 통과, check:ci(29 gates) rc=0, check:ci:gating rc=0, verify:documentation PASS_SCOPED, check:types·eslint rc=0. 로그 /tmp/claude-gates/w2fe2-o1b~g/. |
||
|
|
ba72b86595 |
chore(merge): FE-GATE-013 판정·시험 timeout PR들이 들어간 main을 받는다
frontend-quality-gates / merge / static checks (pull_request) Successful in 2m7s
frontend-quality-gates / merge / tests (pull_request) Successful in 20m56s
frontend-quality-gates / merge / browser tests (pull_request) Successful in 6m56s
frontend-quality-gates / FE-GATE-014 / config-compatibility (pull_request) Skipped
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 / deploy-promoted-release (pull_request) Skipped
frontend-quality-gates / FE-GATE-019 / hosting-header (pull_request) Skipped
frontend-quality-gates / FE-GATE-021 / runbook-boot-config (pull_request) Skipped
frontend-quality-gates / FE-GATE-022 / runbook-chunk-mismatch (pull_request) Skipped
frontend-quality-gates / FE-GATE-023 / runbook-api-degradation (pull_request) Skipped
frontend-quality-gates / FE-GATE-024 / runbook-telemetry (pull_request) Skipped
frontend-quality-gates / FE-GATE-025 / runbook-release-rollback (pull_request) Skipped
frontend-quality-gates / FE-GATE-018 / field-web-vitals (pull_request) Skipped
frontend-quality-gates / main / checker self-tests (pull_request) Skipped
frontend-quality-gates / FE-GATE-017 / diagram-review (pull_request) Skipped
main( |
||
|
|
f6e2560e4d |
docs: FE-GATE-013이 시스템 컨테이너에서 도는 것을 지침과 운영 문서에 적는다
frontend-quality-gates / merge / static checks (pull_request) Successful in 1m49s
frontend-quality-gates / merge / tests (pull_request) Successful in 22m18s
frontend-quality-gates / merge / browser tests (pull_request) Successful in 6m54s
frontend-quality-gates / FE-GATE-014 / config-compatibility (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 / deploy-promoted-release (pull_request) Skipped
frontend-quality-gates / FE-GATE-021 / runbook-boot-config (pull_request) Skipped
frontend-quality-gates / FE-GATE-022 / runbook-chunk-mismatch (pull_request) Skipped
frontend-quality-gates / FE-GATE-024 / runbook-telemetry (pull_request) Skipped
frontend-quality-gates / FE-GATE-025 / runbook-release-rollback (pull_request) Skipped
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-019 / hosting-header (pull_request) Skipped
frontend-quality-gates / FE-GATE-023 / runbook-api-degradation (pull_request) Skipped
frontend-quality-gates / FE-GATE-018 / field-web-vitals (pull_request) Skipped
frontend-quality-gates / FE-GATE-017 / diagram-review (pull_request) Skipped
frontend-quality-gates / main / checker self-tests (pull_request) Skipped
문제: 작업 매뉴얼·루트 지침·스킬이 「desktop의 FE-GATE-013은 호스트 제약
실패로 적고 merge 가능 여부는 소유자가 정한다(결정 대기 D8)」라고 적고
있다.
|
||
|
|
91962e24e3 |
test(setup): 자식 프로세스를 띄우는 시험이 잰 시간으로 timeout을 정한다
자식 프로세스를 띄우는 Vitest 시험 91개(24파일)가 기본 timeout 10초에 기대고 있었다. 셋은 FE-GATE-013에서만 도는 tests/system 시험이다. 기본값은 프로세스 안에서 도는 시험에 맞춘 값이다. 부하가 높은 desktop에서는 자식 프로세스 시험이 평소보다 크게 느려진다. FE-GATE-020 drill 사본에서 평소 0.4~1.2초인 문서 시험이 10.6초 걸려 실패했다(2026-11-12). 가장 위험한 것은 tests/architecture/app-build-input .test.ts로, desktop에서 이미 5.7초까지 걸렸다. 무엇을 고칠지는 desktop 계측으로 정했다. - test:coverage 묶음(maxWorkers=4)과 test:unit을 세 번씩 돌렸다. 시험마다 띄운 자식 프로세스는 child_process 함수를 감싸 기록했고, 소요 시간은 JSON reporter로 받았다. - 시험마다 실제 timeout은 task.timeout으로 기록했다. - 자식 프로세스를 띄우는 시험 140개 중 88개가 기본값이었다. tests/system은 그 묶음에 없어서, 아래 검사가 잡은 셋을 따로 세 번 쟀다. 고친 것: - tests/helpers/child-process-timeout.ts의 childProcessTimeout(<잰 최대 ms>)는 그 15배를 30초 단위로 올린 값이다. 15배는 위 0.7초 → 10.6초에서 왔다. 시험마다 자기가 잰 최대값을 인자로 적어 근거가 호출 자리에 남는다. - describe 안의 기본값 시험이 모두 자식 프로세스를 띄우면 describe에, 일부만 띄우면 그 시험에 준다. 프로세스 안에서 도는 시험의 hang을 늦게 잡지 않으려는 것이다. - tests/setup.ts가 child_process 함수를 감싼다. 기본 timeout인 시험이 자식 프로세스를 띄우면 그 호출에서 실패시키고, helper 이름을 알린다. helper나 시험이 import한 스크립트가 띄워도 잡는다. util.promisify가 읽는 속성은 원래 함수에서 옮긴다. - docs/work/reference/testing.md 2절에 값 정하는 법과 이 검사를 적었다. 버린 것: - 전역 testTimeout 올리기: 프로세스 안 시험의 hang을 늦게 잡는다. - 시험마다 손으로 정한 숫자: 근거가 남지 않고, 이미 있는 값도 60_000·120_000처럼 근거가 없었다. - 자식 프로세스를 띄우지 않게 바꾸기: 검사 스크립트를 CLI 그대로 시험하는 것이 이 시험들의 목적이라 범위가 커진다. - 파일에 timeout 선언이 있는지만 보는 정적 검사: helper가 띄우는 경우와 같은 파일의 다른 시험을 놓친다. 위험: - hook(beforeAll 등)에서 띄우는 프로세스는 검사하지 않는다. 계측에서 hook이 띄운 곳은 둘이고, 둘 다 180초를 선언했다. - 같은 파일 안에서 it.concurrent로 도는 시험이 섞이면 어느 시험의 timeout인지 틀릴 수 있다. 지금은 그런 시험이 없다. - 다운스트림 시험이 기본값으로 자식 프로세스를 띄우면 test:unit 등이 실패한다. 메시지가 helper를 알린다. 검증(desktop): - 다섯 검사(test:unit·check:types·check:ci·lint·verify:documentation) rc=0. - 자식 프로세스를 띄우는 시험 파일 40개와 tests/scale: rc=0, 검사 위반 0. - tests/system: 115개 중 18개 실패. 모두 bwrap 호스트 제약이고 검사 위반은 0이다. - 변이: 검사를 끄면 tests/unit/child-process-timeout.test.ts가 실패한다. tracked-artifacts describe의 timeout을 지우면 그 시험이 검사 메시지로 실패한다. - 재현: CPU 10% 제한에서 app-build-input·registry-governance·hosting-probe ·design-system-rules를 돌렸다. main 650d22fa는 11개가 10초 timeout으로 실패했다. 이 커밋은 71개 모두 통과했고, 가장 긴 시험은 17.7초였다. |
||
|
|
bdda84f844 |
docs(work): desktop FE-GATE-013을 조건부로 merge 판정에서 빼기로 정한다
문제: FE-GATE-013을 멈춤 기준에서 어떻게 셀지가 결정 대기라, desktop에서 merge 판정을 하면 매번 「merge 가능 여부는 소유자가 정한다」로 끝났다. desktop의 ssh 셸은 비특권 user namespace를 막아 test:system 사전 점검이 호스트 원인으로 실패한다. 고른 방법: 소유자 결정(2026-11-11, 「그 조건이 되는 실행 환경을 찾아 초록으로」)에 따라 총괄이 권하는 안으로 정했다(2026-11-12). - merge 판정에서 빼는 조건 둘: 실패가 사전 점검의 user namespace 제한 하나뿐이고, `scripts/verify.sh parts FE-GATE-013`의 뒤 명령이 모두 rc=0. - 게이트 「충족」은 조건을 갖춘 runner에서 FE-GATE-013이 통과한 것으로만 센다. - decisions.md: 3.1절(열린 결정)에서 빼고 2.2절에 결정·버린 안·재검토 조건을 적었다. evidence.md 행에 결정 번호를 더했다. - gates.md 3절의 보고 문구, improve.md 멈춤 조건 3, operate.md 4.1절, new-feature.md 완료 기준, desktop-gates 스킬 6단계를 새 규칙으로 고쳤다. 버린 안: runner에서 통과할 때까지 merge 판정을 미충족으로 두기. 그 runner가 아직 없어 모든 PR의 merge 판정이 막힌다. 위험: desktop에서 test:system의 provider 테스트는 여전히 돌지 않는다. 그 몫의 결함은 runner가 FE-GATE-013을 돌 때까지 merge 판정에서 안 보인다. 뒤 명령 목록을 옮겨 적지 않고 gates.json `commandIds`를 가리킨다. 검증: python3 scripts/check-work-docs.py OK(지난 ID 줄 0), python3 -m unittest discover -s scripts/tests 71개 통과. 문서 검사는 desktop에서 돌린다. |
||
|
|
5d3e0f59ae | Merge remote-tracking branch 'origin/main' into claude/w3-experts-fe | ||
|
|
e9e98b8aa7 |
Merge branch 'main' into claude/fe-b-docs-korean-645f55
정리 3·4단계 PR #14와 CI 재편 PR #16(main
|
||
|
|
b5e7f54bd1 |
feat(claude): 분야 전문가를 지식 스킬 아홉 개와 렌즈 리뷰어로 두고 협업 명단을 붙인다
frontend-quality-gates / merge / static checks (pull_request) Successful in 3m3s
frontend-quality-gates / merge / tests (pull_request) Failing after 13m34s
frontend-quality-gates / merge / browser tests (pull_request) Successful in 9m26s
frontend-quality-gates / FE-GATE-017 / diagram-review (pull_request) Skipped
frontend-quality-gates / main / checker self-tests (pull_request) Skipped
frontend-quality-gates / FE-GATE-014 / config-compatibility (pull_request) Skipped
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 / deploy-promoted-release (pull_request) Skipped
frontend-quality-gates / FE-GATE-019 / hosting-header (pull_request) Skipped
frontend-quality-gates / FE-GATE-021 / runbook-boot-config (pull_request) Skipped
frontend-quality-gates / FE-GATE-022 / runbook-chunk-mismatch (pull_request) Skipped
frontend-quality-gates / FE-GATE-023 / runbook-api-degradation (pull_request) Skipped
frontend-quality-gates / FE-GATE-024 / runbook-telemetry (pull_request) Skipped
frontend-quality-gates / FE-GATE-025 / runbook-release-rollback (pull_request) Skipped
frontend-quality-gates / FE-GATE-018 / field-web-vitals (pull_request) Skipped
문제: 하네스에 분야 지식이 없다. QA·디자인/UX·디자인 시스템·React·폴더 구조·시험 환경·접근성·성능·보안의 이 repo 규칙(배럴 경계, 토큰 밖 색 금지, axe 태그 범위, 예산, FE-GATE 실행법 등)은 문서와 검사기에 흩어져 있고, 여러 분야에 걸친 일을 누가 보고 어떻게 합치는지 정한 곳이 없다. 고른 방법(소유자 결정 2026-11-11 「W3 설계대로」, 백엔드와 같은 모양): - 지식 스킬 fe-* 9개(.claude/skills/). paths를 걸어 그 분야 파일을 만질 때만 목록에 뜬다. 본문은 언제 쓰나 → 함정 → 실패는 이렇게 보인다 → 검증 → 이 repo에서 정한 것 순서. 초안은 이 repo 문서만 본 서브에이전트가 썼고 glob 75개가 모두 파일에 걸리는 것을 확인했다. - 서브에이전트 reviewer(렌즈 = brief의 스킬 경로). arch-reviewer는 fe-structure를, verify-app은 fe-qa를 미리 싣는다(QA 탐색 차터). - .claude/rules/expert-skills.md: 분야 파일을 고치기 전에 그 스킬의 「함정」·「검증」을 보게 하는 두 줄. - docs/work/experts.md: 명단·경로 → 렌즈·넘김 지도(백엔드 repo로 가는 API 계약 차이는 총괄을 거침)·충돌·비용. 루트 AGENTS.md·CLAUDE.md 한 줄씩, README 3절 4단계와 delegate.md 4.3절에 가리키는 말. - 시험: 에이전트 넷, Agent 도구 금지, 설명 합 1,200자, 미리 싣는 스킬, 지식 스킬의 paths·설명 300자·금지어·절 순서·150줄·glob이 파일에 걸림, 명단이 모든 전문가를 담음, 규칙 목록에 expert-skills. - 문서 PR #15와 겹치지 않게 docs/는 docs/work/만 건드렸다. 버린 대안: 분야마다 서브에이전트(QA·디자인·접근성 …). Anthropic 2026-10-22·2026-01-23·2026-04-07 글이 반대하고, 설명이 모든 세션에 든다. 위험: 플러그인 lead·new-expert·harness-eval은 claude-harness PR #3(0.3.0)이 병합돼야 받는다. fe-ux·fe-a11y의 paths는 템플릿에 기능 화면이 없어 src/presentation/**까지만 건다(기능이 생기면 넓힌다). 검증: scripts/verify.sh docs → rc=0, scripts/verify.sh hooks → 68건 통과. 새 시험은 조건을 깰 때마다 실패했다. desktop merge 단계는 이 커밋 뒤에 돈다. |
||
|
|
5757742ed0 |
docs(work): 하네스 문서를 새 문서 위치와 검사 범위에 맞춘다
문제: 하네스 PR #13이 더한 작업 매뉴얼·규칙은 이 브랜치가 바꾼 문서 체계의 옛 모습을 적는다. - 옛 경로: `docs/architecture/decisions/`, `docs/superpowers/`, 루트 `SPEC.md`, 목표 설계였던 `docs/testing/frontend-platform-testing-strategy.md` - 옛 검사 범위: 「docs/README.md 1절이 링크한 문서, 폴더 링크는 바로 아래 .md만」. 지금 verify:documentation은 살아 있는 문서 전부를 보고 언어· 문체·숫자·머리 블록도 본다 - 옛 docs/README.md 절(1절 묶음 / 2절 목표 설계 / 3절 작업 이력)과 README 절 이름(「Support scope」, 「Updating a copied project」) - #13의 template-contract-documents 시험은 README 지워도 되는 표를 `docs/superpowers/` 행으로 찾는데, 그 행은 이제 없다 고른 방법: 그 줄만 새 위치·새 절 이름·새 범위로 고친다(.claude/rules/docs.md, docs/work의 docs-writing·operate·research-design·reference 다섯, docs/problem-statement.md). 시험은 `docs/history/` 행으로 표를 찾는다. docs/work/evidence.md는 백엔드처럼 매뉴얼 규칙의 근거 기록이라 고치지 않고 `HISTORY_HOLDERS`에 넣어 참조·숫자 검사에서 뺀다. 위험: 하네스 문서의 다른 문장은 건드리지 않았다. 하네스 세션이 쓴 뜻을 바꾸지 않으려는 것이다. 검증: 문서 검사 여섯이 0건, `git grep -n -E 'docs/superpowers|architecture/decisions'`가 기록·CHANGELOG·출처 표시 밖에서 0건. |
||
|
|
7cd2d9e89b |
docs(work): ungated 검사가 도는 곳을 check:ci:gating으로 고친다
frontend-quality-gates / merge / static checks (pull_request) Successful in 2m23s
frontend-quality-gates / merge / browser tests (pull_request) Successful in 10m49s
frontend-quality-gates / FE-GATE-017 / diagram-review (pull_request) Skipped
frontend-quality-gates / external-vulnerability-provider (pull_request) Skipped
frontend-quality-gates / promote-verified-immutable-candidate (pull_request) Skipped
frontend-quality-gates / FE-GATE-024 / runbook-telemetry (pull_request) Skipped
frontend-quality-gates / FE-GATE-025 / runbook-release-rollback (pull_request) Skipped
frontend-quality-gates / FE-GATE-018 / field-web-vitals (pull_request) Skipped
frontend-quality-gates / main / checker self-tests (pull_request) Skipped
frontend-quality-gates / merge / tests (pull_request) Failing after 12m59s
frontend-quality-gates / FE-GATE-014 / config-compatibility (pull_request) Skipped
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-provenance-provider (pull_request) Skipped
frontend-quality-gates / deploy-promoted-release (pull_request) Skipped
frontend-quality-gates / FE-GATE-019 / hosting-header (pull_request) Skipped
frontend-quality-gates / FE-GATE-021 / runbook-boot-config (pull_request) Skipped
frontend-quality-gates / FE-GATE-022 / runbook-chunk-mismatch (pull_request) Skipped
frontend-quality-gates / FE-GATE-023 / runbook-api-degradation (pull_request) Skipped
main에 들어온 하네스 매뉴얼(docs/work/reference/gates.md, testing.md)이 「새 script·시험 파일이 게이트에 안 걸리면 check:ci가 실패한다」고 적는다. 이 PR의 f6b2b96c가 그 검사를 check:ci에서 떼어 main 단계 FE-GATE-029의 check:ci:gating으로 옮겼다. 두 줄과 생성기 주석 한 줄(merge_gate)을 고친다. 하네스 작업은 끝났고(PR #13 병합) 옮긴 명령을 가리키는 줄만 고쳤다. 검증(desktop): verify:documentation, test:unit. |
||
|
|
23df3203d8 |
docs(work): 정본이 정하는 검사 개수를 옮겨 적지 않는다
커밋 전 검사 8개, 통합 때 5개, 옛 게이트 11개처럼 config/ci/gates.json과 표가 정하는 개수를 문장에 옮겨 적었다. 표가 바뀌면 문장이 낡는다(문서 체계 검사의 숫자 복사 규칙). 개수를 빼고 표를 가리킨다. 검증: scripts/verify.sh docs rc=0. |
||
|
|
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건 통과. |
||
|
|
18ea5e939b |
docs(work): cold-read 시험에서 막힌 곳과 사실과 다른 곳을 고친다
이 대화를 모르는 서브에이전트에게 AGENTS.md부터 읽혀 두 일(새 기능 만들기, diff 리뷰)의 절차를 쓰게 했다. 막힌 곳 16, 사실과 다른 곳 5가 나왔다. 고친 것: - new-feature: 생성·기준선 다시 쓰기를 desktop에서 하고 --apply-back으로 받는다. FE-GATE-020은 제품 기능을 지우지 않으므로 그 기능의 제거 드릴을 따로 돌린다(사실과 달랐다). 생성 명령이 만드는 첫 context는 중간이다. 새 기능은 FE-GATE-026도 돌린다. 매뉴얼 예시 이름이 오면 묻는다. 초기 JS 기록의 파일을 적는다. - gates·improve·AGENTS: FE-GATE-013 결정 대기 동안의 merge 판정 문구, PR·diff 리뷰도 merge 단계 전부를 돌린다, diff 리뷰의 base·head 규칙과 ID 체계와 둘 곳, 라운드 세는 법, "빠른 게이트 8개"를 "검사 8개 (package script)"로. - review-criteria: 발견 한 개의 칸(가이드 36.3절 줄임)과 통제 M0~M4· 증거 E0~E4의 뜻을 옮긴다. 가이드 없이 판정할 수 있다는 문장을 맞춘다. - README·CLAUDE·decisions·rules/docs·skills: 최근 리뷰 README의 실제 절 이름, 사고 순서 흔적의 여섯 칸과 design-docs 위치, 보고 칸과 말투의 정본, `docs/work/README.md`를 가리키게, 리뷰 README 조치 절 예외, 스킬의 새 명령 모양. 고치지 않은 것: 세션에 주입된 옛 CLAUDE.md(시험 세션이 이 브랜치 전에 시작했다). 검증: scripts/verify.sh docs rc=0, scripts/verify.sh hooks 통과. |
||
|
|
8721be4780 |
docs(work): 리뷰 가이드의 repo 파일이 포인터라는 것과 드릴 실측 시간을 바로 적는다
reference/review-criteria.md가 docs/reviews/TEMPLATE-MATURITY-REVIEW- GUIDE.md를 정본의 사본이라 했지만, 그 파일은 2026-11-06부터 design-docs 정본 위치만 적은 포인터다. 드릴 시간 "20분 안팎"은 desktop 실측 822~1,245초(2026-11-06·08)로 바꾼다. 검증: scripts/verify.sh docs rc=0. |
||
|
|
3524d6b00b |
docs(work): 작업 매뉴얼 docs/work/를 두고 개선 매뉴얼 초안을 흡수한다
프론트에는 맡은 일별 작업 절차서가 없었다. 세션은 루트 CLAUDE.md의 리뷰 기준만 읽고 시작했고, 개선 작업 기준은 main에 들어가지 않은 초안 (브랜치 docs/improvement-manual의 docs/improvement 11개)에만 있었다. 백엔드 docs/work/와 같은 모양으로 README(크기·공통 단계·커밋·보고), playbook 여섯(new-feature, improve, research-design, docs-writing, operate, delegate, 모두 같은 9절 뼈대), reference 일곱(gates, review-criteria, structure, testing, performance, defect-patterns, decisions)과 evidence.md를 둔다. 초안의 장을 나눠 옮긴 표는 evidence.md 1.1절이다. SPEC.md의 공통 완료 기준 9개는 improve.md 5절로 옮겨, 문서 체계 정리가 SPEC.md를 이력으로 옮길 수 있게 한다. 진입 문서에는 지난 리뷰 ID를 쓰지 않고 내용과 날짜로 쓴다. ID는 evidence.md와 결정·결함 패턴 색인에만 둔다. 결함 패턴 번호 P-NN은 결정 번호 꼴과 겹쳐 영역 글자+번호(G·T·C·S·W·B)로 다시 매기고 옛 번호 대응을 evidence.md 4절에 남겼다. 열린 결정 대기는 2026-11-06 리뷰 기준으로 갱신했다. 버린 대안: 초안처럼 docs/improvement/ 장 번호 체계를 유지하기. 백엔드와 진입 경로·검사기가 갈라진다. 위험·한계: 이 커밋만으로는 문서 검사 범위 밖이다. docs/README.md가 이 폴더를 링크하는 커밋부터 verify:documentation이 경로를 본다. cold-read 시험은 하지 않았다. 검증: python3 scripts/check-work-docs.py rc=0(뒤 커밋에서 더함). Refs: design-docs harness/01-harness-design.md 13절, PR #6 |