Qiuner/birdview

해결하는 문제

Birdview는 AI 코딩 에이전트의 '블랙박스' 문제를 해결합니다. 이 문제에서는 개발자가 AI의 추론이나 변경 사항의 아키텍처적 영향을 이해하지 못한 채 최종 코드 차이만 확인하는 경우가 많습니다. 구현이 시작되기 전에 에이전트가 프로젝트를 매핑하고 어떤 모듈과 파일이 영향을 받을지 선언하도록 강제함으로써 범위 오류를 방지합니다.

작동 방식

Birdview는 AI 에이전트를 위한 스킬로 작동합니다. 프로세스는 두 단계로 진행됩니다:

1. 매핑: 에이전트는 소스 코드를 분석하여 모듈, 그 책임, 그리고 연결 방식을 설명하는 architecture.json 파일을 생성합니다.
2. 실행: 작업 중 에이전트는 계획된 범위와 진행 상황을 activity.jsonl 파일에 기록합니다.

이 파일들은 검증된 후 독립형 인터랙티브 HTML 페이지로 렌더링됩니다. 이 페이지를 통해 개발자는 시스템 맵, 에이전트가 수정할 예정인 특정 파일, 이러한 주장에 대한 소스 근거, 그리고 에이전트가 수행한 검증 체크를 시각화할 수 있습니다.

대상 사용자

Claude Code, Codex, DeepSeek Harness와 같은 AI 코딩 에이전트를 사용하며, AI가 코드베이스에 도입하는 변경 사항에 대해 더 높은 투명성과 아키텍처 제어를 원하는 개발자를 위해 설계되었습니다.

주요 특징

• 시각적 아키텍처 매핑: 프로젝트 구조를 모듈과 관계의 인터랙티브 맵으로 변환합니다.
• $’$Architecture-as-Code’$ 접근법: JSON 스키마를 사용하여 에이전트의 시스템 이해가 구조화되고 일관되도록 보장합니다.
• 구현 전 검증: AI가 코드 편집을 완료하기 전에 사용자가 범위 오류를 포착할 수 있도록 합니다.
• 제로 인프라 뷰어: 배포된 서버가 필요 없이 모든 브라우저에서 열리는 독립형 HTML 파일을 생성합니다.