prompt-templates/ai-session-governance

ai-session-governance은(는) 무엇을 하나요?

AI 세션 연속성 엔지니어링 — Codex, Claude Code, Gemini CLI 간 교차 도구 핸드오프 거버넌스. PLAN→READ→CHANGE→QC→PERSIST 워크플로우와 드리프트 방지 가드레일.

개요

이 템플릿은 AI 에이전트 세션이 여러 도구와 세션에 걸쳐 일관된 작업 맥락을 유지하도록 돕습니다. 주요 목적은 핸드오프 시 정보 손실을 방지하고, 각 단계의 상태를 명확히 기록하여 다음 에이전트가 이어받을 수 있게 하는 것입니다.

워크플로우

1. PLAN: 수행할 작업의 범위, 목표, 제약 조건을 정의합니다.
2. READ: 현재 코드베이스 상태를 읽고 필요한 컨텍스트를 수집합니다.
3. CHANGE: 계획에 따라 코드를 수정합니다.
4. QC: 변경 사항이 계획과 일치하는지 품질 검사를 수행합니다.
5. PERSIST: 작업 상태와 결과를 저장하고, 다음 세션을 위한 핸드오프 문서를 생성합니다.

사용 방법

각 단계는 다음 포맷으로 기록되어야 합니다:

## [단계 이름] - 상태

### 입력
- 이전 단계의 출력
- 추가 컨텍스트

### 출력
- 결과 요약
- 변경 사항 목록
- 다음 단계를 위한 지침

드리프트 방지 가드레일

• 각 단계 완료 시 체크포인트를 생성합니다.
• 체크포인트는 다음 에이전트가 이전 상태를 검증할 수 있도록 합니다.
• 세션 간 일관성을 유지하기 위해 핸드오프 문서를 항상 참조합니다.

지원 도구

• Codex
• Claude Code
• Gemini CLI

예시

다음은 PLAN 단계의 예시입니다:

## PLAN - 완료

### 입력
- 초기 요청: 사용자 등록 기능 추가
- 현재 코드: `/src/auth/register.ts` 존재하지 않음

### 출력
- 구현할 파일 목록: `/src/auth/register.ts`, `/src/auth/register.test.ts`
- 제약 조건: 비밀번호는 bcrypt로 해싱
- 다음 단계: READ 단계에서 `/src/auth` 전체 구조 확인

참고

• 핸드오프 시 항상 SESSION_STATE.md 파일을 업데이트하세요.
• 각 단계의 상태는 진행 중, 완료, 차단됨, 실패 중 하나여야 합니다.