chore: 문서를 작성할 때 한국어의 표현 작성 스킬 추가 및 1인칭 관점의 글 작성 검증 테스트 추가

2026-07-29 16:48:03 +09:00
parent c39406bbdd
commit 41501b5d06
520 changed files with 95494 additions and 2231 deletions
@@ -0,0 +1,67 @@
+# Evidence and decision provenance
+
+> This is an internal sidecar. It is not reader-facing article content.
+> Source IDs, repository paths, line ranges, status labels, and access dates belong here—not in `document.md`.
+
+- Document: **API 재시도는 횟수가 아니라 부하 예산으로 설계한다**
+- Citation rendering: `hidden`
+- Evidence sources: **3**
+
+## Section evidence map
+
+| Section | Decision contract | Evidence | Status / location |
+|---|---|---|---|
+| 코드보다 먼저 드러난 문제 | — | `S1` Timeouts, retries, and backoff with jitter | `unspecified` · https://aws.amazon.com/builders-library/timeouts-retries-and-backoff-with-jitter/ |
+| ↳ | — | `S2` RFC 9110, HTTP Semantics — Idempotent Methods | `unspecified` · https://datatracker.ietf.org/doc/html/rfc9110#section-9.2.2 |
+| ↳ | — | `S3` Retry strategy | `unspecified` · https://cloud.google.com/storage/docs/retry-strategy |
+| 문제를 어렵게 만든 제약 | — | `S1` Timeouts, retries, and backoff with jitter | `unspecified` · https://aws.amazon.com/builders-library/timeouts-retries-and-backoff-with-jitter/ |
+| ↳ | — | `S2` RFC 9110, HTTP Semantics — Idempotent Methods | `unspecified` · https://datatracker.ietf.org/doc/html/rfc9110#section-9.2.2 |
+| ↳ | — | `S3` Retry strategy | `unspecified` · https://cloud.google.com/storage/docs/retry-strategy |
+| 검토한 선택지와 막힌 지점 | 상황·제약, 선택, 선택 이유, 검토한 대안, 수용한 비용, 보완 가드레일 | `S1` Timeouts, retries, and backoff with jitter | `unspecified` · https://aws.amazon.com/builders-library/timeouts-retries-and-backoff-with-jitter/ |
+| ↳ | — | `S2` RFC 9110, HTTP Semantics — Idempotent Methods | `unspecified` · https://datatracker.ietf.org/doc/html/rfc9110#section-9.2.2 |
+| ↳ | — | `S3` Retry strategy | `unspecified` · https://cloud.google.com/storage/docs/retry-strategy |
+| 선택의 이유와 지킨 경계 | 상황·제약, 선택, 선택 이유, 검토한 대안, 수용한 비용, 보완 가드레일 | `S1` Timeouts, retries, and backoff with jitter | `unspecified` · https://aws.amazon.com/builders-library/timeouts-retries-and-backoff-with-jitter/ |
+| ↳ | — | `S2` RFC 9110, HTTP Semantics — Idempotent Methods | `unspecified` · https://datatracker.ietf.org/doc/html/rfc9110#section-9.2.2 |
+| ↳ | — | `S3` Retry strategy | `unspecified` · https://cloud.google.com/storage/docs/retry-strategy |
+| 선택이 코드와 흐름에 반영되는 방식 | — | `S1` Timeouts, retries, and backoff with jitter | `unspecified` · https://aws.amazon.com/builders-library/timeouts-retries-and-backoff-with-jitter/ |
+| ↳ | — | `S2` RFC 9110, HTTP Semantics — Idempotent Methods | `unspecified` · https://datatracker.ietf.org/doc/html/rfc9110#section-9.2.2 |
+| ↳ | — | `S3` Retry strategy | `unspecified` · https://cloud.google.com/storage/docs/retry-strategy |
+| 결정이 지켜지는지 확인하는 방법 | — | `S1` Timeouts, retries, and backoff with jitter | `unspecified` · https://aws.amazon.com/builders-library/timeouts-retries-and-backoff-with-jitter/ |
+| ↳ | — | `S2` RFC 9110, HTTP Semantics — Idempotent Methods | `unspecified` · https://datatracker.ietf.org/doc/html/rfc9110#section-9.2.2 |
+| ↳ | — | `S3` Retry strategy | `unspecified` · https://cloud.google.com/storage/docs/retry-strategy |
+| 얻은 것, 잃은 것, 적용하지 않을 때 | 상황·제약, 선택, 선택 이유, 검토한 대안, 수용한 비용, 보완 가드레일 | `S1` Timeouts, retries, and backoff with jitter | `unspecified` · https://aws.amazon.com/builders-library/timeouts-retries-and-backoff-with-jitter/ |
+| ↳ | — | `S2` RFC 9110, HTTP Semantics — Idempotent Methods | `unspecified` · https://datatracker.ietf.org/doc/html/rfc9110#section-9.2.2 |
+| ↳ | — | `S3` Retry strategy | `unspecified` · https://cloud.google.com/storage/docs/retry-strategy |
+| 결국 지키려던 것은 무엇이었나 | — | **GAP** | No allocated evidence |
+
+## Source details
+
+### `S1` Timeouts, retries, and backoff with jitter
+
+- Type: `external`
+- Status: `unspecified`
+- Location: `https://aws.amazon.com/builders-library/timeouts-retries-and-backoff-with-jitter/`
+- Public/reference URL: `https://aws.amazon.com/builders-library/timeouts-retries-and-backoff-with-jitter/`
+- Claim IDs: —
+- Decision IDs: —
+- Retrieval priority: `0.0000`
+
+### `S2` RFC 9110, HTTP Semantics — Idempotent Methods
+
+- Type: `external`
+- Status: `unspecified`
+- Location: `https://datatracker.ietf.org/doc/html/rfc9110#section-9.2.2`
+- Public/reference URL: `https://datatracker.ietf.org/doc/html/rfc9110#section-9.2.2`
+- Claim IDs: —
+- Decision IDs: —
+- Retrieval priority: `0.0000`
+
+### `S3` Retry strategy
+
+- Type: `external`
+- Status: `unspecified`
+- Location: `https://cloud.google.com/storage/docs/retry-strategy`
+- Public/reference URL: `https://cloud.google.com/storage/docs/retry-strategy`
+- Claim IDs: —
+- Decision IDs: —
+- Retrieval priority: `0.0000`