claude codeのルール設定を毎回やるのが面倒だったので、テンプレートとして使えるようにしました。仕様ドリブン、ファイル保護、自動日本語翻訳、カスタムスラッシュコマンド自体を作るカスタムスラッシュコマンド、などいったん思いつく限りのことは入れられたんじゃないかと思います。
レポジトリ
やれること
- 仕様ドリブンで開発できます、仕様書、詳細仕様書、テスト設計も書いてくれます
- ドキュメント作ると日本語翻訳まで自動で作ってくれます
- 長いステップでも実行ログを残すので仕様から実装、テストの途中でPCが落ちても再開がスムーズです
- カスタムスラッシュコマンドに寄せたのでclaude.mdが軽量になっていてコンテキストを圧迫しません
- ロック機能で確認済みのファイルを保護できます
- 機能追加のときに自動でfeatureブランチを切ってくれます
- claudecodeがプロジェクト内のファイルのみ修正できるように境界線を設定しています
- 一般的なセキュリティチェックをtodoの実行のなかで実施します
注意点
上記の機能はカスタムスラッシュコマンドで各作業を実行したときにのみ動作します、プロンプトにフリー会話で指示しても上記の効果はないのでご注意ください。
作ってみての雑感
- 生成AI駆動の開発だと大量のプルリクがくるのでモノレポはこの先なくなるんでないか？
- カスタムスラッシュコマンドの網羅的なテスト手法がわからない、毎回resetして検証？長いTodoの検証とかできるのとか？
- 実装コードの品質チェックについてはこれからやらないといけない、ただクリーンコードについて意思、戦略のない自分がAIにコード記述方針示せるのか？とりあえずリーダブルコードでも読んどくか
- 話題の複数AI人格に同時作業させる系はGitHub上で親レポジトリからIssueを上げてSubModule側でClaudeCodeのAPIを呼び出す形で試そうと思ってる、もろもろレポジトリ構成しないといけないので初動では動かない、ローカル並行AI駆動はそのうち考える
- MCPサーバは試すのもうちょっと後になりそう
- ながなが生成AIと付き合ってると生成AI使ったプロダクト作りたくなる、推論モデルのGPU借りたい
- 見過ごされがちだけど回答が正しくなくてもいいってのが生成AIプロダクトの革命的なとこだと思う
以下日本語のReadmeです
Claude Code スターターテンプレート
最終更新: 2025-08-14 | バージョン: 1.0
セキュリティ制御、ファイルロック、カスタムコマンド、バイリンガルドキュメント対応を備えたClaude Code用の包括的なスターターテンプレート。
機能
- 🔒 ファイルロックシステム - 重要なファイルの誤修正を防止
- 🛡️ プロジェクト境界保護 - Claude Codeはプロジェクトディレクトリ内でのみ動作
- 📝 カスタムスラッシュコマンド - プロジェクト固有のコマンドでClaude Codeを拡張
- 🌐 バイリンガルドキュメント - 自動的な英語/日本語ドキュメント生成
- 🔐 セキュリティ統合 - 組み込みの脆弱性スキャンとpre-commitフック
- 📋 機能開発プロセス - 構造化された6フェーズ開発ワークフロー
クイックスタート
1. リポジトリのクローン
git clone <repository-url>
cd claude-code-starter
2. プロジェクト設定のセットアップ
ローカル環境をセットアップするコマンドを実行：
/setup
これにより以下が実行されます：
- 設定テンプレートをコピーし、ローカル環境のパスに置換
- 必要なディレクトリ構造を作成
- ロック設定を初期化
- 機密ファイルのGit除外を設定
3. セットアップの確認
セットアップが成功したことを確認：
/setup --check
コアカスタムコマンド
/setup - プロジェクトセットアップ
ローカルパスでプロジェクト設定をセットアップまたはリセット。
/setup # 初回セットアップ
/setup --reset # 強制再初期化
/setup --check # 設定確認
/lock - ファイル保護
誤修正を防ぐためのファイルロック管理。
/lock add src/core/auth.js "認証ロジック確定"
/lock remove src/core/auth.js
/lock list
/lock check src/core/auth.js
/security - セキュリティ管理
セキュリティスキャンの実行と脆弱性管理。
/security check # 脆弱性スキャン
/security fix # 自動修正（ロックを尊重）
/security report # セキュリティレポート生成
/security setup # pre-commitフック設定
/feature - 機能開発
構造化された6フェーズプロセスによる機能管理。
/feature phase0 user-auth # 機能ブランチ初期化
/feature phase1 user-auth # 要件定義
/feature phase2 user-auth # 設計作成
/feature phase3 user-auth # テスト設計
/feature phase4 user-auth # タスク分解
/feature phase5 user-auth # 実装（ロックチェック）
/feature phase6 user-auth # 検証とドキュメント化
/doc - ドキュメント管理
バイリンガルドキュメントの自動作成。
/doc guide ./doc/guide/api.md # ガイドドキュメント作成
/doc readme ./components/auth # コンポーネントREADME作成
/doc spec ./doc/specs/api-v2.md # 仕様書作成
/command - カスタムコマンド管理
カスタムスラッシュコマンドの作成と管理。
/command create deploy project # 新規コマンド作成
/command update deploy # 既存コマンド更新
/command list # 全コマンド一覧
/command delete old-command # コマンド削除
プロジェクト構造
claude-code-starter/
├── .claude/
│ ├── settings.json # ローカル設定（git除外）
│ ├── settings.template.json # 設定テンプレート
│ ├── README.md # セットアップ手順
│ └── commands/ # カスタムスラッシュコマンド
│ ├── init.md
│ ├── lock.md
│ ├── security.md
│ ├── feature.md
│ ├── doc.md
│ └── command.md
├── .claudelock # ファイルロック設定
├── .gitleaksignore # セキュリティスキャン除外
├── doc/
│ ├── guide/ # 英語ドキュメント
│ │ ├── development-process.md
│ │ ├── security.md
│ │ ├── git.md
│ │ ├── document.md
│ │ └── project-boundaries.md
│ └── jp/ # 日本語ドキュメント
│ └── doc/guide/ # ミラー構造
├── features/ # 機能開発ワークスペース
│ └── .gitkeep
├── CLAUDE.md # Claude Code指示書
└── README.md # このファイル
セキュリティ機能
ファイルロック
重要なファイルの誤修正を防止：
- 個別ファイルまたはパターンでロック
- 修正前の自動ロックチェック
- セキュリティ修正のための上書き保護
プロジェクト境界
Claude Codeをプロジェクトディレクトリに制限：
- プロジェクトルート外のファイル修正不可
- システムファイル変更からの保護
- 個人用Claudeコマンドのみ例外
脆弱性スキャン
統合セキュリティチェック：
- 依存関係の脆弱性スキャン
- gitleaksによるシークレット検出
- セキュリティ用pre-commitフック
- 自動セキュリティレポート
設定
設定管理
ユーザー固有のパスをコミットしないためのテンプレート管理：
-
テンプレート:
.claude/settings.template.json（Gitにコミット） -
ローカル:
.claude/settings.json（git除外） -
セットアップ:
/setupでローカル設定を作成
ロック設定
.claudelockでファイルロックを管理：
locked_files:
- path: "src/core/auth.js"
reason: "認証ロジック確定済み"
locked_by: "user"
locked_patterns:
- pattern: "*.min.js"
reason: "圧縮ファイルは直接編集不可"
ベストプラクティス
1. 必ず最初にセットアップ
クローン後すぐに/setupを実行してローカルパスを設定。
2. 重要ファイルのロック
/lockを使用して確定済みまたは機密ファイルを保護。
3. 機能プロセスに従う
構造化された開発のため/featureフェーズを使用：
- フェーズ0: セットアップ
- フェーズ1: 要件
- フェーズ2: 設計
- フェーズ3: テスト設計
- フェーズ4: タスク分解
- フェーズ5: 実装
- フェーズ6: 検証
4. ドキュメントの維持
常に/docコマンドでバイリンガルドキュメントを作成。
5. 定期的なセキュリティチェック
コミットとデプロイ前に/security checkを実行。
トラブルシューティング
設定が機能しない
/setup --reset # テンプレートから設定を再作成
コマンドが見つからない
.claude/commands/に.md拡張子でコマンドファイルが存在することを確認。
ロックが変更を妨げている
/lock check <file> # ロック状態を確認
/lock remove <file> # 権限がある場合は削除
セキュリティスキャンの失敗
/security report # 詳細レポートを取得
/security fix # 可能な場合は自動修正
コントリビュート
- 6フェーズ機能開発プロセスに従う
- すべてのドキュメントをバイリンガルで作成
- 新機能にセキュリティチェックを追加
- ファイルロックとプロジェクト境界を尊重
- 修正したドキュメントのバージョンと日付を更新
ライセンス
[ライセンスをここに記載]
サポート
問題や質問がある場合：
-
/doc/guide/のドキュメントを確認 -
/doc/jp/の日本語ドキュメントを確認 -
/helpでコマンドのヘルプを確認