Initialize gitea-agent harness

2026-09-29 06:59:17 +00:00
commit c05b4226bf
20 changed files with 1840 additions and 0 deletions
@@ -0,0 +1,51 @@
+# ${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}