---
description: "自動運用システム対応のCLAUDE.mdを生成し、ADR管理体制を構築します"
allowed_tools: ["Read", "Write", "Glob", "Grep", "Bash", "LS"]
---
# 自動運用対応CLAUDE.md生成
プロジェクトを分析し、自動初期化・更新・チェック機能を備えたCLAUDE.mdを生成します。また、Architecture Decision Records (ADR) の管理体制も同時に構築します。
## 実行手順
### 1. プロジェクト分析
```bash
# プロジェクトルートの確認
!pwd
!ls -la
# 言語・フレームワーク検出
!find . -maxdepth 2 -name "package.json" -o -name "requirements.txt" -o -name "go.mod" -o -name "Cargo.toml" -o -name "pom.xml" -o -name "build.gradle" | head -10
```
### 2. 主要ファイルの読み込み
- @package.json (Node.jsプロジェクトの場合)
- @pyproject.toml または @requirements.txt (Pythonプロジェクトの場合)
- @README.md (プロジェクト概要把握)
- @.gitignore (プロジェクト構造理解)
### 3. プロジェクト構造の分析
```bash
# ソースコードディレクトリの特定
!find . -type d -name "src" -o -name "app" -o -name "lib" -o -name "pkg" | grep -v node_modules | head -10
# テストディレクトリの確認
!find . -type d -name "test" -o -name "tests" -o -name "__tests__" -o -name "spec" | grep -v node_modules | head -10
# ADRディレクトリの確認
!find . -type d -name "adr" -o -name "ADR" -o -name "decisions" | grep -v node_modules | head -5
```
### 4. 開発コマンドの抽出
- package.jsonのscriptsセクション
- Makefile のターゲット
- docker-compose.yml のサービス
### 5. ADR管理体制の構築
```bash
# docs/adrディレクトリが存在しない場合は作成
!mkdir -p docs/adr
```
以下のファイルを生成:
#### docs/adr/README.md
- ADRの概要と管理方法
- ファイル命名規則 (NNNN-title-with-dashes.md)
- ADR一覧テーブル
#### docs/adr/template.md
- 標準ADRテンプレート（Status, Context, Decision, Consequences）
- 日本語対応
#### 初回ADR（必要に応じて）
- プロジェクトの主要技術選定に関するADRを自動生成
### 6. CLAUDE.md生成
以下の内容を含む自動運用対応のCLAUDE.mdを生成:
```markdown
# CLAUDE.md
This file provides guidance to Claude Code when working with this repository.
## 🤖 Auto-Maintenance Mode
This CLAUDE.md is configured for automatic maintenance. Claude will:
- Detect when this file needs updates
- Propose changes when project structure changes
- Keep documentation synchronized
### Self-Update Triggers
- Package dependency changes
- New directories or files patterns
- Command modifications in package.json
- ADR additions in docs/adr/
### Quick Commands
- Say "update CLAUDE.md" to refresh this file
- Say "check CLAUDE.md" to verify accuracy
- Say "sync docs" to update all documentation
[以下、検出した情報に基づく内容]
## Project Overview
[自動検出した内容]
## Development Commands
[抽出したコマンド一覧]
## Architecture
[検出した技術スタック]
## Project Structure
[分析したディレクトリ構造]
├── docs/
│ └── adr/
│ ├── README.md
│ ├── template.md
│ └── NNNN-*.md
## Architecture Decision Records (ADRs)
### Recent Decisions
[ADR一覧を自動生成]
### ADR Management
- Location: `docs/adr/`
- Template: `docs/adr/template.md`
- Naming: `NNNN-title-with-dashes.md`
## 🔄 Automatic Updates
### File Watch List
[監視対象ファイル一覧]
- docs/adr/*.md
### Update Rules
[自動更新ルール]
- ADR追加時の自動検出と更新
```
## ADRテンプレートの内容
生成されるADRテンプレート (docs/adr/template.md):
```markdown
# ADR-NNNN: [決定のタイトル]
## Status
[Proposed | Accepted | Deprecated | Superseded]
## Context
[決定が必要となった背景と状況の説明]
## Decision
[採用した解決策とその理由の説明]
## Consequences
### Positive（メリット）
- この決定によるメリット
### Negative（デメリット・リスク）
- コストやリスク
### Neutral（中立的な影響）
- その他の影響
---
**Date**: YYYY-MM-DD
**Author**: [決定者/記録者]
```
使用例: `/claude-auto-init`
<!-- このコマンドの機能:
- プロジェクト構造とフレームワークの自動検出
- package.json/README.md等の主要ファイル分析
- 開発コマンドとスクリプトの抽出
- 自動更新機能付きCLAUDE.mdの生成
- docs/adr/ディレクトリとADR管理体制の構築
- ADRテンプレートとREADMEの自動生成
- ファイル監視とトリガー設定の自動化
- プロジェクト固有の初回ADR作成 -->