구현 플랜

PlanToCode는 팀 리더와 이해 관계자가 AI 생성 구현 플랜의 모든 측면에 대한 완전한 제어를 유지하도록 보장하는 포괄적인 사람이 개입하는(HITL) 워크플로우를 구현합니다. 이 거버넌스 모델은 AI 코딩 에이전트가 자율적으로 작동할 때 발생할 수 있는 회귀, 버그 및 의도하지 않은 수정을 방지합니다.

코드 수정이 시작되기 전에 모든 플랜은 구조화된 검토 워크플로우를 통과해야 합니다:

• 검토:플랜은 Monaco 편집기에서 열리며 검토자는 전체 구문 강조 및 전문 편집 도구를 사용하여 제안된 모든 변경 사항을 검토할 수 있습니다.
• 편집:이해 관계자는 VS Code 편집 기능을 사용하여 단계를 직접 수정하고, 접근 방식을 조정하고, 제약 조건을 추가하거나, 위험한 작업을 제거할 수 있습니다.
• 변경 요청:팀은 AI 시스템에 수정을 요청하여 대체 접근 방식을 생성하거나 사용자 정의 지침으로 여러 플랜을 병합할 수 있습니다.
• 승인:명시적인 승인이 있어야만 플랜을 선택한 코딩 에이전트 또는 할당된 소프트웨어 개발자에게 안전하게 전송하여 실행할 수 있습니다.
• 거부:요구 사항을 충족하지 않는 플랜은 완전히 거부할 수 있으며, 규정 준수 및 학습을 위해 전체 감사 추적이 유지됩니다.

이 워크플로우는 모든 개발 노력이 기업 제품 요구 사항, 팀 워크플로우 및 비즈니스 목표와 일치하도록 보장합니다. 명시적인 사람의 승인 없이는 코드 변경이 발생하지 않습니다.

구현 플랜은 개발 작업을 프로젝트의 저장소 구조에 해당하는 정확한 파일 경로를 사용하여 파일별로 세분화하는 매우 세밀한 구조를 사용합니다. 이 세분성은 회귀를 방지하고 기업 환경에서 AI 코딩 에이전트를 자신 있게 도입하는 데 필수적입니다.

플랜의 각 단계는 다음과 같은 파일을 명시적으로 선언합니다:

• 수정됨(특정 줄 범위 및 설명된 변경 사항 포함)
• 생성됨(완전한 파일 경로 및 초기 콘텐츠 구조 포함)
• 삭제됨(정당성 및 종속성 분석 포함)
• 참조됨(컨텍스트용이지만 수정되지 않음)

이 수준의 세부 정보는 코드를 건드리기 전에 제안된 변경 사항의 영향을 명확하게 보여줍니다. 팀 리더는 중요한 레거시 코드가 수정될지, 주요 변경 사항이 제안될지, 또는 플랜이 추가 검토가 필요한 파일을 건드리는지 즉시 식별할 수 있습니다.

파일별 접근 방식은 또한 승인된 플랜을 코딩 에이전트에 정확하게 전송할 수 있게 해줍니다. "인증 시스템 업데이트"와 같은 모호한 지시 대신 에이전트는 정확한 사양을 받습니다: "토큰 회전을 추가하기 위해 src/auth/session_manager.rs 45-67줄을 수정하고, 다음 구조로 src/auth/token_store.rs를 생성..."

플랜 콘텐츠는 Monaco Editor를 래핑하는 공유 VirtualizedCodeViewer를 통해 렌더링됩니다. 뷰어는 일반적인 언어를 자동으로 감지하고, 클립보드에 복사 작업을 지원하며, 매우 큰 플랜을 가상화하고, 문자 수 및 구문 인식 강조와 같은 선택적 메트릭을 제공합니다.

플랜이 열리면 패널은 작업 식별자로 활성 플랜을 확인하고 콘텐츠를 Monaco에 전달하며 검토자가 현재 열린 모달을 잃지 않고 인접한 작업 간에 이동할 수 있게 합니다.

패널은 후속 작업이 동일한 범위를 재사용할 수 있도록 파일 검색 워크플로우 중에 선택된 저장소 루트를 저장합니다. 또한 다운스트림 프롬프트를 워크플로우를 다시 계산하지 않고 생성하거나 복사할 수 있도록 프로젝트 디렉터리 및 준비된 프롬프트 콘텐츠와 같은 플랜별 메타데이터를 기록합니다.

프롬프트가 복사되기 전에 토큰 추정이 실행됩니다. 패널은 프로젝트 디렉터리, 선택된 파일 및 현재 선택된 모델로 토큰 추정 명령을 호출하여 팀이 모델 제한 내에 머물 수 있도록 시스템 및 사용자 프롬프트 합계를 모두 표시합니다.

모든 메타데이터는 감사 목적으로 플랜과 함께 유지됩니다. 기업 팀은 어떤 이해 관계자가 어떤 플랜을 검토했는지, 어떤 수정이 요청되었는지, 그리고 초기 작업 설명에서 파일 검색을 거쳐 최종 승인된 플랜까지의 완전한 추론 체인을 추적할 수 있습니다.

플랜은 병합, 삭제 또는 나중에 다시 열 수 있습니다. 패널은 선택된 플랜 식별자 목록을 유지하고, 플랜에 연결된 터미널 출력을 위한 전용 모달을 관리하며, 검토자가 뷰어를 닫지 않고 이전 플랜을 페이지할 수 있도록 탐색 도우미를 노출합니다. 터미널 액세스, 프롬프트 복사 컨트롤 및 병합 지침은 모두 동일한 작업 식별자를 공유하여 감사 기록이 일관되게 유지됩니다.