docs(redteam): 수정 커밋 전 포맷 게이트 단계를 더한다 #6

Merged
donghyeon.kang merged 1 commits from claude/redteam-spotless-step into main 2026-11-11 17:43:22 +00:00
Owner

무엇을, 왜

red team 수정 절차(skills/redteam SKILL.md, CAMPAIGN.md)에 "커밋 전 바뀐 파일에 대상 repo 포맷터를 돌린다" 단계가 없었다. 그래서 백엔드 템플릿 보안 수정 PR에서 바뀐 모듈 시험만 돌리고 push했다가, runner pr / gradle의 :app-bootstrap:spotlessJavaCheck에서 깨졌다. 같은 실수가 반복되지 않게 절차에 못 박는다.

고른 방법과 버린 대안

  • SKILL.md §6(고침과 재실행)과 CAMPAIGN.md §4(발견 처리)에 각각 한 줄: 자바 템플릿은 ./gradlew spotlessApply 뒤 spotlessCheck.
  • 두 곳 모두에 넣은 이유: 스킬만 따르는 세션과 CAMPAIGN을 따르는 세션이 각각 다른 문서를 읽는다. 한 곳만 고치면 다른 경로가 비는 채로 남는다.
  • 버린 대안: 훅으로 강제(커밋 때 spotless 자동 실행) — 대상 repo마다 포맷터가 달라(자바·JS·…) 하네스 훅이 대상 빌드를 알 수 없고, red team은 opt-in·무훅 원칙이라 넣지 않았다.

위험과 영향

문서와 plugin.json version(0.1.0 → 0.1.1)만 바뀐다. 훅·스크립트·서브에이전트 동작 변화 없음. 버전을 올린 이유는 스킬 지시가 바뀌었고 받는 쪽은 version이 바뀌어야 갱신되기 때문(AGENTS.md 꼭 지킬 것 §2).

검증

scripts/check.sh 통과: harness 플러그인 시험 24(expected xfail 1)·redteam 18·템플릿 11, marketplace/plugin manifest validate --strict 모두 통과.

리뷰어가 볼 곳

  • plugins/redteam/skills/redteam/SKILL.md §6
  • plugins/redteam/CAMPAIGN.md §4
  • plugins/redteam/.claude-plugin/plugin.json (version)

관련

W4 red team 백엔드 템플릿 PR #12(clean-architecture-backend-template)의 spotlessCheck 실패가 계기. 이 절차 한 줄이 그 재발을 막는다.

## 무엇을, 왜 red team 수정 절차(skills/redteam SKILL.md, CAMPAIGN.md)에 "커밋 전 바뀐 파일에 대상 repo 포맷터를 돌린다" 단계가 없었다. 그래서 백엔드 템플릿 보안 수정 PR에서 바뀐 모듈 시험만 돌리고 push했다가, runner `pr / gradle`의 `:app-bootstrap:spotlessJavaCheck`에서 깨졌다. 같은 실수가 반복되지 않게 절차에 못 박는다. ## 고른 방법과 버린 대안 - SKILL.md §6(고침과 재실행)과 CAMPAIGN.md §4(발견 처리)에 각각 한 줄: 자바 템플릿은 `./gradlew spotlessApply` 뒤 `spotlessCheck`. - 두 곳 모두에 넣은 이유: 스킬만 따르는 세션과 CAMPAIGN을 따르는 세션이 각각 다른 문서를 읽는다. 한 곳만 고치면 다른 경로가 비는 채로 남는다. - 버린 대안: 훅으로 강제(커밋 때 spotless 자동 실행) — 대상 repo마다 포맷터가 달라(자바·JS·…) 하네스 훅이 대상 빌드를 알 수 없고, red team은 opt-in·무훅 원칙이라 넣지 않았다. ## 위험과 영향 문서와 `plugin.json` version(0.1.0 → 0.1.1)만 바뀐다. 훅·스크립트·서브에이전트 동작 변화 없음. 버전을 올린 이유는 스킬 지시가 바뀌었고 받는 쪽은 version이 바뀌어야 갱신되기 때문(AGENTS.md 꼭 지킬 것 §2). ## 검증 `scripts/check.sh` 통과: harness 플러그인 시험 24(expected xfail 1)·redteam 18·템플릿 11, marketplace/plugin manifest `validate --strict` 모두 통과. ## 리뷰어가 볼 곳 - plugins/redteam/skills/redteam/SKILL.md §6 - plugins/redteam/CAMPAIGN.md §4 - plugins/redteam/.claude-plugin/plugin.json (version) ## 관련 W4 red team 백엔드 템플릿 PR #12(clean-architecture-backend-template)의 spotlessCheck 실패가 계기. 이 절차 한 줄이 그 재발을 막는다.
donghyeon.kang added 1 commit 2026-11-11 17:37:45 +00:00
red team 수정 절차에 "커밋 전 바뀐 파일에 대상 repo 포맷터를 돌린다"
단계가 없었다. 그래서 백엔드 템플릿 수정 PR에서 모듈 시험만 돌리고
push했다가 runner pr / gradle의 :app-bootstrap:spotlessJavaCheck에서
깨졌다. 같은 실수가 반복되지 않게 절차에 못 박는다.

skills/redteam SKILL.md §6(고침과 재실행)과 CAMPAIGN.md §4(발견 처리)에
각각 한 줄을 더한다: 자바 템플릿은 ./gradlew spotlessApply 뒤
spotlessCheck. 스킬 지시가 바뀌므로 plugin.json version 0.1.0 → 0.1.1
(받는 쪽은 버전이 바뀌어야 갱신된다).

위험·한계: 문서·버전만 바뀐다. 훅·스크립트 동작 변화 없음.

검증: scripts/check.sh 통과(harness·redteam·template 시험, manifest validate).
donghyeon.kang merged commit 3da02e571f into main 2026-11-11 17:43:22 +00:00
Sign in to join this conversation.
No Reviewers
No labels
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: donghyeon.kang/claude-harness#6