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,73 @@
+# ${interface_contract_title}
+
+## 목적과 범위
+
+${purpose}
+
+- 포함 범위: ${included_scope}
+- 제외 범위: ${excluded_scope}
+- 사용 주체: ${consumers}
+
+## 계약
+
+### ${stable_section_id} — ${interface_name}
+
+- 책임: ${responsibility}
+- 종류·프로토콜: ${interface_type_and_protocol}
+- 호출 대상·operation: ${target_and_operation}
+- 버전: ${version}
+- 호출 주체: ${caller}
+- 인증 방식: ${authentication}
+- 필요 권한: ${authorization}
+
+#### 입력
+
+| 필드 | 위치 | 타입 | 필수 여부 | 기본값 | 허용 값·형식 | 의미 | 민감정보 |
+|---|---|---|---|---|---|---|---|
+| `${input_field_name}` | ${input_location} | `${input_type}` | ${input_required_or_optional} | ${input_default_or_none} | ${input_constraints} | ${input_meaning} | ${input_sensitivity_or_none} |
+
+#### 출력
+
+| 필드 | 위치 | 타입 | 필수 여부 | 허용 값·형식 | 의미 | 민감정보 |
+|---|---|---|---|---|---|---|
+| `${output_field_name}` | ${output_location} | `${output_type}` | ${output_required_or_optional} | ${output_constraints} | ${output_meaning} | ${output_sensitivity_or_none} |
+
+#### 오류
+
+| 코드 | 분류 | 발생 조건 | 재시도 가능 여부 | 호출자 대응 | 실패 시 상태 변경 |
+|---|---|---|---|---|---|
+| `${error_code}` | ${error_class} | ${error_condition} | ${retryability} | ${caller_action} | ${state_change_or_none} |
+
+## 호환성
+
+- 유지할 기존 호출 방식: ${existing_call_compatibility}
+- 버전 변경 정책: ${versioning_policy}
+- 폐기 정책: ${deprecation_policy}
+- 재시도 계약: ${retry_contract}
+- 중복 처리 계약: ${idempotency_contract}
+- 순서 보장: ${ordering_guarantee}
+
+## 예시
+
+### ${example_id} — ${example_title}
+
+- 대상 인터페이스: `${target_interface_id}`
+
+#### 호출
+
+```text
+${request_or_call_example}
+```
+
+#### 결과
+
+```text
+${response_or_result_example}
+```
+
+## 검증
+
+- 정상 계약: ${success_contract_validation}
+- 실패 계약: ${failure_contract_validation}
+- 경계 계약: ${boundary_contract_validation}
+- 구현·스키마·예시 정합성: ${implementation_schema_example_consistency}