Files
clean-architecture-frontend…/config/repository-layout.json
T
donghyeon.kang 16eb200fd1 chore(layout): 하네스가 더할 .gitattributes를 루트 등록부에 미리 적는다
하네스 PR(#13)이 루트에 `.gitattributes`(작업 장부 파일의 병합 규칙)를
더한다. 이 PR이 먼저 들어가고 그 PR이 나중에 들어가면 등록부에 없는
루트 항목이 생겨 `tests/unit/repository-layout.test.ts`(R1)가 실패한다.
`AGENTS.md`·`.claude`처럼 optional 항목으로 미리 적는다. 없으면 고르는
집합이 없어 다른 검사에 영향이 없다.

검증(desktop): test:unit, check:ci, verify:documentation.
2026-11-08 22:51:59 +09:00

328 lines
11 KiB
JSON

{
"schemaVersion": 1,
"kinds": {
"source": "코드와 시험. 계층과 도구가 읽는다",
"tool-convention": "도구가 루트에서 이 이름으로 찾는 설정 파일·폴더",
"gate-input": "게이트와 런타임이 읽는 기준 데이터",
"document": "사람이 읽는 문서",
"history": "끝난 라운드의 기록. 이력 폴더로 옮길 대상이다(R10)",
"output": "실행 출력. 추적하는 것은 `.gitkeep`뿐이다(R3)"
},
"sets": {
"fixture-copy": "제거·생성 drill과 사본 시험이 복사하는 것(scripts/lib/removal-fixture.ts)",
"fixture-documents": "기능을 더하거나 지우는 drill이 문서까지 맞는지 보려고 더 복사하는 문서(scripts/lib/removal-fixture.ts)",
"secret-scan": "비밀값 검사와 공급망 목록의 범위. config/security/secret-scan-policy.json의 trackedRoots가 이 집합과 같아야 한다",
"history-free": "이력 문서를 읽으면 안 되는 코드(tests/unit/deletable-history-documents.test.ts)",
"scale-source": "규모 증거에서 '지금 코드'를 정하는 입력(scripts/verify-extreme-scale.ts)",
"vite-build": "vite build가 읽는 입력(scripts/lib/vite-build-inputs.ts)",
"typescript-only": "JS 파일을 두면 안 되는 곳(scripts/check-architecture.ts)"
},
"entries": [
{
"path": ".claude",
"kind": "tool-convention",
"role": "Claude Code 설정·규칙·스킬. 하네스 작업(fe-c)이 더한다",
"readBy": "Claude Code",
"optional": true
},
{
"path": ".dependency-cruiser.json",
"kind": "tool-convention",
"role": "import 규칙과 kernel 예외의 정본",
"readBy": "scripts/check-architecture.ts (FE-GATE-010)",
"sets": ["fixture-copy", "secret-scan", "history-free", "scale-source"]
},
{
"path": ".env.example",
"kind": "tool-convention",
"role": "빌드 시점 공개 변수의 견본",
"readBy": "Vite(VITE_*), 사람"
},
{
"path": ".gitattributes",
"kind": "tool-convention",
"role": "git 병합 규칙. 하네스 작업(fe-c)이 더한다",
"readBy": "git",
"optional": true
},
{
"path": ".gitea",
"kind": "tool-convention",
"role": "Gitea Actions workflow. config/ci/gates.json에서 생성한다",
"readBy": "Gitea Actions, scripts/generate-ci-workflow.ts, check:ci (FE-GATE-010)",
"sets": ["fixture-copy", "history-free"],
"setPaths": {
"secret-scan": [".gitea/workflows/quality-gates.yml"]
}
},
{
"path": ".gitignore",
"kind": "tool-convention",
"role": "추적하지 않을 파일",
"readBy": "git",
"sets": ["fixture-copy"]
},
{
"path": ".npmrc",
"kind": "tool-convention",
"role": "pnpm 설정",
"readBy": "pnpm",
"sets": ["fixture-copy", "secret-scan"]
},
{
"path": ".nvmrc",
"kind": "tool-convention",
"role": "Node 버전",
"readBy": "nvm, CI",
"sets": ["fixture-copy", "secret-scan"]
},
{
"path": ".storybook",
"kind": "tool-convention",
"role": "Storybook 설정. 갤러리와 visual 골든의 대상",
"readBy": "storybook, build:storybook (FE-GATE-011)",
"sets": ["fixture-copy", "secret-scan", "scale-source", "typescript-only"]
},
{
"path": "AGENTS.md",
"kind": "tool-convention",
"role": "에이전트 진입 문서. 하네스 작업(fe-c)이 더한다",
"readBy": "코딩 에이전트",
"optional": true
},
{
"path": "CHANGELOG.md",
"kind": "document",
"role": "버전별 변경과 다운스트림이 할 일",
"readBy": "tests/unit/changelog-review-ids.test.ts, 사람",
"sets": ["fixture-documents"]
},
{
"path": "CLAUDE.md",
"kind": "tool-convention",
"role": "Claude Code 진입 문서",
"readBy": "Claude Code"
},
{
"path": "PRODUCT.md",
"kind": "tool-convention",
"role": "제품 맥락. 디자인 도구가 루트에서 찾는다",
"readBy": "디자인 스킬"
},
{
"path": "README.md",
"kind": "document",
"role": "시작·설정·검증",
"readBy": "verify:documentation (FE-GATE-017), 사람",
"sets": ["fixture-documents"]
},
{
"path": "SPEC.md",
"kind": "history",
"role": "2026-09-25 라운드 요구사항. 문서 체계 작업(fe-b)이 이력 폴더로 옮기고 이 항목을 뺀다",
"readBy": "사람"
},
{
"path": "artifacts",
"kind": "output",
"role": "게이트와 시험의 실행 출력",
"readBy": "scripts/run-ci-gate.ts, CI 업로드"
},
{
"path": "config",
"kind": "gate-input",
"role": "게이트·런타임·보안·성능의 기준 데이터와 JSON Schema(config/schemas)",
"readBy": "scripts/, tests/, src/",
"sets": ["fixture-copy", "secret-scan", "history-free", "scale-source"]
},
{
"path": "docs",
"kind": "document",
"role": "매뉴얼·설계·운영 문서와 수동 접근성 검토 기록",
"readBy": "verify:documentation (FE-GATE-017), review:a11y-manual (FE-GATE-009·028)",
"sets": ["fixture-documents"],
"setPaths": {
"fixture-copy": ["docs/accessibility/route-reviews"]
}
},
{
"path": "eslint.config.ts",
"kind": "tool-convention",
"role": "lint 규칙",
"readBy": "eslint (FE-GATE-002)",
"sets": ["fixture-copy", "secret-scan", "history-free", "scale-source"]
},
{
"path": "index.html",
"kind": "tool-convention",
"role": "Vite 진입 HTML",
"readBy": "Vite",
"sets": ["fixture-copy", "secret-scan", "vite-build"]
},
{
"path": "package.json",
"kind": "tool-convention",
"role": "의존성과 package script",
"readBy": "pnpm, 모든 게이트",
"sets": ["fixture-copy", "secret-scan", "history-free", "scale-source", "vite-build"]
},
{
"path": "playwright.capabilities.config.ts",
"kind": "tool-convention",
"role": "브라우저 capability 시험 설정",
"readBy": "test:browser-capabilities (FE-GATE-008)",
"sets": ["fixture-copy", "secret-scan"]
},
{
"path": "playwright.config.ts",
"kind": "tool-convention",
"role": "e2e 설정(빌드 미리보기)",
"readBy": "test:e2e (FE-GATE-008)",
"sets": ["fixture-copy", "secret-scan", "history-free"]
},
{
"path": "playwright.dev.config.ts",
"kind": "tool-convention",
"role": "dev 서버 대상 e2e 설정",
"readBy": "test:e2e:dev",
"sets": ["fixture-copy", "secret-scan"]
},
{
"path": "playwright.storybook.config.ts",
"kind": "tool-convention",
"role": "Storybook 정적 빌드 시험 설정",
"readBy": "test:storybook (FE-GATE-008)",
"sets": ["fixture-copy", "secret-scan"]
},
{
"path": "playwright.visual.config.ts",
"kind": "tool-convention",
"role": "visual 골든 설정",
"readBy": "test:visual (FE-GATE-008)",
"sets": ["fixture-copy", "secret-scan"]
},
{
"path": "pnpm-lock.yaml",
"kind": "tool-convention",
"role": "잠금 파일",
"readBy": "pnpm, 공급망 생성",
"sets": ["fixture-copy", "secret-scan", "scale-source"]
},
{
"path": "pnpm-workspace.yaml",
"kind": "tool-convention",
"role": "pnpm 11 설정",
"readBy": "pnpm, scripts/lib/package-script-graph.ts",
"sets": ["fixture-copy", "secret-scan"]
},
{
"path": "public",
"kind": "tool-convention",
"role": "개발 서버가 서빙하는 런타임 문서",
"readBy": "Vite",
"sets": ["fixture-copy", "secret-scan", "vite-build"]
},
{
"path": "recipes",
"kind": "source",
"role": "선택 기능 설치 원본. 기본 빌드에 들어가지 않는다",
"readBy": "tsconfig.test.json, test:recipes (FE-GATE-007), check:optional-recipes (FE-GATE-012)",
"optional": true,
"sets": ["fixture-copy", "secret-scan", "history-free", "scale-source", "typescript-only"]
},
{
"path": "renovate.json",
"kind": "tool-convention",
"role": "보안 업데이트 봇 설정",
"readBy": "Renovate"
},
{
"path": "scripts",
"kind": "source",
"role": "게이트·생성기·drill 스크립트",
"readBy": "package.json scripts",
"sets": ["fixture-copy", "secret-scan", "history-free", "scale-source", "typescript-only"],
"setPaths": {
"vite-build": ["scripts/lib/run-isolation.ts", "scripts/lib/vite-module-inventory.ts"]
}
},
{
"path": "src",
"kind": "source",
"role": "앱 계층",
"readBy": "빌드와 모든 게이트",
"sets": ["fixture-copy", "secret-scan", "history-free", "scale-source", "vite-build", "typescript-only"]
},
{
"path": "tests",
"kind": "source",
"role": "시험과 fixture",
"readBy": "test:* scripts, playwright 설정",
"sets": ["fixture-copy", "secret-scan", "history-free", "scale-source", "typescript-only"]
},
{
"path": "tsconfig.app.json",
"kind": "tool-convention",
"role": "src 타입 검사(DOM, Node 타입 없음)",
"readBy": "check:types:app (FE-GATE-003), Vite",
"sets": ["fixture-copy", "secret-scan", "scale-source", "vite-build"]
},
{
"path": "tsconfig.base.json",
"kind": "tool-convention",
"role": "공통 컴파일 옵션",
"readBy": "다른 tsconfig의 extends",
"sets": ["fixture-copy", "secret-scan", "vite-build"]
},
{
"path": "tsconfig.json",
"kind": "tool-convention",
"role": "편집기용 solution tsconfig(files 없음, references만)",
"readBy": "편집기",
"sets": ["fixture-copy", "secret-scan", "scale-source"]
},
{
"path": "tsconfig.node.json",
"kind": "tool-convention",
"role": "scripts·설정 파일 타입 검사(NodeNext)",
"readBy": "check:types:node (FE-GATE-003)",
"sets": ["fixture-copy", "secret-scan", "scale-source"]
},
{
"path": "tsconfig.service-worker.json",
"kind": "tool-convention",
"role": "Service Worker 타입 검사(WebWorker, DOM 없음)",
"readBy": "check:types:service-worker (FE-GATE-003)",
"sets": ["fixture-copy", "secret-scan"]
},
{
"path": "tsconfig.test.json",
"kind": "tool-convention",
"role": "tests·recipes·시험 설정 파일 타입 검사",
"readBy": "check:types:test (FE-GATE-003)",
"sets": ["fixture-copy", "secret-scan", "scale-source"]
},
{
"path": "vite.config.ts",
"kind": "tool-convention",
"role": "앱 빌드",
"readBy": "Vite",
"sets": ["fixture-copy", "secret-scan", "history-free", "scale-source", "vite-build"]
},
{
"path": "vite.service-worker.config.ts",
"kind": "tool-convention",
"role": "Service Worker 빌드",
"readBy": "scripts/build-frontend.ts",
"sets": ["fixture-copy", "secret-scan"]
},
{
"path": "vitest.config.ts",
"kind": "tool-convention",
"role": "단위·컴포넌트 시험 설정",
"readBy": "scripts/run-vitest.ts",
"sets": ["fixture-copy", "secret-scan", "history-free", "scale-source"]
}
]
}