Markdown Templates

정형화된 마크다운 문서 생성을 위한 템플릿 모음입니다.

핵심 원칙

정형 콘텐츠는 템플릿, 비정형 콘텐츠는 markdown-writer-agent

템플릿 목록

| 템플릿 | 위치 | 용도 | |--------|------|------| | task-template.md | .claude/templates/ | Task 파일 골격 | | test-case-template.md | .claude/templates/ | 테스트 케이스 골격 | | agent-result-template.md | .claude/templates/ | 에이전트 결과 형식 | | step-status-template.md | .claude/templates/ | Step 상태 형식 |

변수 치환 규칙

템플릿 내 변수는 {{VARIABLE_NAME}} 형식:

공통 변수

| 변수 | 설명 | 예시 | |------|------|------| | {{TIMESTAMP}} | ISO 형식 시간 | 2024-01-15T10:30:00 | | {{STATUS}} | 상태 값 | pending, in_progress, completed |

Task 템플릿 변수

| 변수 | 설명 | |------|------| | {{TASK_ID}} | Task 식별자 (TASK-001) | | {{TITLE}} | Task 제목 | | {{CREATED_AT}} | 생성 시간 | | {{UPDATED_AT}} | 업데이트 시간 | | {{REQUEST_CONTENT}} | 사용자 요청 원문 | | {{CODEBASE_SEARCH_RESULT}} | codebase-search 결과 | | {{REFERENCE_RESULT}} | reference-agent 결과 | | {{WEB_SEARCH_RESULT}} | web-search 결과 | | {{STEPS_CONTENT}} | Step 목록 | | {{AGENT_RESULTS}} | 에이전트 결과들 | | {{TEST_RESULTS}} | 테스트 결과들 | | {{USER_INTERACTIONS}} | 사용자 상호작용 기록 |

Test Case 템플릿 변수

| 변수 | 설명 | |------|------| | {{TEST_ID}} | 테스트 식별자 (TASK-001-T01) | | {{TEST_TITLE}} | 테스트 제목 | | {{STEP_NUMBER}} | 관련 Step 번호 | | {{IMPLEMENTATION_SUMMARY}} | 구현 내용 요약 | | {{TEST_PURPOSE}} | 테스트 목적 | | {{TEST_ENVIRONMENT}} | 테스트 환경 | | {{TEST_ITEMS}} | 테스트 항목 목록 | | {{RELATED_FILES}} | 관련 파일 목록 | | {{NOTES}} | 참고사항 | | {{TEST_RESULT_ROWS}} | 결과 테이블 행 | | {{FINAL_RESULT}} | 최종 결과 | | {{TEST_DATE}} | 테스트 일시 | | {{TESTER}} | 테스터 |

Agent Result 템플릿 변수

| 변수 | 설명 | |------|------| | {{AGENT_NAME}} | 에이전트 이름 | | {{RESULT_DETAILS}} | 결과 상세 내용 | | {{NEXT_ACTIONS}} | 다음 작업 |

Step Status 템플릿 변수

| 변수 | 설명 | |------|------| | {{STEP_NUMBER}} | Step 번호 | | {{STEP_TITLE}} | Step 제목 | | {{STEP_STATUS}} | Step 상태 | | {{ASSIGNED_AGENT}} | 담당 에이전트 | | {{START_TIME}} | 시작 시간 | | {{END_TIME}} | 완료 시간 | | {{STEP_DESCRIPTION}} | 작업 내용 | | {{STEP_RESULT}} | 결과 | | {{MODIFIED_FILES}} | 수정 파일 목록 |

사용 방법

1. 템플릿 읽기

Read 도구로 템플릿 파일 읽기:
.claude/templates/task-template.md

2. 변수 값 준비

TASK_ID = "TASK-001"
TITLE = "사용자 인증 구현"
STATUS = "pending"
CREATED_AT = "2024-01-15T10:30:00"
...

3. 변수 치환

템플릿 내용에서 {{변수명}}을 실제 값으로 교체

4. 파일 생성

Write 도구로 결과 파일 저장:
./tasks/TASK-001.md

동적 콘텐츠 처리

일부 변수는 동적 생성이 필요합니다:

정형 동적 콘텐츠 (직접 생성)

{{STEPS_CONTENT}}: step-status-template 반복 적용
{{TEST_RESULT_ROWS}}: 테이블 행 생성

비정형 동적 콘텐츠 (markdown-writer-agent 활용)

{{TEST_ITEMS}}: 테스트 항목 상세 설명
{{NOTES}}: 참고사항 설명
{{STEP_DESCRIPTION}}: Step 작업 내용

워크플로우 예시

Task 파일 생성

1. task-template.md 읽기
2. 기본 변수 치환 (TASK_ID, TITLE, STATUS 등)
3. 검색 결과 삽입 (CODEBASE_SEARCH_RESULT 등)
4. Steps 생성:
   - step-status-template.md 반복 적용
   - STEPS_CONTENT에 삽입
5. 최종 파일 생성

Test Case 파일 생성

1. test-case-template.md 읽기
2. 기본 변수 치환 (TEST_ID, TASK_ID 등)
3. markdown-writer-agent spawn → TEST_ITEMS 생성
4. 결과 삽입
5. 최종 파일 생성

주의사항

템플릿 우선: 정형 콘텐츠는 항상 템플릿 사용
변수 누락 확인: 모든 {{}} 변수가 치환되었는지 확인
비정형은 위임: 복잡한 설명은 markdown-writer-agent 활용