Agent skill

managing-documentation

ドキュメント生成ワークフロー:ADR作成、スキル生成、ルール生成。 技術ドキュメントのためのテンプレートとプロセスを提供。 トリガー: ADR, documentation, architecture decision, rulify, skill generation, MADR。

Stars 163
Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/other/managing-documentation

SKILL.md

ドキュメント管理

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):

markdown
# ADR-NNNN: [タイトル]

## Status

Proposed | Accepted | Deprecated | Superseded

## Context

[課題は何か?]

## Decision

[決定は何か?]

## Consequences

[結果は何か?]

ADR番号付け

text
場所: ~/.claude/adr/
フォーマット: ADR-NNNN-title.md
次の番号: 既存ファイルから自動検出

Rulifyフロー

text
ADR (決定) → Rule (強制) → CLAUDE.md (統合)

1. ADRの内容を読み込み
2. 強制可能なルールを抽出
3. rules/にルールファイルを生成
4. CLAUDE.mdの参照を更新

ドキュメントガイドライン

原則 適用
明確性 > 完全性 オッカムの剃刀を適用
EN/JP同期 両バージョンは一致必須
循環参照禁止 最大3レベル深さ
Mermaid > ASCII Mermaid図を使用

テンプレート

ADRテンプレート

text
~/.claude/templates/adr/madr-template.md

ルールテンプレート

text
~/.claude/templates/rules/rule-template.md

参照

原則 (rules/)

  • @../../rules/conventions/DOCUMENTATION.md - ドキュメントガイドライン
  • @../../rules/conventions/TRANSLATION.md - 翻訳ルール

関連スキル

  • creating-adrs - ADR作成の基本

使用元コマンド

  • /adr - ADR作成
  • /rulify - ADRからルール生成

Expand your agent's capabilities with these related and highly-rated skills.

Didn't find tool you were looking for?

Be as detailed as possible for better results