Council — 다각도 분석은(는) 무엇을 하나요?
코드베이스, 프로젝트, 문서에 대한 객관적이고 편향되지 않은 평가를 제공하는 다각도 분석 프레임워크입니다. 여러 관점과 탈편향 기법을 사용하여 기존 코드에 고착되는 경향을 극복합니다.
이 프레임워크가 해결하는 문제
AI 도구(와 인간)는 기존 코드에 고착되는 경향이 있습니다. 현재 존재하는 것을 보고, 가능한 것을 상상하는 데 어려움을 겪습니다. 그들은 탐색하기보다는 검증합니다. Council은 다음을 사용합니다:
- 탈편향 기법 — 새로운 사고를 강제하는 방법
- 여러 관점 — 서로 다른 것을 포착하는 다양한 정신 모델
- 구조적 종합 — 의견 차이를 추적하면서 통찰력 결합
사용 시기
- 현재 접근 방식이 여전히 최적인지 평가할 때
- 기존 구현에 대한 대안을 탐색할 때
- 프로젝트의 숨겨진 가정을 식별할 때
- 주요 결정 전에 객관적인 피드백을 얻을 때
- 지역 최적해(local optimum)에 갇혔을 때
- 더 나은 방법이 있을 것 같지만 보이지 않을 때
- AI 도구가 기존 패턴을 계속 반향할 때
입력
사용자가 제공:
- 대상: 저장소 경로, 문서 또는 특정 문제 설명
- 목표 (선택 사항): 성공의 정의 (예: "수익성 극대화")
- 제약 조건 (선택 사항): 반드시 유지해야 할 사항 (예: "기존 데이터 모델을 사용해야 함")
실행 흐름
1단계: 탐색(Scout)
대상을 철저히 읽고 이해합니다. 다음을 문서화:
- 프로젝트가 하는 일
- 현재 구조화된 방식
- 존재하는 제약 조건
- 명시된 목표
아직 의견을 형성하지 마십시오. 사실만 수집합니다.
2단계: 관점 생성(Generate Perspectives)
대상을 기반으로 3-5개의 관련 관점을 선택합니다:
| 관점 | 초점 | 최적 용도 |
|---|---|---|
| 아키텍트 | 구조, 패턴, 결합도, 응집도 | 시스템 설계, 리팩토링 |
| 도전자 | 가정, 위험, 대안 | 결정 검증, 위험 완화 |
| 기회주의자 | 신기술, 지름길, 단순화 | 최적화, 기술 부채 해결 |
| 보안 | 신뢰 경계, 실패 모드 | 안전, 신뢰성 |
| 경제학자 | 비용, 복잡성, ROI | 자원 할당, 우선순위 |
| 사용자 | 사용성, 가치, 마찰 | UX, 제품 결정 |
| 고고학자 | 레거시, 부채, 역사 | 이해, 마이그레이션 |
| 미래학자 | 트렌드, 확장, 진화 | 장기 계획 |
복잡한 대상의 경우 spawn_agents를 사용하여 관점을 병렬로 실행합니다. 각 에이전트는 집단 사고를 피하기 위해 독립적으로 작업한 후, 결과는 3단계에서 결합됩니다.
간단한 대상의 경우 단일 에이전트에서 관점을 순차적으로 실행합니다.
각 관점은 다음 탈편향 기법을 적용합니다:
- Fresh Eyes Mode: 기존 구현을 의도적으로 무시합니다. "목표만 알고, 처음부터 구축한다면 무엇을 만들겠는가?"라고 질문합니다.
- Challenge Mode: 모든 가정에 의문을 제기합니다. 이 구성 요소는 왜 존재하는가? 제거하면 어떻게 되는가? 반대가 사실이라면?
- Rebuild Mode: "오늘의 지식으로 처음부터 이 문제를 해결해야 한다면, 무엇을 다르게 하겠는가?"
자세한 탈편향 기법과 프롬프트는 references/debiasing.md를 참조하세요.
3단계: 종합(Synthesize)
관점을 구조화된 출력으로 결합합니다:
- 일치점: 여러 관점이 동의하는 사항 (신뢰도 높음)
- 불일치점: 관점 간 충돌 (자세히 살펴보기 — 이는 트레이드오프를 드러냄)
- 새로운 통찰력: 한 관점만 포착한 사항
- 우선순위화된 권장 사항: 영향과 신뢰도를 기준으로 순위 지정
하위 에이전트 사용 시 자세한 종합 지침은 agents/synthesizer.md를 참조하세요.
4단계: 검증(Validate)
- 권장 사항이 서로 모순되지 않는지 확인
- 검증되지 않은 가정을 표시
- 결론을 바꿀 수 있는 정보 식별
출력 형식
# Council 보고서: [대상]
## 실행 요약
[2-3문장 객관적 평가 — 수행한 작업의 요약이 아니라 판결]
## 주요 발견 사항
### [발견 사항 이름]
- **내용**: [발견 사항에 대한 명확한 설명]
- **동의하는 관점**: [목록]
- **동의하지 않는 관점**: [목록 + 간단한 이유]
- **신뢰도**: [높음/중간/낮음]
- **증거**: [특정 파일:줄, 지표 또는 관찰]
## 권장 사항
### [높은 영향] [권장 사항 제목]
- **해결하는 문제**: [이 권장 사항이 해결하는 발견 사항]
- **해결책**: [구체적인 행동]
- **예상 영향**: [무엇이 얼마나 개선되는지]
- **노력**: [낮음/중간/높음]
- **위험**: [낮음/중간/높음]
- **지지하는 관점**: [목록]
### [중간 영향] ...
### [낮은 영향] ...
## 고려된 대안 접근법
| 접근법 | 장점 | 단점 | 판결 |
|----------|------|------|---------|
| ... | ... | ... | 유지/교체/추가 탐색 |
## 이 평가를 변경할 사항
- [X]가 사실이라면, [권장 사항 Y가 변경됨]
- [중요한 검증되지 않은 가정]
번들 리소스
references/debiasing.md— 관점 유형별 상세 탈편향 기법 및 프롬프트agents/perspective.md— 개별 관점 분석을 실행하는 하위 에이전트용 지침agents/synthesizer.md— 여러 관점 출력을 결합하는 종합 하위 에이전트용 지침