diff --git a/Home.md b/Home.md index 6b42ef8..77ce724 100644 --- a/Home.md +++ b/Home.md @@ -1,14 +1,18 @@ # Wiki Index 이 인덱스는 Gitea 위키에 올릴 문서의 읽기 순서를 정리한다. -권장 읽기 순서는 `위키 1 -> 위키 2 -> 위키 3`이다. +권장 읽기 순서는 `Prompt -> 위키 1 -> 위키 2 -> 위키 3`이다. ## 읽기 원칙 +- `Prompt`는 실제 실행 지시서다. - 위키 1은 판단 기준이다. - 위키 2는 상위 운영 절차다. - 위키 3은 상세 실행 파이프라인이다. - 실제 입력, 중간 산출물, 검증 결과는 위키가 아니라 이슈와 run 폴더에 남긴다. +## Execution +- Prompt + ## Kei Standards - Wiki-1-1-Kei-Thinking-and-Process - Wiki-1-2-Kei-Roles-and-Operating-Principles diff --git a/Prompt.md b/Prompt.md new file mode 100644 index 0000000..381ca76 --- /dev/null +++ b/Prompt.md @@ -0,0 +1,126 @@ +# Prompt + +이 문서는 `C.E.L._slide_test` 저장소의 전체 실행 루프를 한 번에 수행하기 위한 마스터 프롬프트다. +이 문서를 읽은 에이전트는 추가 설명 없이도 위키, 이슈, 코드, run 산출물을 따라 단계별로 실행해야 한다. + +## 사용 문장 +사용자는 아래 한 줄만 말하면 된다. + +`위키의 Prompt를 기준으로 실행해줘.` + +## 실행 대상 +- 기준 저장소: `D:\ad-hoc\C.E.L._slide_test` +- 기준 위키: 현재 Gitea 위키 문서 전체 +- 기준 이슈: Gitea 이슈 탭의 Step 1 ~ Step 6 이슈 +- 기준 산출물 경로: `docs/run-xxx/` + +## 기본 목표 +- 위키의 기준과 절차를 먼저 읽는다. +- 현재 run의 입력 원문을 확인한다. +- Step 1 ~ Step 6 이슈를 순서대로 수행한다. +- 각 Step마다 필요한 세부 위키, 코드, docs 산출물을 확인한다. +- 실행 결과를 step별로 평가하고, 결과를 Gitea 이슈 코멘트용 본문으로 작성한다. +- 중간 산출물과 최종 결과물을 반드시 저장소 안에 남긴다. +- 마지막에 전체 현황, 실패 원인, 다음 수정 우선순위를 정리한다. + +## 읽기 순서 +1. `Home` +2. `Wiki-1-1-Kei-Thinking-and-Process` +3. `Wiki-1-2-Kei-Roles-and-Operating-Principles` +4. `Wiki-2-DesignAgent-Upper-Workflow-Overview` +5. 현재 수행할 Step에 해당하는 `Wiki-2-x` +6. 필요 시 관련 `Wiki-3-x` +7. `D:\ad-hoc\C.E.L._slide_test\issues\Step-*.md` +8. `D:\ad-hoc\C.E.L._slide_test\docs\run-xxx\` +9. 필요 시 `D:\ad-hoc\kei\design_agent` 코드와 `scripts\run_from_artifacts.py` + +## 실행 순서 +### 1. Run 식별 +- 가장 최근 run 폴더 또는 사용자가 지정한 run 폴더를 확인한다. +- 기준 입력은 `docs/run-xxx/01-input/` 안의 원본 `mdx`다. +- 입력 원문이 없으면 먼저 그 사실을 기록하고 중단한다. + +### 2. Step 1 수행 +- `Step-1-Input-Review` 이슈 본문과 `Wiki-2-1-Input-Review`를 기준으로 입력을 해석한다. +- 결과를 `docs/run-xxx/01-input/`에 기록하거나 갱신한다. +- pass / revise / fail, 실패 분류, 수정 액션을 정리한다. +- Gitea 이슈 코멘트용 본문을 작성한다. + +### 3. Step 2 수행 +- `Step-2-Interpretation` 이슈 본문과 `Wiki-2-2-Kei-Interpretation`을 기준으로 핵심 목적, 의미 보존 기준, 실패 패턴, 검증 기준을 정리한다. +- 결과를 `docs/run-xxx/02-kei-interpretation/`에 기록하거나 갱신한다. +- pass / revise / fail, 실패 분류, 수정 액션을 정리한다. +- Gitea 이슈 코멘트용 본문을 작성한다. + +### 4. Step 3 수행 +- `Step-3-Content-Structuring` 이슈 본문과 `Wiki-2-3-Content-Structuring`을 기준으로 중심 메시지, 보조 메시지, 섹션 구조, 배치 가정을 정리한다. +- 결과를 `docs/run-xxx/03-structure/`에 기록하거나 갱신한다. +- pass / revise / fail, 실패 분류, 수정 액션을 정리한다. +- Gitea 이슈 코멘트용 본문을 작성한다. + +### 5. Step 4 수행 +- `Step-4-Execution-Planning` 이슈 본문과 `Wiki-2-4-Execution-Planning`, 필요한 `Wiki-3` 문서를 기준으로 실행 계획을 수립한다. +- Stage별 입력, 출력, 검증 지점을 명확히 적는다. +- 필요한 수동 보강 산출물이 있으면 `docs/run-xxx/04-plan/`에 기록하거나 갱신한다. +- pass / revise / fail, 실패 분류, 수정 액션을 정리한다. +- Gitea 이슈 코멘트용 본문을 작성한다. + +### 6. Step 5 수행 +- `Step-5-Execution` 이슈 본문과 `Wiki-2-5-Execution`, 필요한 `Wiki-3` 문서를 기준으로 실제 실행한다. +- 가능하면 기존 `design_agent` 후반부 코드와 저장소 내 산출물을 사용한다. +- 결과를 `docs/run-xxx/05-execution/`에 저장한다. +- pass / revise / fail, 실패 분류, 수정 액션을 정리한다. +- Gitea 이슈 코멘트용 본문을 작성한다. + +### 7. Step 6 수행 +- `Step-6-Validation-and-Recording` 이슈 본문과 `Wiki-2-6-Validation-and-Recording`, 필요한 `Wiki-3` 문서를 기준으로 검증한다. +- 검증 결과를 `docs/run-xxx/06-validation/`에 저장한다. +- pass / revise / fail, 실패 분류, 수정 액션을 정리한다. +- Gitea 이슈 코멘트용 본문을 작성한다. + +### 8. 최종 정리 +- Step 1 ~ Step 6의 판정을 요약한다. +- 현재 병목을 1~3개로 압축한다. +- 다음 수정 우선순위를 정리한다. +- 다음 run에서 무엇을 바꿔야 하는지 기록한다. + +## 반복 규칙 +- 기본은 Step 1 ~ Step 6을 한 사이클로 본다. +- Step 6 판정이 `revise` 또는 `fail`이면 원인을 분석하고 다음 보정안을 적용해 다시 진행한다. +- 최대 반복 횟수는 `3회`다. +- 아래 중 하나에 해당하면 종료한다. + 1. Step 6이 `pass` + 2. 3회 반복 후에도 핵심 품질 문제가 남음 + 3. 입력 또는 코드 충돌로 더 진행하면 위험함 + +## 산출물 저장 규칙 +- 입력 원문: `docs/run-xxx/01-input/` +- 입력 검토: `docs/run-xxx/01-input/` +- 해석 결과: `docs/run-xxx/02-kei-interpretation/` +- 구조화 결과: `docs/run-xxx/03-structure/` +- 실행 계획: `docs/run-xxx/04-plan/` +- 실행 결과: `docs/run-xxx/05-execution/` +- 검증 결과: `docs/run-xxx/06-validation/` + +## 이슈 코멘트 작성 규칙 +각 Step 완료 후 아래 항목을 포함해 코멘트를 작성한다. +- 실행 요약 +- 산출물 경로 +- KPI / 판정 결과 +- 실패 분류 +- 수정 액션 +- 다음 단계 전달물 + +## 중단 조건 +- 입력 파일이 없음 +- 위키 기준과 코드 상태가 정면 충돌함 +- 필수 산출물을 생성할 수 없음 +- 반복 횟수 제한에 도달함 + +## 최종 출력 형식 +최종 답변에는 아래를 포함한다. +- Step 1 ~ Step 6 코멘트 초안 +- 전체 요약 +- 실패 원인 요약 +- 다음 수정 우선순위 +- 최종 산출물 경로