Communitygithub.com

Council — 다각도 분석

코드베이스, 프로젝트, 문서에 대한 객관적이고 편향되지 않은 평가를 제공하는 다각도 분석 프레임워크입니다. 여러 관점과 탈편향 기법을 사용하여 기존 코드에 고착되는 경향을 극복합니다.

Council — 다각도 분석란 무엇인가요?

Council은 기존 코드에 고착되는 AI 도구(및 인간)의 일반적인 편향을 극복하기 위해 설계된 다각도 분석 스킬입니다. 이 스킬은 단순한 코드 검토를 넘어, 프로젝트의 구조, 가정, 위험 및 장기적 진화를 여러 관점(아키텍트, 도전자, 기회주의자, 보안, 경제학자 등)에서 체계적으로 평가합니다. 사용자는 분석 대상(저장소 경로, 문서, 문제 설명)과 목표 및 제약 조건을 제공하고, Council은 탐색(Scout), 관점 생성(Generate Perspectives), 종합(Synthesize), 검증(Validate)의 4단계를 통해 객관적인 보고서를 생성합니다. 복잡한 대상의 경우 하위 에이전트(spawn_agents)를 병렬로 실행하여 집단 사고를 방지하며, 모든 관점은 'Fresh Eyes Mode', 'Challenge Mode', 'Rebuild Mode'와 같은 탈편향 기법을 적용합니다. 최종 출력은 실행 요약, 주요 발견 사항, 우선순위별 권장 사항, 고려된 대안, 평가 변경 조건을 포함한 구조화된 마크다운 보고서로, 코드 분석에서 의사 결정 지원까지 폭넓게 활용할 수 있습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add adulari/forge

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

Council — 다각도 분석은(는) 무엇을 하나요?

코드베이스, 프로젝트, 문서에 대한 객관적이고 편향되지 않은 평가를 제공하는 다각도 분석 프레임워크입니다. 여러 관점과 탈편향 기법을 사용하여 기존 코드에 고착되는 경향을 극복합니다.

이 프레임워크가 해결하는 문제

AI 도구(와 인간)는 기존 코드에 고착되는 경향이 있습니다. 현재 존재하는 것을 보고, 가능한 것을 상상하는 데 어려움을 겪습니다. 그들은 탐색하기보다는 검증합니다. Council은 다음을 사용합니다:

  1. 탈편향 기법 — 새로운 사고를 강제하는 방법
  2. 여러 관점 — 서로 다른 것을 포착하는 다양한 정신 모델
  3. 구조적 종합 — 의견 차이를 추적하면서 통찰력 결합

사용 시기

  • 현재 접근 방식이 여전히 최적인지 평가할 때
  • 기존 구현에 대한 대안을 탐색할 때
  • 프로젝트의 숨겨진 가정을 식별할 때
  • 주요 결정 전에 객관적인 피드백을 얻을 때
  • 지역 최적해(local optimum)에 갇혔을 때
  • 더 나은 방법이 있을 것 같지만 보이지 않을 때
  • AI 도구가 기존 패턴을 계속 반향할 때

입력

사용자가 제공:

  • 대상: 저장소 경로, 문서 또는 특정 문제 설명
  • 목표 (선택 사항): 성공의 정의 (예: "수익성 극대화")
  • 제약 조건 (선택 사항): 반드시 유지해야 할 사항 (예: "기존 데이터 모델을 사용해야 함")

실행 흐름

1단계: 탐색(Scout)

대상을 철저히 읽고 이해합니다. 다음을 문서화:

  • 프로젝트가 하는 일
  • 현재 구조화된 방식
  • 존재하는 제약 조건
  • 명시된 목표

아직 의견을 형성하지 마십시오. 사실만 수집합니다.

2단계: 관점 생성(Generate Perspectives)

대상을 기반으로 3-5개의 관련 관점을 선택합니다:

관점초점최적 용도
아키텍트구조, 패턴, 결합도, 응집도시스템 설계, 리팩토링
도전자가정, 위험, 대안결정 검증, 위험 완화
기회주의자신기술, 지름길, 단순화최적화, 기술 부채 해결
보안신뢰 경계, 실패 모드안전, 신뢰성
경제학자비용, 복잡성, ROI자원 할당, 우선순위
사용자사용성, 가치, 마찰UX, 제품 결정
고고학자레거시, 부채, 역사이해, 마이그레이션
미래학자트렌드, 확장, 진화장기 계획

복잡한 대상의 경우 spawn_agents를 사용하여 관점을 병렬로 실행합니다. 각 에이전트는 집단 사고를 피하기 위해 독립적으로 작업한 후, 결과는 3단계에서 결합됩니다.

간단한 대상의 경우 단일 에이전트에서 관점을 순차적으로 실행합니다.

각 관점은 다음 탈편향 기법을 적용합니다:

  1. Fresh Eyes Mode: 기존 구현을 의도적으로 무시합니다. "목표만 알고, 처음부터 구축한다면 무엇을 만들겠는가?"라고 질문합니다.
  2. Challenge Mode: 모든 가정에 의문을 제기합니다. 이 구성 요소는 왜 존재하는가? 제거하면 어떻게 되는가? 반대가 사실이라면?
  3. Rebuild Mode: "오늘의 지식으로 처음부터 이 문제를 해결해야 한다면, 무엇을 다르게 하겠는가?"

자세한 탈편향 기법과 프롬프트는 references/debiasing.md를 참조하세요.

3단계: 종합(Synthesize)

관점을 구조화된 출력으로 결합합니다:

  1. 일치점: 여러 관점이 동의하는 사항 (신뢰도 높음)
  2. 불일치점: 관점 간 충돌 (자세히 살펴보기 — 이는 트레이드오프를 드러냄)
  3. 새로운 통찰력: 한 관점만 포착한 사항
  4. 우선순위화된 권장 사항: 영향과 신뢰도를 기준으로 순위 지정

하위 에이전트 사용 시 자세한 종합 지침은 agents/synthesizer.md를 참조하세요.

4단계: 검증(Validate)

  • 권장 사항이 서로 모순되지 않는지 확인
  • 검증되지 않은 가정을 표시
  • 결론을 바꿀 수 있는 정보 식별

출력 형식

# Council 보고서: [대상]

## 실행 요약
[2-3문장 객관적 평가 — 수행한 작업의 요약이 아니라 판결]

## 주요 발견 사항

### [발견 사항 이름]
- **내용**: [발견 사항에 대한 명확한 설명]
- **동의하는 관점**: [목록]
- **동의하지 않는 관점**: [목록 + 간단한 이유]
- **신뢰도**: [높음/중간/낮음]
- **증거**: [특정 파일:줄, 지표 또는 관찰]

## 권장 사항

### [높은 영향] [권장 사항 제목]
- **해결하는 문제**: [이 권장 사항이 해결하는 발견 사항]
- **해결책**: [구체적인 행동]
- **예상 영향**: [무엇이 얼마나 개선되는지]
- **노력**: [낮음/중간/높음]
- **위험**: [낮음/중간/높음]
- **지지하는 관점**: [목록]

### [중간 영향] ...

### [낮은 영향] ...

## 고려된 대안 접근법

| 접근법 | 장점 | 단점 | 판결 |
|----------|------|------|---------|
| ...      | ...  | ...  | 유지/교체/추가 탐색 |

## 이 평가를 변경할 사항
- [X]가 사실이라면, [권장 사항 Y가 변경됨]
- [중요한 검증되지 않은 가정]

번들 리소스

  • references/debiasing.md — 관점 유형별 상세 탈편향 기법 및 프롬프트
  • agents/perspective.md — 개별 관점 분석을 실행하는 하위 에이전트용 지침
  • agents/synthesizer.md — 여러 관점 출력을 결합하는 종합 하위 에이전트용 지침

관련 스킬