Skills · Claude Code · Agent Skills
ドキュメントは Done の一部 — 妥協なし。
CI でテストされる docs-as-code、本物の決定ごとの ADR、コードから生成される API ドキュメント、そしてすべてがアーカイブと索引に永続化。壊れたドキュメントはバグ。
schematize-docs · v0.1.0bash
$ schematize install docs譲れない基準
「速くするため」に無効化しない。完全な一覧はスキルに。
ドキュメントは DoD の一部
ドキュメントは Definition of Done に入る。仕上げのおまけではない。
決定ごとに ADR
関連するアーキテクチャ上の決定はすべてバージョン管理された ADR になる：proposed → accepted/rejected。孤立した proposed は残さない。
docs-as-code、CI でテスト
ドキュメントはリポジトリに置かれ、PR でレビューされ、テストされる — 開くリンク、動く例、コンパイルできるスニペット。壊れたドキュメントはバグ。
コードから生成
可能な限りコードから生成した OpenAPI 3.1 の API ドキュメント。breaking change を記録した changelog + SemVer。
アーカイブと索引に永続化
すべてはアーカイブと索引/MAP に着地する — 監査と overdev が消費する痕跡。ルートは清潔に保つ。
明確で最小限
誰も読まないドキュメントは資産ではなく負債 — 役に立たないものは削る。
コマンド
.claude/commands/ にインストール。いつでも /docs-help を実行。
/docs-adrdocs/adr/ に ADR を作成または移行（proposed → accepted/rejected）。文脈/決定/代替案/結果を記す。孤立した proposed は残さない。/docs-api可能な限りコードから API ドキュメント（OpenAPI 3.1/契約）を生成/検証し、仕様と実装のドリフトをチェックし、changelog + SemVer を管理。/docs-ccContext compact：コンテキストとチェックリストをアーカイブに書き出し、/compact を実行。/docs-claude常時オンの docs CLAUDE.md をルートに作成またはマージ（他スキルのブロックは上書きしない）。/docs-handoffコンパクトせずにコンテキストの handoff を作成 — セッション終了やタスク切り替え。/docs-helpすべてのコマンドを一覧表示。/docs-load規範全体を強制読み込み：規律、ADR、runbook、API/バージョニング、索引/図。/docs-runbookサービス/インシデント向けの運用 runbook を scaffold/更新（症状 → 診断 → アクション → 検証 → ロールバック → エスカレーション）。AI エージェント向け
人手を介さずにインストール。メタデータは llms.txt。
- 実行: git clone https://github.com/schematizeme/skill-docs.git && ./skill-docs/install.sh
- またはダウンロード: https://github.com/schematizeme/skill-docs/releases/latest/download/skill-docs.zip を .claude/skills/ に展開
- assets/CLAUDE.md をリポジトリのルートにコピー（常時オンのルール）。
- /docs-help で確認。
ディスカッション
読み込み中…