Files
clean-architecture-frontend…/.gitignore
T
DongHyeonka 9f8596280c feat(claude): 경로별 규칙·스킬·결과만 돌려주는 서브에이전트를 둔다
Claude Code 세션이 테스트·문서·adapter·게이트 기준·기능 폴더를 고칠 때
읽을 규칙이 루트 한 파일에 섞여 있었고, desktop 실행과 새 기능 절차를
부르는 스킬, 결과만 받는 리뷰어 정의가 없었다.

- .claude/rules/: tests, docs, adapters, gates-and-budgets, features.
  paths로 그 파일을 열 때만 읽힌다.
- .claude/skills/: desktop-gates(scripts/verify.sh로 desktop에서 돌리기),
  new-feature(create:feature부터). 소유자 결정대로 모델이 부르고, 설명에
  발동 조건을 문단으로 쓴다. 본문은 정본 playbook을 가리킨다.
- .claude/agents/: arch-reviewer(경계 규칙), verify-app(desktop에서
  빌드·브라우저 확인), code-simplifier. 쓰기 도구가 없다.
- .claude/settings.json: 하네스 플러그인 harness@claude-harness를 켜고
  실제 .env 읽기·쓰기를 막는다. Agent deny는 두지 않는다.
- .gitignore: .claude/는 이 넷만 추적하고 worktree·훅 상태·
  settings.local.json은 무시한다.

버린 대안: Agent deny 유지(소유자 결정 2026-11-07 Q5가 풀었다), 스킬을
사용자 호출 전용으로(Q9가 모델 호출을 골랐다).

위험·한계: 규칙 paths는 지금 있는 파일로 시험하지만 Claude Code가 실제로
읽는지는 이 세션에서 보지 않았다(설정은 세션 시작에 읽힌다).

검증: python3 -m unittest scripts/tests/test_claude_setup.py 통과
(서브에이전트 쓰기 도구 없음, 스킬 설명 길이와 발동 조건, 규칙 paths가
가리키는 파일 있음).

Refs: design-docs harness/01-harness-design.md 13절 Q3·Q5·Q9
2026-11-08 17:27:39 +09:00

48 lines
1.5 KiB
Plaintext

node_modules/
dist/
.vite/
.generated/
.tmp/
playwright-report/
test-results/
coverage/
!tests/fixtures/coverage/
!tests/fixtures/coverage/below-threshold.json
# artifacts/ is run output and is ignored as a whole. Ignoring it by extension
# let screenshots and a coverage report in (0929/14-01) and step logs until
# they got their own rule (1103/12-08).
# Only the folder markers and the manual a11y reviews, which people write and
# the a11y gates read (config/ci/gates.json), are tracked;
# tests/unit/tracked-artifacts.test.ts keeps it so. Git cannot re-include a
# file under an ignored folder, so each folder on the way is re-included and
# its contents ignored again.
artifacts/*
!artifacts/runbooks/
artifacts/runbooks/*
!artifacts/runbooks/.gitkeep
!artifacts/tests/
artifacts/tests/*
!artifacts/tests/.gitkeep
!artifacts/tests/a11y-manual/
artifacts/tests/a11y-manual/*
!artifacts/tests/a11y-manual/*.md
# Local environment overrides. `.env.example` is the tracked template; every
# other `.env*` file is a developer's own machine and never enters the repo.
.env
.env.*
!.env.example
# graphify knowledge-graph output (local analysis, not part of the product).
graphify-out/
# Claude Code: the project settings, path rules, skills and subagents are the
# template's (AGENTS.md, scripts/hooks/README.md). Session worktrees, the hook
# state and a developer's settings.local.json stay out.
.claude/*
!.claude/settings.json
!.claude/rules/
!.claude/agents/
!.claude/skills/
__pycache__/