Pier_v1/prompt

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]).
• 폴더가 생성된 뒤에는 파일명에 폴더 루트를 접두어로 붙이지 않습니다.