Architecture Diagrams Readiness SKILL.md skillA

This file is byte-identical to the first copy the registry indexed. Same content hash, so the same checks give both the same grade.

Architecture Diagrams Readiness from s977043/river-review is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add s977043/river-review/Architecture Diagrams Readiness@v0.1.0

Pins 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
plugin-dist/river-review/skills/upstream/architecture-diagrams/SKILL.md
Versions recorded
1
Latest version
v0.1.0, committed Oct 25, 2026
Size
4,441 bytes
Repository stars
7
License
MIT

Ensure architecture diagrams are readable, consistent with text, and clear on scope, boundaries, and data flow.

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: アーキテクチャ図の差分から読み手の誤解を招く要因(スコープ不明・矛盾・ラベル不足)を検出する。

## Goal / 目的

- 図(C4/シーケンス/データフロー等)の差分から、読み手が迷う要因(スコープ不明、境界不明、矛盾、ラベル不足)を減らし、実装・運用に落ちる状態にする。

## Non-goals / 扱わないこと

- 図の美的センスやツール選定の議論。
- 実装詳細(クラス設計、コード構造)のレビュー。

## Pre-execution Gate / 実行前ゲート

このスキルは以下の条件がすべて満たされない限り`NO_REVIEW`を返す。

- [ ] 差分に図関連ファイル(`*diagram*`, `*c4*`, `*sequence*`, `*flow*`, `*.png`, `*.svg`)またはアーキテクチャドキュメントが含まれている
- [ ] 差分に図の構成要素(コンポーネント・矢印・境界・ラベル・フロー)の追加・変更が含まれている
- [ ] inputContextに`diff`が含まれている

ゲート不成立時の出力: `NO_REVIEW: architecture-diagrams — 図関連ファイルの変更なし`

## False-positive guards / 抑制条件

- 図が “参考図” と明記され、本文が契約の真実の源泉になっている場合は、図への要求強度を下げる。

## Rule / ルール

- 先頭に要約を 1 行出す(追加/変更された図と伝えたい決定事項の要点)。
- 指摘は最大 8 件まで。誤解につながる点(矛盾、スコープ不明、境界不明、責任不明)を優先。
- 可能なら “追記案” を付ける(図のキャプション/凡例/本文追記など)。

## Checklist / 観点チェックリスト

- スコープと前提
  - 図の対象範囲(どのサービス/境界まで含むか)が明確か。
  - 前提(運用対象/PoC、同期/非同期、テナント/リージョン等)が明示されているか。
- 境界と責務
  - 境界(サービス/モジュール/チーム)と責務のラベルがあるか。
  - 外部システム/第三者依存が明示されているか。
- データフロー/制御フロー
  - 矢印の向きと意味(request/response、publish/subscribe、read/write)が曖昧でないか。
  - 重要データ(PII 等)を扱う場合、データの流れと保存先が読み取れるか。
- 失敗時の扱い(最低限)
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add s977043/river-review/Architecture Diagrams Readiness@sha256:9870a1c9504455aa

The 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.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_e5mzak7adm2n5ubn.svg)](https://markdownregistry.com/a/art_e5mzak7adm2n5ubn)

0 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 1 version of this file, committed on Oct 25, 2026.

versioncommittedcommitsizeaudit
v0.1.0 latest2026-10-25 aac3ee8 4,441 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (4441 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

GitHub

s977043/river-review · 7 stars · license MIT · pushed 2026-11-08 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_e5mzak7adm2n5ubn
GET https://markdownregistry.com/api/v1/resolve?ref=s977043/river-review/Architecture Diagrams Readiness
GET https://markdownregistry.com/api/v1/blob/9870a1c9504455aa3309b4615de71680b19a21aee4e74e62346ba0ad3097a13d

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.

More from s977043/river-review

ask-codex SKILL.md skill
s977043/river-review · .claude/skills/ask-codex/SKILL.md · Get a second opinion or independent review from Codex (OpenAI) via the local Codex CLI. Use when the user wants Codex…
git:20260724.d54eafd · audit A · 7 stars
river-review-discipline SKILL.md skill
s977043/river-review · .claude/skills/river-review-discipline/SKILL.md · AI 駆動開発のレビュー品質を安定化させるレビュー規律。レビュー対象を分類し、要件・設計・差分・検証・報告を分けて見て、根拠に基づき approved / needs_revision / blocked / rejected…
git:20260707.9c35a5d · audit A · 7 stars
skill-creator SKILL.md skill
s977043/river-review · .claude/skills/skill-creator/SKILL.md · Design a new Claude Code skill from a concrete use case and produce a repo-ready skill package. Use when the user asks…
git:20261004.95d1f7a · audit A · 7 stars
skill-ops-planner SKILL.md skill
s977043/river-review · .claude/skills/skill-ops-planner/SKILL.md · Create an operating policy and roadmap for a live portfolio of Claude Code skills. Use when the user asks to organize…
git:20260321.857d5ca · audit A · 7 stars
skill-optimizer SKILL.md skill
s977043/river-review · .claude/skills/skill-optimizer/SKILL.md · Evaluate and improve an existing Claude Code skill using explicit success criteria and small controlled changes. Use…
git:20261004.95d1f7a · audit A · 7 stars
AGENTS.md@.codex AGENTS.md file
s977043/river-review · .codex/AGENTS.md
git:20260923.5650e78 · audit A · 7 stars
AGENTS.md AGENTS.md file
s977043/river-review · AGENTS.md
git:20261008.d74129b · audit B · 7 stars
CLAUDE.md CLAUDE.md file
s977043/river-review · CLAUDE.md
git:20261016.787c99c · audit A · 7 stars
Sample Architecture Consistency Review SKILL.md skill
s977043/river-review · examples/skills/architecture-sample/SKILL.md · Checks design/ADR docs for consistency and missing decisions.
v0.1.0 · audit A · 7 stars
Sample Code Quality Pass SKILL.md skill
s977043/river-review · examples/skills/code-quality-sample/SKILL.md · Checks common code quality and maintainability risks.
v0.1.0 · audit A · 7 stars
Sample Test Coverage Review SKILL.md skill
s977043/river-review · examples/skills/test-review-sample/SKILL.md · Evaluates downstream tests for coverage and edge cases.
v0.1.0 · audit A · 7 stars
adversarial-review SKILL.md skill
s977043/river-review · plugin-dist/river-review/skills/agent-skills/adversarial-review/SKILL.md · 敵対的分析手法を統合したレビューの entry skill。認知バイアス対策の3手法 (Pre-mortem / War Game / Logic Torturing)と、宣言・主張と実態の乖離を突く claim-vs-actual…
v0.1.0 · audit A · 7 stars

Every file in s977043/river-review

Other files named Architecture Diagrams Readiness

Architecture Diagrams Readiness SKILL.md skill
s977043/river-review · skills/upstream/architecture-diagrams/SKILL.md · Ensure architecture diagrams are readable, consistent with text, and clear on scope, boundaries, and data flow.
v0.1.0 · audit A · 7 stars

Browse by kind, by grade A, or by owner.