# prompt 폴더

각 Task의 **입력 / 수행 / 출력 이력**을 담당자별·날짜별로 기록하는 로그 폴더입니다.
> 본 문서는 `.claude/taskexecutionagent.md` **v0.3.01**의 [F4]·[F8]·[Step 5]에 종속됩니다. 충돌 시 정본이 우선합니다.

## 저장 구조
```
prompt/
└── <담당자>/
    └── <YYYY-MM-DD>/
        └── <Task식별자>.md
```

## 로그 항목 (v0.3.01 기준 — 상세 서식은 `tea-logging` 스킬)

| 항목 | 내용 |
|------|------|
| 담당자 | [F4]에 따라 확정한 담당자명 (**필수**) |
| 일자 | **실제 작업 일자** (작성 시점이 아님) (**필수**) |
| Task 식별자 | 로그 파일명과 동일 (**필수**) |
| 선행 Task | 연속 Task인 경우 직전 로그 경로 |
| 경로·복잡도·모드 | COMPLEX / COMPLEX-DOC / SIMPLE, GATED / FAST, **자율성 등급**(HITL/HOTL/HOOTL) |
| INPUT | 사용자 입력 프롬프트 **원문 그대로** (요약·편집 없이 전체 텍스트) |
| PROCESS | 수행 내용의 요약 |
| **DECISIONS** | **결정 지점 / 채택안 / 기각안과 기각 사유 / 근거.** 기각안을 적지 않으면 재개 세션이 같은 오답을 반복합니다. 결정이 없었으면 `—` |
| OUTPUT | 산출물명 / 저장 경로 / 버전 — **표 형태**. 기재 전 `ls` 등으로 실재 확인 필수, 미확인 경로 기재 금지 |
| MODEL | 사용 LLM 모델명·버전 (중간 전환 시 시점·사유 병기) |
| **EFFORT** | **대화 턴 수 / 도구 호출 횟수** (필수). 서브에이전트 위임 횟수 포함. 토큰 사용량은 실행환경이 제공하는 경우에만 추가 기재. 예: `턴 12 / 도구호출 27 (서브에이전트 2회 포함)` |
| STATUS | **아래 4값 중 하나** (임의값 금지) |
| 비고 | FAST 사유, 규정 이탈 근거, 한계, **AI 산출물 수정률**([R9]) |


## STATUS 허용값 (4값)

| 값 | 의미 |
|----|------|
| `PROCESS COMPLETE` | 목표 전량 달성. 치명 FAIL 0건 |
| `PROCESS PARTIAL (사유)` | 일부 완료 + 일부 미착수/미달성. **미달성 범위를 사유에 명시** |
| `중단(미완료) (사유)` | 목표 미달성 상태로 종료 |
| `보류 (대기사유)` | 사용자 결정·외부 입력 대기로 진행 정지 |

- 위 4값 외 임의 표현(`Phase N COMPLETE`, `철회` 등)을 쓰지 않습니다. 단계·범위 정보는 사유 괄호나 `비고`에 넣습니다.
- [V9] 확인 결과 산출물이 부재하면 `중단(미완료)`로 표기합니다.

## INPUT 기재 규칙
- 턴별로 `### [1]` ~ `### [N]`으로 분리하고 **각각 코드블록으로 감쌉니다.** 표 셀 안에 압축하지 않습니다.
- 원문 / 시스템 응답 / 주석을 **3자 분리 표기**합니다.
```
[원문] 사용자가 입력한 프롬프트 원문 그대로
[시스템응답] 대화 중 자동 삽입된 reminder 등 시스템 메시지(있는 경우만)
[주석] 담당자가 남기는 참고 메모(있는 경우만)
```
- **원문을 외부 파일에 위임하지 않습니다.** (`대화 로그 참조`·`전문 생략` 금지)
- 첨부는 `[첨부: 파일명]`으로 원문 위치에 표기하며, 오탈자·구어체를 교정하지 않습니다.

## 기록 시점 (트리거 — 하나라도 충족 시 무조건 기록)
- (T1) Task가 `PROCESS COMPLETE`에 도달했을 때
- (T2) 사용자가 다음 Task를 요청했을 때 — 직전 Task가 미완료여도 반드시 기록
- (T3) 사용자가 `Context-Migration`을 요청했을 때

## 로그 입도 기준
- 로그 1건 = **Task 1건**(= 산출물 1계열). 발화 1턴 = 로그 1건이 아닙니다.
- 같은 산출물에 대한 연속 수정은 한 로그에 턴을 누적하고, 산출물이 바뀌면 새 로그를 만듭니다.
- 하나의 로그가 **2일 이상 또는 사용자 지시 20턴을 초과하면 분할**합니다.
- 로그 파일은 **실제 작업 일자**의 날짜 폴더에 둡니다.

## 변경 이력 표 (적용 제외)
로그는 Task 종료 시 1회 기록되는 **append-only 감사 기록**이므로 [F6] 변경 이력 표를 붙이지 않습니다.
로그를 사후 보정한 경우에만 하단에 `## 로그 갱신 이력` 절을 추가합니다.

## 담당자 식별 — [F4] 담당자ID 주키

**담당자는 담당자ID(성명)를 주키로 식별합니다. IP 주소는 보조 확인 수단입니다.**

- 담당자명은 **매 Task 착수 프롬프트에 명시**합니다. 예: `task: … (담당자: 홍길동)`
- 명시되지 않으면 최초 1회 질의하여 확정하며, **이전 Task의 담당자명을 자동 승계하지 않습니다.**
- 동일 IP를 다수 담당자가 공유하는 환경에서는 **IP 일치만으로 담당자를 자동 확정하지 않습니다.** 매핑 표의 IP 행을 다른 사람 이름으로 덮어쓰지 않고, `prompt/<담당자>/` 로그 폴더만 담당자별로 분리해 씁니다.
- 활동 중인 담당자는 **IP 확보 여부와 무관하게 전원 등재**합니다.

| 담당자 | IP(있는 경우) | 비고 |
| --- | --- | --- |
| 심영표 | (미확인) | 2026-10-07 최초 등재 (운곡교 P1 교각 모델링 Task) |

## 폴더 자동생성 예외 처리 — [F7]
**아래 조건을 모두 충족할 때만 발동합니다.** 조건 확인 없이 원용하는 것을 금지합니다.
1. 표준 경로 저장을 **실제 시도하여 실패**했을 것
2. 셸 사용이 가능하면 `mkdir -p`를 먼저 시도하고 그것도 실패했을 것
3. 동일 세션·환경에서 표준 경로 저장 성공 선례가 없을 것

- **상시 재사용 폴더**(`prompt/<담당자>` 등): 폴더 생성 스크립트를 상위 폴더에 만들어 사용자 실행을 요청(→ STOP)한 뒤, 확인 후 원래 경로로 저장.
- **날짜별 폴더**: 상위 `prompt/<담당자>/`까지만 1회 생성하고, 날짜 폴더 대신 파일명에 날짜·Task를 포함. 예: `prompt/<담당자>/<YYYY-MM-DD>_<Task식별자>.md`
  - 이는 **날짜 폴더를 생략하는 예외일 뿐, 담당자 폴더를 생략하는 근거가 아닙니다.**
- 적용 이력을 `context-migration`에 기록하며, **기록 없는 예외 적용은 무효**입니다.
- 예외 해소 후에는 즉시 표준 구조로 이관합니다(복사 → 대조 → 삭제, [G3-3]).
- **폴더가 생성된 뒤에는 파일명에 폴더 루트를 접두어로 붙이지 않습니다.**