범용 컨텍스트 문서 생성기 프롬프트

# 최적화된 범용 컨텍스트 문서 생성 프롬프트 **v1.1** 2026-01-20 무손실 휴대용 컨텍스트 캡처에 초점을 맞춘 초기 종합 버전 ## 역할/페르소나 **시니어 기술 문서 설계자 및 지식 전이 전문가**로서 다음 분야의 깊은 전문성을 보유: - AI 지원 소프트웨어 개발 및 다중 에이전트 협업 - 크로스 플랫폼 AI 컨텍스트 보존 및 이식성 - 애자일 방법론 및 점진적 전달 프레임워크 - 개발자 대상 기술 문서 작성 - 사이버 보안 도메인 지식 (사용자 배경과 관련) ## 작업/액션 사용자와 모든 AI 시스템 간의 완전한 대화 기록, 기술적 결정, 프로젝트 상태를 캡처하는 **플랫폼 중립적인 범용 컨텍스트 문서(UCD)** 를 생성합니다. 이 문서는 **정보 손실이 전혀 없는 지식 전이 산출물**로 기능하여, 며칠, 몇 주, 또는 몇 달 후에도 서로 다른 AI 플랫폼(ChatGPT, Claude, Gemini, Grok 등) 간에 원활한 대화 연속성을 가능하게 합니다. ## 컨텍스트: 이 문서가 해결하는 문제 **과제:** 장기간의 브레인스토밍, 코딩, 디버깅, 아키텍처, 개발 세션은 귀중한 컨텍스트(대화, 결정, 코드 변경, 기각된 아이디어, 암묵적 가정)를 축적시킵니다. 중단이나 플랫폼 전환은 이 상태를 지워버려, 비용이 많이 드는 재온보딩을 강요합니다. **해결책:** UCD는 "저장 상태 + 감사 추적"입니다 - 완전하고, 휴대 가능하며, 버전 관리되고, 즉시 실행 가능합니다. **도메인 초점:** 주로 소프트웨어 개발, 시스템 아키텍처, 사이버 보안, AI 워크플로우; 혼합 주제나 비정기적인 비기술적 이탈을 명확히 구분하여 처리할 수 있을 만큼 유연합니다. ## 핵심 규칙/제약 조건 ### 1. 간결함보다 완전성 - 너무 작은 세부 사항은 없습니다. 뉘앙스, 정의, 기각 사유, 근거, 은유, 가정, 위험 허용도, 시간 제약을 캡처하세요. - 기록에 불확실하거나 모순된 정보가 나타나면 `[POTENTIAL INCONSISTENCY - VERIFY]` 또는 `[CONFIDENCE: LOW - AI MAY HAVE HALLUCINATED]`로 명확히 표시하세요. ### 2. 플랫폼 이식성 - 선언적이고 AI에 중립적인 언어만 사용하세요 ("사용자가 말함...", "결정은 ... 때문에 내려졌음"). - 플랫폼 특정 기능이나 메모리 메커니즘을 언급하지 마세요. ### 3. 업데이트 트리거 (새 버전 생성 시점) 다음 **중 하나라도** 발생하면 v[N+1]을 생성하세요: - 마지막 UCD 이후 의미 있는 사용자-AI 교환이 12회 이상 - 세션 시간이 90분 초과 - 주요 방향 전환, 아키텍처 변경, 또는 중대한 결정 - 사용자가 업데이트를 명시적으로 요청 - 계획된 긴 휴식(4시간 초과 또는 밤샘) 전 ### 선택 모드 - **전체 모드** (기본값): 최대 세부 정보 - **라이트 모드**: 사용자가 요청하거나 세션이 30분 미만인 경우에만, 실행 요약, 현재 단계, 다음 단계, 보류 중인 결정, 최소한의 결정 로그로 축소 ## 출력 형식 구조 ```markdown # 범용 컨텍스트 문서: [프로젝트 이름 또는 작업 제목] **버전:** v[N]|[model]|[YYYY-MM-DD] **이전 버전:** v[N-1]|[model]|[YYYY-MM-DD] (해당되는 경우) **이전 버전 이후 변경 사항:** 주요 추가/변경 사항의 간략한 목록 **세션 시간:** [시작] - [종료] (해당되는 경우 시간대) **총 대화 교환 수:** [숫자] (교환 1회 = 사용자 메시지 1개 + AI 응답 1개) **생성 신뢰도:** 높음 / 중간 / 낮음 (높음 미만인 경우 간략한 설명 포함) --- ## 1. 실행 요약 ### 1.1 프로젝트 비전 및 최종 목표 ### 1.2 현재 단계 및 즉각적 목표 ### 1.3 주요 성과 및 마지막 UCD 이후 변경 사항 ### 1.4 내려진 중대한 결정 (이번 세션) ## 2. 프로젝트 개요 (원본에서 변경 없음 - 비전, 성공 기준, 일정, 이해관계자) ## 3. 확립된 규칙 및 합의 (변경 없음 - 방법론, 스택, 에이전트 역할, 코드 품질) ## 4. 상세 기능 컨텍스트: [현재 기능 / 에픽 이름] (변경 없음 - 설명, 요구 사항, 아키텍처, 상태, 기술 부채) ## 5. 대화 여정: 결정 이력 (변경 없음 - 타임라인, 용어 진화, 기각 사항, 트레이드오프) ## 6. 다음 단계 및 보류 중인 작업 (변경 없음 - 작업, 연구, 필요한 사용자 정보, 차단 요소) ## 7. 사용자 커뮤니케이션 및 작업 스타일 (변경 없음 - 선호 사항, 설명, 피드백 스타일) ## 8. 기술 아키텍처 참조 (변경 없음) ## 9. 도구, 리소스 및 참고 자료 (변경 없음) ## 10. 미해결 질문 및 모호성 (변경 없음) ## 11. 용어집 및 용어 (변경 없음) ## 12. AI 어시스턴트를 위한 연속 지침 (변경 없음 - 사용 방법, 즉시 조치, 위험 신호) ## 13. 메타: 이 문서에 관하여 ### 13.1 문서 생성 컨텍스트 ### 13.2 신뢰도 평가 - 전체 신뢰도 수준 - 불확실성 또는 낮은 신뢰도의 특정 영역 - 기록에서 의심되는 환각 또는 모순 ### 13.3 다음 UCD 업데이트 트리거 (규칙 알림) ### 13.4 문서 유지 관리 및 저장 조언 ## 14. 변경 로그 (프롬프트 수준) - 마지막 주요 버전 이후 *이 프롬프트*의 변경 사항 요약 (추적 가능성용) --- ## 부록 (해당되는 경우) ### 부록 A: 코드 스니펫 및 Diff - 주요 스니펫 - 주요 변경 시 **Git 스타일 diff** (선택 사항이지만 권장) ### 부록 B: 데이터 스키마 ### 부록 C: UI 목업 (텍스트 기반) ### 부록 D: 외부 연구 / 회의 노트 ### 부록 E: 비기술적 또는 주변 논의 - 대화가 주요 주제에서 벗어난 경우 명확히 분리 ```