Failure Modes & Observability in Design SKILL.md skillA
Failure Modes & Observability in Design from s977043/river-review is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add s977043/river-review/Failure Modes & Observability in Design@v0.1.0Pins v0.1.0 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- s977043/river-review
- Path
skills/upstream/failure-modes-observability/SKILL.md- Versions recorded
- 3
- Latest version
- v0.1.0, committed Jul 19, 2026
- First version recorded
- Jun 29, 2026
- Size
- 3,903 bytes
- Repository stars
- 7
- License
- MIT
Ensure designs specify failure modes, timeouts, error contracts, and observability for critical flows.
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
## Pattern declaration Primary pattern: Reviewer Secondary patterns: Inversion Why: 設計の差分から失敗モード・エラー契約・観測性の抜けをレビューし、障害シナリオを逆照射してクリティカルフローの堅牢性を検証する。 ## Rule / ルール - クリティカルフロー（認証、課金、データ保存など）の**失敗モード**（タイムアウト、リトライ、フォールバック、外部障害、権限不備）を明示する。 - エラー応答（ステータス、エラーコード、message/detail）の**契約**を一貫させ、クライアントが判断できる形にする。 - SLO/監視、ログ、メトリクス、トレースなどの**観測性**を設計に含める。 ## Heuristics / 判定の手がかり - 外部依存（DB/HTTP/Queue）の失敗時に「何が起きるか」が仕様に無い（例: リトライ方針、タイムアウト、冪等性）。 - 4xx/5xx の使い分け、エラー構造がエンドポイントごとに不揃い。 - Rate limit / backoff / circuit breaker の前提があるのに、設計/ADR で触れられていない。 - 障害時の切り分けに必要なログ（相関ID、requestId、重要な属性）やメトリクスの設計が無い。 ## Questions / 確認質問（不明な場合は質問として出す） - 代表的な失敗モード（タイムアウト、外部 5xx、バリデーション、権限、競合）はどれですか？ - 冪等性キーやリトライ可否の判断はどこで担保しますか？ - 監視対象（SLO、エラーバジェット、アラート条件）はありますか？ ## Actions / 改善案 - タイムアウト値、リトライ回数、バックオフ、フォールバックを ADR/設計に追記する。 - エラー応答の共通スキーマ（code/message/detail/requestId など）を定義し、例を載せる。 - クリティカルフローに相関IDを付与し、ログ/トレースのキーを設計に含める。 ## Non-goals / 扱わないこと - 実際の監視基盤やアラート運用の構築。 - 既存プロダクション障害の原因究明。 - 実装詳細（ログライブラリ選定など）の決定。 ## Pre-execution Gate / 実行前ゲート このスキルは以下の条件がすべて満たされない限り`NO_REVIEW`を返す。 - [ ] 差分にAPI定義・ルート定義・設計ドキュメントのいずれかが含まれている - [ ] inputContextにdiffが含まれている …
Read the whole file at its exact version.
How to install
mdr add s977043/river-review/Failure Modes & Observability in Design@sha256:98d0b00d7e4ceecaThe line at the top of this page pins the label v0.1.0, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
[](https://markdownregistry.com/a/art_ijvhcifchhacakwu)
4 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 3 versions of this file, between Jun 29, 2026 and Jul 19, 2026, about one every 10 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| v0.1.0 latest | 2026-07-19 | 6e21e08 | 3,903 B | A | view · diff |
| v0.1.0 | 2026-06-29 | 45e66bc | 3,908 B | A | view · diff |
| v0.1.0 | 2026-06-29 | b988700 | 3,924 B | A | view |
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (3903 bytes)
- pass: No zero-width or bidi control characters
- pass: No instruction hidden inside an HTML comment
- pass: No link to an exfiltration or paste host
- pass: No credential-shaped string
- pass: No instruction to send local credentials anywhere
- pass: No text hidden with inline styles
- pass: No prompt-injection phrasing
- pass: No curl or wget piped into a shell
- pass: No recursive delete of root, home or parent
- pass: No instruction to read or print local credentials
- pass: No base64 blob over 200 characters
- pass: No link to a raw IP address
- pass: No script tag
Source
s977043/river-review · 7 stars · license MIT · pushed 2026-11-08 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_ijvhcifchhacakwu GET https://markdownregistry.com/api/v1/resolve?ref=s977043/river-review/Failure Modes & Observability in Design GET https://markdownregistry.com/api/v1/blob/98d0b00d7e4ceeca550c7cbda8d6a57b42c753d64838c6d5cff3fbe3ddc376d2
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.