cga-docs-update

name: cga-docs-update
description: |
コード変更に伴うドキュメント更新を提案・実行。git diff main..HEADを分析し、doc/domain/・doc/decisions/の更新が必要な箇所を特定して提案。ユーザー確認後に更新を実行。
Analyze code changes and propose/update documentation in doc/domain/ and doc/decisions/. Use when preparing PR, completing feature work, or ensuring doc-code consistency. Trigger: "update docs", "sync documentation", "check doc consistency".
allowed-tools: Bash Read Glob Grep Edit AskUserQuestion

いつ使うか

• フィーチャーブランチの作業が一段落したとき
• PRを作成する前
• mainへマージする前のドキュメント整合性チェック

何をするか

1. git diff main..HEAD でコード変更を分析
2. 影響を受けるドキュメントを特定し、更新を提案
3. ユーザー確認後、更新を実行

対象ドキュメント

doc/domain/（ユーザーストーリー・語彙）

doc/decisions/（意思決定記録）

使用例

このスキルを発動する例:
- "ドキュメントを更新して"
- "Update documentation for my changes"
- "/cga-docs-update"
- "doc/domain/の進捗率を更新したい"
- "PRを出す前にドキュメントチェックして"

発動しない例（他のスキルを使うべき）:
- "新しいDRを作りたい" → /cga-decision-record を使用
- "スキルのドキュメントを更新" → .claude/skills/は対象外

ワークフロー位置

フィーチャー実装 → /cga-docs-update → PR作成
                      ↓
            doc/domain/, doc/decisions/ を更新

関連スキル:
- /cga-decision-record - 新規DR作成（技術選定やドメインルール記録）
- /cga-programming - 実装実行（ドキュメント更新の前段階）

Troubleshooting

よくある問題

"変更がないのに更新提案される"
- git diff main..HEADで差分を確認してください
- mainブランチとの差分がない場合、スキルは何も提案しません

"更新すべき箇所が提案されない"
- 対象ディレクトリ: doc/domain/、doc/decisions/のみ
- .claude/skills/の更新は対象外
- コード変更とドキュメントのマッピングを確認

"提案内容が過剰/不足している"
- スキルは実装状況との差分のみ提案します
- 未実装の機能を完了にマークすることはありません

"更新後にコンフリクトが発生"
- 更新前にmainブランチを最新化してください: git pull origin main
- 手動マージが必要な場合があります

詳細

guide.md を参照