documentation-criteria SKILL.md skillA

documentation-criteria from shinpr/ai-coding-project-boilerplate is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

mdr add shinpr/ai-coding-project-boilerplate/documentation-criteria@git:20260923.86a3d79

Pins git:20260923.86a3d79 in mdr.lock. Pin the fingerprint instead.

Audit grade

A, 17 of 17 checks passed

Kind

SKILL.md skill

Repository

shinpr/ai-coding-project-boilerplate

Path

.claude/skills-ja/documentation-criteria/SKILL.md

Versions recorded

5

Latest version

git:20260923.86a3d79, committed Sep 23, 2026

First version recorded

Aug 28, 2026

Size

7,428 bytes

Repository stars

234

License

MIT

変更に必要なPRD、ADR、UI Spec、Design Doc、作業計画書と、それぞれの保存先を判定する。ドキュメントの範囲を決める時、または技術ドキュメントを作成・レビューする時に使用。.

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

# ドキュメント作成基準

このスキルはドキュメントの振り分け、すなわち変更に伴って記録すべき、後続作業に長く影響する判断と各ドキュメントの保存先を定める。各ドキュメントの内容と構造の要件は、「保存場所」からリンクされた各テンプレートが定める。

## 各ドキュメントで確定すること

- **PRD** — 後続作業のトレーサビリティの基点となるビジネス成果、現時点の要件、対象外、受入条件を確定する。AC IDは設計と検証で使う安定したトレーサビリティキーとする。実装設計はDesign Doc、技術的な選択肢の決定はADR、タスクの順序は作業計画書に記載する
- **ADR** — 後続作業に長く影響する技術判断を1つと、それが退けた実質的に異なる選択肢を記録し、後続作業が承認済みの判断と偶発的な実装を区別できるようにする。`Accepted` は現時点で選ばれている手段を記録したものであり、維持する義務ではない。確認済みの成果、将来状態の要件、対象外を維持したまま、より小さく十分な選択を後のエビデンスが支持する場合は、そのADRを更新または置き換える。完全な実装設計はDesign Docに記載する
- **UI Spec** — 実装前に画面構造、遷移、コンポーネントと状態の契約、インタラクション、ビジュアル受入条件を記録する。これらの判断が未確定の場合に限って作成する。承認済みのUI Specがある場合は再利用し、リポジトリの代表的なエビデンスから判断できる場合はDesign Docへ進む
- **Design Doc** — 確認済みスコープに対する完全な実装設計として、責務、フロー、契約、変更影響、検証境界を記録する。実装では主要な技術基準として扱い、不足している実現方法を黙って作り出さない。リポジトリのエビデンスによって技術的な実現方法が成立しないと分かった一方で、確認済みの成果、将来状態の要件、対象外を維持できる場合は、プロダクト要件を再検討せず、担当するワークフローで実装と影響を受ける技術成果物を修正する
- **作業計画書** — 依存順序、タスク境界、実行可能な検証、最初に有用な証明を得る地点を確定する。設計詳細は再掲せず参照する
- **タスクファイル** — 作業計画書の実行可能な成果1つについて、根拠となる情報源、調査の開始地点、書き込み責務、観測可能な検証を実装へ引き継ぐ

## 作成判定マトリクス

| 構造スケール | 基本ドキュメント | 作成順序 |
|-------------|----------------|---------|
| 小規模 | なし | 直接実装 |
| 中規模 | Design Doc、作業計画書 | Design Doc -> 作業計画書 |
…

Read the whole file at its exact version.

How to install

mdr add shinpr/ai-coding-project-boilerplate/documentation-criteria@sha256:bb182be17f72cfff

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

Versions

The registry has recorded 5 versions of this file, between Aug 28, 2026 and Sep 23, 2026, about one every 6 days.

Audit of the latest version

Source

API

GET https://markdownregistry.com/api/v1/artifacts/art_62wnzu2mqkt7kygj
GET https://markdownregistry.com/api/v1/resolve?ref=shinpr/ai-coding-project-boilerplate/documentation-criteria
GET https://markdownregistry.com/api/v1/blob/bb182be17f72cfff5ecd06448080379f4be24c84e08d2ec84b2d4e124108612d

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 shinpr/ai-coding-project-boilerplate

Every file in shinpr/ai-coding-project-boilerplate

Other files named documentation-criteria

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