codecartographer

CodeCartographer는 AI 코딩 에이전트와 함께 익숙하지 않은 코드베이스를 이해하고 검증된 언어 비종속적 재구현 사양을 생성하는 프레임워크입니다. Pi 확장, MCP 서버, 또는 Markdown 및 YAML 파일로 구성된 드롭인 `.codecarto/` 템플릿으로 배포됩니다. 작동 방식: "코드"는 `.codecarto/` 내부의 구조화된 Markdown과 YAML입니다. `GUIDE.md`는 LLM 진입점이고, `workflow/pipeline.yaml`은 단계와 의존성을 정의하며, `workflow/status.yaml`은 프로젝트별 가변 상태를 보유하고, `workflow/VALIDATE.md`는 검증 프로토콜을 설명합니다. 단계는 DAG를 형성합니다 — 계약과 프로토콜은 아키텍처 이후 병렬로 실행될 수 있고, 포팅은 둘 다를 기다리며, 재구현 사양이 마지막입니다. 호스트는 활성 파이프라인을 읽고, 의존성이 완료된 다음 단계를 찾아 LLM에 해당 단계의 지침을 전달하고, 출력을 검증한 후 상태를 진행시킵니다. 증거 및 검증: 각 단계는 `.codecarto/findings/` 아래에 더 작고 템플릿화된 증거 태그가 붙은 산출물을 작성하며, 이후 단계는 필요한 특정 업스트림 파일을 다시 읽습니다. 발견 사항은 관찰된 사실, 강한 추론, 이식성 위험, 외부 동작 주장, 또는 열린 질문으로 태그됩니다. 모든 단계 출력은 각 완료 기준을 PASS, PARTIAL, 또는 FAIL로 표시하는 `## Validation` 테이블로 끝납니다; 검증은 해당 테이블을 파싱하고 증거/조치 쌍 및 선언된 보조 출력을 교차 확인하며, FAIL, 누락된 출력, 또는 읽을 수 없는 판정 시 진행을 거부합니다. 생성되는 산출물에는 아키텍처 맵, 결함 보고서, 결함 수정 추적기, 동작 계약, 프로토콜 및 상태, 포팅 번들, 그리고 모듈, 수용 시나리오, 알려진 미지 사항을 포함한 최종 재구현 사양이 포함됩니다. 파이프라인 변형: 기본값은 결함 스캔을 기계적 및 의미적 패스로 분할하는 7단계 심층 감사 실행입니다. 다른 변형에는 정찰 우선(8단계), 전체 감사 포함(6단계), 전체(5단계), 결함 스캔(2단계), 라이트(3단계), 아키텍처 전용(1단계), 및 합성(4단계)이 있습니다. 변형은 발견 사항이나 진행 상황을 삭제하지 않고 제자리에서 전환할 수 있습니다. 컨텍스트 복원력: 대화가 아닌 파일 시스템이 지속 메모리입니다. 각 단계는 새로운 컨텍스트 창을 얻고, 완료된 발견 사항은 디스크에 저장되며, `status.yaml`은 진행 상황, 열린 질문, 이월 항목, 및 파이프라인 후 백로그를 기록합니다. Pi 단계 기록은 파일 기반이며 `/resume`, `/tree`, `/export`를 통해 계속 사용할 수 있습니다. 단계 인식 압축 요약은 `.codecarto/scratch/checkpoints/` 아래에 체크포인트됩니다. README는 단계 내 컨텍스트 압력이 제거되는 것이 아니라 제한된다고 언급합니다. 표면 및 기능: Pi 확장은 슬래시 명령, 라이브 에이전트 위젯, 파일 기반 단계 세션, 단계 완료 요약, 옵트인 LLM 유도 시드 프롬프트, 단계별 사용 추적, 및 도구 차단(bash 차단, 편집/쓰기는 `.codecarto/`로 제한)을 추가합니다. MCP 서버는 다른 MCP 지원 에이전트를 위해 단계 프롬프트, 검증, 및 실험적 라이브러리 게시/목록/재색인 작업을 노출합니다. 단일 파일 HTML 대시보드는 진행 상황, 링크, 사용량, 및 선택적 내러티브 요약을 집계합니다. 전방 합성은 제품 비전과 인간 확인된 라이브러리 사양을 결합하여 출처가 있는 프로젝트 계획을 생성하며, 런타임 사전 점검은 병합 또는 최종화 전에 명시적 인간 확인을 요구합니다.