majiayu000 ドキュメント管理
ADR、スキル、ルールのドキュメント生成ワークフロー。
目的
個々のコマンドに埋め込まれていたドキュメントワークフローパターンを集約。 コマンドはドキュメントロジックのためにこのスキルを参照する薄いオーケストレーターとなる。
ワークフローリファレンス
| ワークフロー | リファレンス | コマンド |
|---|---|---|
| ADR作成 | @../../skills/managing-documentation/references/adr-workflow.md | /adr |
| Rulify | @../../skills/managing-documentation/references/rulify-workflow.md | /rulify |
クイックリファレンス
ADR (Architecture Decision Record)
MADRフォーマット (Markdown Any Decision Record):
# ADR-NNNN: [タイトル]
## Status
Proposed | Accepted | Deprecated | Superseded
## Context
[課題は何か？]
## Decision
[決定は何か？]
## Consequences
[結果は何か？]
ADR番号付け
場所: ~/.claude/adr/
フォーマット: ADR-NNNN-title.md
次の番号: 既存ファイルから自動検出
Rulifyフロー
ADR (決定) → Rule (強制) → CLAUDE.md (統合)
1. ADRの内容を読み込み
2. 強制可能なルールを抽出
3. rules/にルールファイルを生成
4. CLAUDE.mdの参照を更新
ドキュメントガイドライン
| 原則 | 適用 |
|---|---|
| 明確性 > 完全性 | オッカムの剃刀を適用 |
| EN/JP同期 | 両バージョンは一致必須 |
| 循環参照禁止 | 最大3レベル深さ |
| Mermaid > ASCII | Mermaid図を使用 |
テンプレート
ADRテンプレート
~/.claude/templates/adr/madr-template.md
ルールテンプレート
~/.claude/templates/rules/rule-template.md
参照
原則 (rules/)
- @../../rules/conventions/DOCUMENTATION.md - ドキュメントガイドライン
- @../../rules/conventions/TRANSLATION.md - 翻訳ルール
関連スキル
creating-adrs- ADR作成の基本
使用元コマンド
/adr- ADR作成/rulify- ADRからルール生成