Lesson (강의 단원)lectureverifiedFri May 01

단원 9 — Superpowers 프레임워크 (시각적 컴패니언·서브에이전트·2단계 리뷰)

별칭: Superpowers 단원 · 하네스 구현체 · 3대 개념

#hrn#superpowers#visual-companion#subagent#two-stage-review#tdd#git-worktree

요약

본 단원은 Superpowers 라는 SDD 기반 지능형 스킬 프레임워크 를 소개한다. 이 프레임워크는 concept/harness-engineering 의 가장 대표적인 구현체 로, 개발자가 매번 수동으로 박아야 했던 하네스 패턴을 재사용 가능한 스킬 패키지로 묶어 제공한다. Superpowers 의 핵심은 3 가지 개념으로 구성된다 — 첫째 term/visual-companion (시각적 컴패니언) 은 작업 진행 상황을 AI 가 자체적으로 시각화 하는 기법이고, 둘째 concept/subagent-driven-development (서브에이전트 주도 개발) 은 복잡한 작업을 여러 서브에이전트로 분해해 병렬 실행 하는 패턴이며, 셋째 concept/two-stage-review (2 단계 리뷰) 는 AI 가 자기 코드를 다른 AI 의 시각으로 다시 검토 하는 GAN 형 자기 검열 메커니즘이다. 이 셋이 결합되어 기획 → 계획 → 실행 의 3 단계 파이프라인을 시스템 레벨에서 강제 — 즉 사용자가 매번 명령하지 않아도 자동으로 강제되도록 만든다.

상세

프레임워크 정의

컨텍스트 오염 과 요구사항 표류 를 시스템적으로 차단. Design → Planning → Execution 3단계 파이프라인을 시스템 레벨 에서 강제하는 하네스.

3대 핵심 개념

1. term/visual-companion — 시각적 컴패니언

코드 작성 전, 브라우저에 목업·다이어그램·아키텍처 렌더링 → 사용자 승인
동작:
- 에이전트 → screen_dir 에 HTML 프래그먼트 기록
- 로컬 서버가 CSS 테마와 결합해 브라우저 렌더링
- 사용자 클릭/선택 → state_dir/events 로깅 → 다음 프롬프트에 역주입
효과: 요구사항 표류 차단

2. concept/subagent-driven-development — 서브에이전트 주도 개발

문제: 단일 세션 장시간 → 컨텍스트 오염 필연
해결: 메인 에이전트 = 오케스트레이터. 마이크로 태스크마다 신선한 서브 에이전트 파견
서브 에이전트는 이전 대화 없이 최소 명세서만 받아 실행
dispatching-parallel-agents 스킬로 병렬 실행

3. concept/two-stage-review — 2단계 리뷰 (GAN 영감)

1단계: 스펙 준수 리뷰어 — 구현 코드 vs 초기 계획 대조. 누락·의도치 않은 추가 검출
2단계: 코드 품질 리뷰어 — 아키텍처·성능·안티패턴 심사
Critical 발견 시 즉시 중단 → 재작업 → 재심사

term/iron-law-tdd

NO PRODUCTION CODE WITHOUT A FAILING TEST FIRST

에이전트가 테스트 없이 프로덕션 코드 작성 → 시스템 훅이 즉각 삭제
term/red-green-refactor 사이클 강제

다층 아키텍처 3 레이어

레이어	역할
L1. 실행 격리 (term/git-worktree)	작업마다 격리 브랜치, 메인 영향 0
L2. 시각적 검증	로컬 HTTP 서버 + 브라우저 승인 강제
L3. TDD 샌드박스	단위 테스트 + 정적 분석 + 시스템 훅

5단계 워크플로우 플레이북 (강의 시연용)

1. brainstorming → 요구사항 명세서 + 시각적 컴패니언
2. using-git-worktrees → 격리 브랜치
3. writing-plans → 5분 단위 마이크로 태스크
4. subagent-driven-development → 태스크당 새 서브에이전트 + TDD
5. requesting-code-review → 보안·스펙·품질 이중 검증

방법론

강의 진행 시퀀스 (8분):

★ 표어 회귀 멘트 (15초): "하네스가 왜 작동하는가? — 설계가 없는 AI 는 폭주하고, 하네스가 있는 AI 는 자기 검증을 한다. 이게 설계 없이는 코딩 없다 의 구현체 입니다."
Superpowers 정의 (1분): SDD 기반 하네스 프레임워크.
3대 개념 (4분): 시각적 컴패니언 → 서브에이전트 → 2단계 리뷰 순서.
TDD 철칙 (1분): 테스트 없이 코드 없다. 시스템 훅의 즉각 삭제 가 핵심.
3 레이어 아키텍처 (1분): 격리 + 시각 + TDD.
5단계 플레이북 (1분): 05 DEM 사전 노출.

주의사항

"Superpowers" 명칭의 부담: 과장된 마케팅 단어 처럼 들릴 수 있음 → 플러그인 명칭 임을 명시.
GAN 비유의 학술 부담: GAN 을 모르는 청중에게 적대적 검증 정도로 부연.
TDD 철칙의 강도: 코드 즉각 삭제 가 너무 강해 보일 수 있음 → 철칙 수준의 규율 임을 강조.
5단계 플레이북의 깊이: 본 단원에서는 목록만 노출. 실제 시연은 05 DEM.
GitHub 저장소 (obra/superpowers): 강의 전 접근 가능 여부 점검.