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).
redteam 플러그인 — 두 템플릿을 공격하는 red team 장치
승인된 보안 시험으로 내가 통제하는 템플릿·서비스를 공격해 취약점을 찾아 고친다. 역할별 서브에이전트와 발동 스킬, 핀 고정 오픈소스 도구 실행 래퍼, 하나의 발견 수집 도구로 이뤄진다.
왜 훅이 없나
이 플러그인은 훅을 두지 않는다. 보안 공격은 모든 세션에서 자동으로 돌 일이 아니고(출력·컨텍스트 오염), 교전할 때 스킬·서브에이전트로 요청해서 돌린다. harness 플러그인(위험 명령 차단·장부)과 역할이 다르다.
구성
agents/— 역할 서브에이전트 6:redteam-reconredteam-authzredteam-inputredteam-depsredteam-configredteam-frontend.skills/redteam/— 교전 오케스트레이션 스킬(범위 확인 → 정찰 → 공격 → 수집 → 보고 → 고침 → 재실행).scripts/redteam-scan.sh— 핀 고정 도구 실행 래퍼(desktop에서). 모드:secrets sast deps config dast-baseline dast-api nuclei pin.scripts/tools.lock— 도구 이미지 버전+digest 핀.scripts/finding.py— 발견 정규화·검사·정렬·보고(JSON Lines).validatereportsummarymerge.tests/— finding.py 로직과 tools.lock·스크립트 형식 시험(표준 라이브러리만).
쓰는 법
/redteam 스킬을 부르거나, 역할 서브에이전트를 Agent로 띄운다. 자세한 흐름·명령은 skills/redteam/SKILL.md.
도구와 라이선스
| 도구 | 라이선스 | 비고 |
|---|---|---|
| gitleaks | MIT | 비밀 값 |
| semgrep CE | 엔진 LGPL-2.1 | SAST(공식 이미지, 룰은 런타임·--metrics=off로 코드 안 보냄) |
| trivy | Apache-2.0 | 의존성/이미지 — 기존 게이트와 공유 |
| osv-scanner | Apache-2.0 | lockfile 교차검증 |
| checkov | Apache-2.0 | IaC·compose·Dockerfile |
| hadolint | GPL-3.0 | Dockerfile(실행만) |
| OWASP ZAP | Apache-2.0 | DAST baseline·api |
| nuclei | MIT | 노출 템플릿(로컬 대상만) |
| schemathesis | MIT | OpenAPI 퍼징 |
| trufflehog | AGPL-3.0 | 심층 비밀 값(실행만, 배포 안 함) |
| claude-code-security-review(참고) | MIT | AI diff 리뷰. 신뢰 코드에만 |
공개 repo 규칙: 룰셋·CVE 데이터를 vendoring하지 않는다. 도구는 런타임에 받고 룰도 그때 받는다. SAST는 semgrep CE(엔진 LGPL): 레지스트리 룰은 Semgrep Rules License(내부 실행은 허용, 재배포 금지)라 커밋하지 않고 런타임에만 받으며, --metrics=off로 프로젝트 코드를 밖에 보내지 않는다. opengrep은 공식 컨테이너 이미지가 없어 뺐다. CodeQL은 라이선스(OSS 전용 조건)로 기본 제외.
범위·안전
- 공격은 내가 띄운 인스턴스와 의존 컨테이너뿐. 운영·남의 서비스·외부는 제외. DoS 금지.
- 무거운 실행은 desktop에서
flock·setsid로, 끝나면 이미지·산출물을 지운다.