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(5250ff95)의 PR #17·#18·#20·#21·#22를 받는다. 충돌 정리: - tests/setup.ts: main의 자식 프로세스 timeout 감시를 그대로 두고, Testing Library는 DOM이 있는 파일에만 불러오는 이 브랜치의 방식을 남긴다. - tests/system/ci-runner/ci-artifact-contract.test.ts: main이 같은 결함 (.claude 추적 파일 ENOENT)을 저장소 배치 등록부의 provider-fixture-skip 집합으로 이미 고쳤다. main 쪽을 받고 이 브랜치의f90ffb6c고침은 버린다. CHANGELOG의 그 행도 지운다. - 작업 매뉴얼·스킬(gates.md 3절, operate·improve·new-feature, evidence, desktop-gates·fe-testing 스킬): 기본은 시스템 컨테이너 경로, main의 D8 판정(사전 점검의 userns 제한 하나뿐이고 뒤 명령 모두 rc=0이면 merge 판정에서 뺀다)은 컨테이너를 띄울 수 없는 호스트에 쓴다. - 그 호스트에서 D8 절차를 그대로 돌릴 수 있게 scripts/verify.sh에 VERIFY_HOST_ENVIRONMENT=off(hostEnvironment 게이트를 이 호스트에서 바로 돈다)를 더하고 원격 실행에도 넘긴다. 시험 하나를 더한다. - decisions.md는 main 그대로(D8이 2.2절에 있어 이 브랜치의 O-21 행은 겹친다). 검증(노트북): python3 -m unittest discover -s scripts/tests 73개 통과, scripts/verify.sh docs rc=0. desktop merge 단계는 이 커밋에서 다시 돈다.
3.8 KiB
3.8 KiB
AGENTS.md — 프론트 템플릿의 정본
도메인 로직을 뺀 공통 기능을 갖춘 React + Vite 프론트 출발점이다(PRODUCT.md). 브라우저 SPA + 정적 호스팅 + Service Worker이고 SSR은 없다. 서비스는 복사해 기능 폴더를 채운다. 방향과 문제 정의는 docs/vision.md·docs/problem-statement.md(소유자가 채우는 빈 양식)다. 개발 compose는 짝 백엔드의 compose.yaml을 쓴다. 소비자 없는 코드와 빈 레지스트리는 다운스트림용 확장 지점이고, 갈라진 중복 복사본은 결함이다.
꼭 지킬 것 — 하나라도 어기면 동작해도 완료가 아니다
- adapter 그룹 밖에서는 배럴(
src/adapters/*/index.ts)로만 들어간다. 배럴이 공개 경계다. - adapter끼리 import하는 예외는
.dependency-cruiser.json의 kernel 셋(src/adapters/platform/폴더 전체,browser-file-storage/result.ts,cross-context-invalidation/index.ts)뿐이다. 새 파일 단위 예외를 만들지 않는다. 공용 로직은src/adapters/platform/이나src/contracts/에 둔다. - import 규칙의 정본은
.dependency-cruiser.json, 판정은check:architecture다. dependency-cruiser CLI는 TypeScript 7을 못 읽어 쓰지 않는다. - 게이트 기준(문턱, 예산, 기준선, skip·only)을 낮춰 통과시키지 않는다.
- 관련 검증 없이, 또는 돌리지 못한 이유를 밝히지 않고 완료를 말하지 않는다.
지도
- 계층·import 방향과 최상위
src/폴더의 역할은docs/architecture/layers.md다. - 새 기능은
corepack pnpm create:feature <id>로 만들고docs/manual/순서로 채운다. - 게이트 ID·단계·명령의 정본은
config/ci/gates.json이다(설명docs/operations/ci-quality-gates.md). - adapter 파일을 더하거나 옮기면
docs/reviews/adapters/INVENTORY.md를 같은 커밋에서 고친다. - 지역 규칙은 작업 파일과 가장 가까운
src/<계층>/AGENTS.md다. 폴더를 가로지르는 규칙(테스트·문서·게이트 기준)은.claude/rules/, 문서 위치 규칙은docs/README.md다.
맡은 일
먼저 docs/work/README.md, 그다음 playbook 하나를 끝까지 읽는다(모두 docs/work/): 새 기능 new-feature.md · 리뷰·수정·리팩터링·성능 improve.md · 대안 비교와 소유자 결정 research-design.md · 문서 docs-writing.md · 게이트·릴리스·파생 프로젝트 operate.md · 일 나누기 delegate.md. brief가 있으면 brief의 범위·크기·완료 기준이 먼저다.
검증
- 진입점은
scripts/verify.sh <단계>다. 단계는config/ci/gates.json의 stage id(merge등), 게이트 하나는scripts/verify.sh gate FE-GATE-005(안에서corepack pnpm ci:gate FE-GATE-005). pnpm 단계는 desktop으로 옮겨 돈다. - "merge 가능"은 merge 단계 게이트 전부를
CI=true로 돌려 통과한 것이다. 골라 돌린 결과로 말하지 않는다. FE-GATE-013은scripts/run-in-system-container.sh안에서 돈다(docs/work/reference/gates.md3절). - 문서·지침을 고쳤으면
scripts/verify.sh docs(노트북).
일하는 방식
- 커밋·push는 brief가 허용한 것만 자기 브랜치에 한다. main 병합·force push·PR 병합은 소유자가 한다.
- 요청 범위 밖의 큰 리팩터링, 사용자 변경 되돌리기, 요청 없는 파괴적 git 명령을 하지 않는다.
- 파일을 바꾸는 위임은 하위 세션에, 결과만 받는 일(검색·구조 리뷰·실행 검증)은 서브에이전트에 맡긴다. pnpm·게이트·브라우저는 누가 돌려도 desktop에서다(
docs/work/delegate.md). - 여러 분야에 걸친 일은 리드(메인 세션)가 분야 지식을 골라 새 눈 리뷰어에게 맡기고 합친다. 명단·경로표·넘김·충돌 규칙은
docs/work/experts.md다.