문제: 소유자 규칙은 "세션 안의 하위 에이전트(Agent 도구)를 쓰지 않고, 일을
나눌 때는 사람이 열어 보고 멈출 수 있는 별도 세션에 맡긴다"이다. 그런데 이
규칙은 문서와 메모리에만 있었고, AGENTS.md 「Superpowers Workflow」는 오히려
subagent-driven-development·dispatching-parallel-agents를 쓰라고 안내했다.
하위 세션 시작이 막혔을 때 Agent로 우회한 일도 있었다.
고른 방법: 이 repo의 .claude/settings.json에 permissions.deny "Agent"를 둔다
(2026-11-06 소유자 결정 D5: 사용자 설정이 아니라 두 템플릿 repo의 프로젝트
설정). Claude Code 권한 문서대로 맨 도구 이름 deny는 그 도구를 세션에서
없애고, 한 설정 단계의 deny는 다른 단계의 allow로 풀리지 않는다.
.gitignore는 .claude/ 전체 무시를 .claude/* + !.claude/settings.json으로
바꿔 이 파일 하나만 추적한다. settings.local.json, worktree, 노트는 계속
무시한다. AGENTS.md의 두 스킬 문장은 "이 저장소에서는 쓰지 않는다"로 바꿨다.
버린 대안: 사용자 설정(~/.claude/settings.json)에 두기는 다른 프로젝트에서
Agent를 쓸 여지를 없앤다. PreToolUse 훅은 deny 규칙 하나로 충분한 일에
스크립트를 더한다.
위험·한계: 추적 파일이라 이 템플릿을 받는 파생 서비스(tech-log-backend 등)에도
넘어간다. 파생 서비스가 Agent를 쓰려면 그 파일을 자기 repo에서 고쳐야 한다.
deny가 실제로 막는지는 Agent를 불러 보는 방식으로 시험하지 않았다(막히지
않으면 하위 에이전트가 떠서 규칙을 어긴다). 대신 공식 권한 문서의 문법과
우선순위를 확인했다.
검증
- jq -e '.permissions.deny | index("Agent")' .claude/settings.json: rc=0
- git check-ignore: .claude/settings.json 추적 가능, settings.local.json·
.claude/worktrees/·.claude/review-followup/ 무시
21 lines
691 B
Plaintext
21 lines
691 B
Plaintext
.vscode/
|
|
src/**/bin/
|
|
# Local Claude Code state (worktrees, settings.local.json, notes) stays out. The shared project
|
|
# settings file is committed: it denies the Agent tool for everyone (AGENTS.md 「Superpowers Workflow」).
|
|
.claude/*
|
|
!.claude/settings.json
|
|
|
|
# Operator input, not a build input. The examples beside it are the tracked contract;
|
|
# verifyEnvKeys reads the registry, the profile YAMLs and .env.example, never a real one.
|
|
src/.env*
|
|
!src/.env.example
|
|
!src/.env.local.example
|
|
|
|
# Written per run by the runtime-smoke wrapper; never committed.
|
|
src/.env.lane
|
|
|
|
# Local tool output (graphify knowledge graph, Playwright MCP snapshots).
|
|
graphify-out/
|
|
src/graphify-out/
|
|
.playwright-mcp/
|