kunchenguid/vision

해결하는 문제

문서화되지 않은 프로젝트 가치관과 '분위기'로 인해 일관성 없는 의사결정이 발생하는 문제를 해결합니다. 기억이나 일반적인 엔지니어링 윤리에 의존하는 대신, 실제로 머지된 PR과 커밋 기록을 기반으로 프로젝트가 어떤 방향으로 성장할지, 어떤 방향으로는 가지 않을지를 명확히 정의하는 검증 가능한 수용 기준(VISION.md 파일)을 제작하는 데 도움을 줍니다.

작동 방식

이 도구는 구조화된 파이프라인을 따르며 프로젝트 비전을 생성합니다:

1. 증거 채굴: 머지된 PR과 커밋 로그를 분석하여 실제로 구현되거나 거부된 사례를 찾아냅니다.
2. 초안 작성: 정체성, 원칙, 비목표를 포함하는 초기 VISION.md 파일을 생성합니다.
3. 스트레스 테스트: 프로젝트 원칙이 충돌할 수 있는 어려운 가정 상황(8~12개)을 생성하여 소유자가 딜레마를 겪도록 합니다.
4. 인터랙티브 리뷰: 소유자는 전용 리뷰 보드를 사용해 이러한 가정에 대한 판단을 내리고, 그 이유를 최종 문서에 반영합니다.

대상 사용자

기여자와 AI 코딩 에이전트를 위한 엄격하고 증거 기반의 기여 기준을 만들고 싶은 프로젝트 유지보수자 및 소유자.

주요 특징

• 증거 기반: 일반적인 윤리적 원칙을 배제. 모든 원칙은 실제 머지된 PR이나 커밋을 근거로 해야 합니다.
• 강화된 가정 시나리오: 단순한 브레인스토밍이 아닌, 도전적인 시나리오를 통해 비전을 정밀하게 다듬습니다.
• 전용 리뷰 환경: 집중적인 카드 기반 리뷰 프로세스를 위한 전용 스타일시트와 보드 템플릿 제공.
• 에이전트 호환: 슬래시 명령어나 자연어로 호출 가능한 에이전트 스킬로 제공됩니다.