Release v1.1.2

🐛 バグ修正

CLAUDE.mdの再帰呼び出し問題を修正

• 問題: サブエージェントがCLAUDE.mdを読み込む際、ファイル内のサブエージェント関連の記述により再帰呼び出しが発生していました
• 解決策: CLAUDE.mdからすべてのサブエージェント関連の記述を削除
• 変更内容:
  • プロジェクト説明文から「Sub-agent」の記述を削除
  • ツール活用セクションからサブエージェント一覧を削除
  • Claude Codeの行動原則からサブエージェント活用に関する項目を削除

📝 技術的詳細

この修正により、サブエージェントが初期化プロセスの一環としてCLAUDE.mdを読み込む際の無限再帰を防ぎます。コア開発ルールはそのまま維持しつつ、循環依存を解消しました。

🔄 移行ガイド

対応は不要です。これは後方互換性のある修正であり、Claude Code環境の安定性を向上させます。

📊 影響範囲

• 重要度: 中
• 影響を受けるコンポーネント: CLAUDE.md、サブエージェント初期化処理
• ユーザーへの影響: サブエージェント使用時の安定性向上

---

全変更履歴: v1.1.1...v1.1.2

Release v1.1.1

概要

v1.1.1では、Claude CodeのAI実行精度向上とドキュメント構造の最適化を実施しました。プロジェクト固有ルールの優先度を明確化し、サブエージェントシステムの一貫性を向上させています。

主な変更点

🎯 AI実行精度の向上

CLAUDE.mdの最適化

• プロジェクト固有ルールの優先明記: 「一般慣例より本プロジェクトのルールを優先」という指示を追加
• 「ガイドライン」→「ルール」への変更: より強い拘束力を持たせることで遵守率を向上

重複記述の削除

• 6つのルールファイル（docs/rules/）と重複していた約75行を削除
• エントリーポイントとしての役割に特化し、詳細はルールファイルに委譲
• 削除された主な内容:
  • 段階的実装の警告（ai-development-guide.mdに詳細記載済み）
  • Claude Code向け追加ガイドライン（technical-spec.mdで包含済み）
  • 一般的な注意事項

🤖 サブエージェントシステムの改善

@記法の導入

• すべてのサブエージェント呼び出しを@記法で統一
• 即座に利用可能なサブエージェント一覧をCLAUDE.mdに明記:

  - @quality-fixer : 品質チェックとエラー修正
  - @task-executor : 個別タスクの実行
  - @requirement-analyzer : 要件分析
  - @work-planner : 作業計画書作成
  - @technical-designer : 技術設計ドキュメント作成
  - @document-reviewer : ドキュメントレビュー
  - @task-decomposer : タスク分解
  - @prd-creator : PRD作成
  

quality-fixerの適正化

• 「プロアクティブ実行条件」セクションを削除
• 実行条件はfrontmatterのdescriptionフィールドのみに記載する設計原則を適用
• サブエージェント間の不適切な依存関係を排除

📝 ドキュメント品質の向上

• プロジェクトテンプレート特性セクションを削除（新規プロジェクト向けの汎用化）
• Claude Codeとしての行動原則を「判断に迷った時の基本原則」セクションに統合

破壊的変更

なし

移行ガイド

特別な移行作業は不要です。Claude Codeは自動的に改善されたルールに従って動作します。

Release v1.1.0

🎉 主な変更

このリリースでは、既存のサブエージェントシステムの包括的な改善を行いました。全8つのサブエージェントの機能強化と、サブエージェントガイドの新機能追加により、Claude Codeによる開発効率と品質をさらに向上させます。

✨ 新機能

サブエージェントガイドの機能追加

• 要件変更検知機能: ユーザーの指示から暗黙の要件変更を検知
• 自律実行フェーズの明示化: 品質保証/エラー修正/実装の各フェーズを自律的に実行

🔧 改善

サブエージェントシステムの包括的改善

全8つのサブエージェントの機能強化を実施：

• document-reviewer: ドキュメントレビュー機能の強化
• prd-creator: PRD作成プロセスの改善
• quality-fixer: TypeScript品質問題の自律修正機能の強化
• requirement-analyzer: 要件分析精度の向上
• task-decomposer: 作業計画書連携機能の追加（docs/plansから1コミット粒度のタスクに分解）
• task-executor: 責務範囲の明確化とレスポンス仕様の改善
• technical-designer: 技術設計ドキュメント作成機能の改善
• work-planner: 作業計画書作成プロセスの最適化

AIツール使用時のガイドライン改善

• ai-development-guide.md: TodoWriteツール活用の簡潔化とワークフロー最適化

---

Full Changelog: v1.0.0...v1.1.0

Release v1.0.0

🎉 概要

ai-coding-project-boilerplateの正式版リリースです。このテンプレートは、Claude
Codeを使用したTypeScript開発に最適化された、包括的なプロジェクトボイラープレートです。

✨ 主な特徴

🤖 サブエージェントシステム

• 8種類のサブエージェントを完備
• 各エージェントが特定のタスクに特化し、成果物を生成
• LLMの自律的な判断による適切なエージェント選択をサポート

📚 包括的な開発ガイドライン

• 6つの体系的なルールファイルによる開発標準化
• ADR/Design Doc/作業計画書による設計プロセス

🛠️ 開発効率の最大化

• Claude Code専用に最適化された設定とワークフロー
• 品質チェックの自動化とゼロエラー原則
• テストファースト開発（TDD）の完全サポート

📋 v0.1.0からの変更点

新機能

• サブエージェントシステムの改善
  • prd-creator: 対話モードサポートとmermaid図表ガイドライン追加
  • technical-designer: 複数案比較モードとmermaid図表ガイドライン追加
  • work-planner: mermaid図表ガイドライン追加
  • requirement-analyzer: 対話モードのサポート追加（確認事項セクション）
  • sub-agents-guide: LLM向け実践ガイドとして全面改訂し、実際のプロジェクトでの動作を確認済み

ドキュメント改善

• READMEに不足していたサブエージェント（task-decomposer, quality-fixer）を追加

v0.1.0 - Initial Release 🚀

🎯 初回リリース - Claude Code専用TypeScriptボイラープレート

TypeScript project boilerplate optimized for AI-assisted development with layered architecture, comprehensive development rules, and best practices.

✨ 主要機能

• 🤖 Claude Code特化設計: LLMによる開発で高品質なコードを生成するための包括的なルールセット
• 📋 6つの開発ルール: 技術仕様、TypeScript、テスト、AI開発ガイド等の体系的なルール
• 🔧 品質保証システム: 段階的品質チェック（Phase 1-6）と自動修正
• 🏗️ アーキテクチャパターン: LLM最適化されたVertical Slice、Layered、Hybrid Progressiveパターン
• 🧪 テスト最適化: Vitest + test-utils + Red-Green-Refactorプロセス
• 📚 ドキュメント体系: ADR、Design Doc、作業計画書による体系的な設計管理

🚀 このリリースに含まれるもの

核心システム

• CLAUDE.md: Claude Code専用設定とSub-agent連携ルール
• 6つのルールファイル (docs/rules/): 開発標準の完全定義
• TypeScript厳格設定: 型安全性とパフォーマンスを両立

開発環境

• Biome: 高速Linter・Formatter
• Vitest: モダンテストフレームワーク + UI
• 品質チェックコマンド: 段階的品質保証プロセス
• Husky + lint-staged: Git commit時の品質確保

アーキテクチャ支援

• ADRプロセス: 技術決定の体系的記録
• 作業計画書テンプレート: 中規模以上変更時の計画管理
• Sub-agent活用ガイド: quality-fixer、task-executor等の効率的活用

🎯 対象ユーザー

• Claude Codeユーザー: AI支援開発で品質を意識したTypeScriptプロジェクトを構築したい開発者
• LLM開発者: 体系的なルールに基づく開発プロセスを求める開発者
• TypeScript開発者: 品質重視の開発環境を素早く構築したい開発者

📥 使い方

# ボイラープレートをクローン
git clone https://github.com/shinpr/ai-coding-project-boilerplate.git my-project
cd my-project

# 依存関係のインストール
npm install

# 新しいプロジェクトとして開始
rm -rf .git
git init
git add .
git commit -m "feat: initial commit from AI Coding Project Boilerplate"

📚 ドキュメント

• 開発ルール: docs/rules/ - Claude Code必読の6つのルールファイル
• 使い方: README.md - 詳細な導入手順と開発コマンド
• 設定ファイル: CLAUDE.md - Claude Code専用設定

🔍 品質保証

このリリースは以下の品質基準をクリアしています：

• ✅ TypeScript strict mode対応
• ✅ Biome品質チェック通過
• ✅ 循環依存検査クリア
• ✅ ビルド成功確認済み

🤖 Claude Code開発フロー

ルール読み込み → 計画立案 → ユーザー承認 → 実装 → 品質チェック → コミット

🙏 注意事項

• Claude Code推奨: このボイラープレートはClaude Code使用を前提に設計されています
• ルール必読: docs/rules/の6つのファイルはClaude Code使用時に必須です
• 段階的導入: プロジェクトの規模に応じてアーキテクチャパターンを選択してください

---

Next Steps: プロジェクト固有の設定（docs/rules/project-context.md、環境変数等）を行い、Claude Codeで開発を開始してください！

Happy Coding with Claude Code! 🤖✨