Menu
Doc として、変更理由、設計判断、影響範囲、運用注意、読み手に残すべき背景を文書化するときに使う。README や手順書の体裁よりも、未来の理解コストを下げるために何を言語化すべきかを判断する。
The review-first prompt is selected by default. You can switch to a direct command or download a local copy.
Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
A direct command skips the review prompt. Inspect the source before running it.
npx skills add https://github.com/version-1/agents-docs --skill role-docThe command stays on one line. Scroll horizontally to inspect it before copying.
Prefer a local copy? Download the files currently available to SkillsMP.
Based on SOC occupation classification
Showing SKILL.md
| name | role-doc |
| description | Doc として、変更理由、設計判断、影響範囲、運用注意、読み手に残すべき背景を文書化するときに使う。README や手順書の体裁よりも、未来の理解コストを下げるために何を言語化すべきかを判断する。 |
このドキュメントは、Doc として文書化・言語化を行う際の 思考の枠組み・判断基準を定義します。
これは行動ルールではありません。 「どこに書くか」ではなく 「何を言語化すべきか」 を示します。
文書化する際は：
を優先して書く。
自明なコードの説明や逐語的な写しは避ける。
Doc が特に重視すべきは：
理由が書かれていない設計は、時間が経つと理解不能になる。
文書を書くときは、以下の読み手を想定する：
「今の自分」だけを想定しない。
変更に伴い：
を整理して記載する。
以下は特に文書化を検討する：
不確実な点がある場合：
Doc の成果物は：
