gitea-agent/harness/docs/runtime-flow/TEMPLATE.md

${runtime_flow_title}

목적과 범위

${purpose}

• 포함 범위: ${included_scope}
• 제외 범위: ${excluded_scope}
• 시작 조건: ${start_condition}
• 성공 종료 상태: ${success_terminal_state}
• 실패 종료 상태: ${failure_terminal_state}

흐름

${stable_section_id} — ${flow_name}

• 시작 이벤트: ${trigger_event}
• 선행조건: ${preconditions}
• 실행 방식: ${synchronous_or_asynchronous}
• 트랜잭션·영속성 경계: ${transaction_and_persistence_boundary}

단계 ID	실행 주체	시작 조건·입력	처리	읽기·쓰기 상태	외부 호출	성공 시 다음 단계	실패 시 전이
${step_id}	${actor_or_component}	${step_condition_and_input}	${processing}	${state_reads_and_writes}	${external_call_or_none}	${success_next_step_or_terminal}	${failure_transition_or_terminal}

실패와 복구

대상 단계	실패 조건	추가 쓰기 중단	재시도 계약	중복 방지	보상·수동 복구	최종 상태
${failed_step_id}	${failure_condition}	${stop_further_writes}	${retry_contract}	${idempotency_contract}	${compensation_or_manual_recovery}	${failure_final_state}

동시성과 순서

• 동시 실행 허용 여부: ${concurrent_execution_policy}
• 잠금·직렬화 단위: ${locking_or_serialization_scope}
• 순서 보장: ${ordering_guarantee}
• 충돌 검출·처리: ${conflict_detection_and_handling}

관찰 가능성

신호 종류	이름	발생 단계·조건	상관 식별자	진단 속성	민감정보 처리
${signal_type}	${signal_name}	${signal_step_and_condition}	${correlation_identifier}	${diagnostic_attributes}	${sensitive_data_handling}

검증

• 정상 흐름: ${success_flow_validation}
• 실패 흐름: ${failure_flow_validation}
• 경계 흐름: ${boundary_flow_validation}
• 동시성 흐름: ${concurrency_flow_validation}
• 운영 진입점과 기대 결과: ${operational_entry_point_and_expected_result}