Release v1.2.4

概要

本リリースでは、Claude Codeのサブエージェント（task-executor）およびスラッシュコマンドの実行精度を大幅に改善しました。責務境界の明確化により、各コンポーネントが適切な範囲で動作するようになり、予期しない自動実行や承認スキップなどの問題を解決しています。

主な変更点

🎯 task-executorの実行精度向上

改善内容

• 実装権限の明確化: 呼び出された時点で既に承認済みであることを明示
• 行動原則の具体化: なぜ即座に実装すべきか、なぜ品質チェックを実行しないかを理由付きで記載
• 汎用的な表現: エージェント/オーケストレーターといった実装固有の用語を排除

効果

• task-executorが迷いなく実装に集中できるようになった
• 不要な承認確認による作業の重複を排除
• 責務分離（実装 vs 品質保証）が明確になった

🔧 スラッシュコマンドの責務境界修正

/planコマンド

• 修正前: 実装フェーズ全体の一括承認を取得し、タスク分解まで実行
• 修正後: 作業計画書の作成と計画承認のみに専念
• 効果: 勝手に次フェーズ（実装）に進む問題を解決

/buildコマンド

• 修正前: 分解済みタスクの実装のみ担当
• 修正後: task-decomposerから開始し、タスク分解→実装→品質保証→コミットまでの完全なサイクルを管理
• 追加: Think carefullyによる品質監視とエラーパターンの注意深い観察

/designコマンド

• 修正: 「作業計画フェーズへの移行」→「次フェーズへの移行」に汎用化

📋 sub-agents-guideの整合性確保

• task-executorへの指示方法を具体的なコード例で明示
• 権限委譲セクションを追加し、自律実行モード開始後の権限を明確化
• checklistProgress機能を削除（task-executorは常に100%完了で報告するため不要）

技術的詳細

削除された機能

• checklistProgress: task-executorの構造化レスポンスから削除
  • 理由: task-executorは単一タスクを完全実行するため、進捗報告は不要

改善された設計原則

1. 責務の明確な分離: 各コマンド・エージェントが明確な境界を持つ
2. 二重管理の排除: 詳細な実行フローはsub-agents-guideに一元化
3. 汎用性の確保: 特定の実装に依存しない表現を使用

影響範囲

• .claude/agents/task-executor.md
• .claude/commands/build.md
• .claude/commands/plan.md
• .claude/commands/design.md
• docs/sub-agents-guide.md

アップグレード時の注意

本リリースは内部的な改善のため、既存の使用方法に変更はありません。ただし、以下の動作が改善されます：

1. /planコマンド使用後、自動的に実装が始まることはなくなりました
2. /buildコマンドは作業計画書から自動的にタスク分解を行うようになりました
3. task-executorは承認確認なしで即座に実装を開始します

今後の展望

今回の改善により、Claude Codeの自律実行がより予測可能で制御しやすくなりました。各コンポーネントの責務が明確になったことで、今後の機能拡張もより安全に行えるようになります。

Release v1.2.3

🎉 新機能

Claude Code カスタムスラッシュコマンド

Claude Codeの作業効率を大幅に向上させる5つのカスタムスラッシュコマンドを追加しました。

利用可能なコマンド

1. /onboard - プロジェクト開発ルールの読み込み

   • CLAUDE.mdとルールファイルを自動読み込み
   • 開発ルールとアーキテクチャの理解を宣言

2. /design - 要件分析から設計書作成まで

   • requirement-analyzerによる要件分析
   • 規模に応じたADR/Design Doc作成
   • 設計承認フェーズで明確に終了

3. /plan - 作業計画とタスク分解

   • 設計書から作業計画書を作成
   • 独立したタスクに分解
   • タスク分解完了で明確に終了

4. /implement - 自律実行モードでの実装

   • タスクの順次実行
   • 品質チェックとコミット作成
   • 全タスク完了まで自動実行

5. /build - 品質チェックとビルド確認

   • Biome、TypeScript、テストの実行
   • エラー時は自動修正
   • コミット可能状態の確認

💡 使用例

# プロジェクト開始時
/onboard

# 新機能の設計
/design ユーザー認証機能を追加したい

# 設計承認後の計画
/plan

# タスク分解後の実装
/implement

# 品質確認
/build

⚠️ 注意事項

• 各コマンドは定義されたフェーズ内で完結します
• 次のフェーズへの移行は明示的なコマンド実行が必要です
• /implementは自律実行モードのため、開始前に計画内容を確認してください

🔧 技術的変更

• .claude/commands/ディレクトリ構造の採用
• コマンドファイルのFrontmatter形式での説明追加
• $ARGUMENTS変数によるパラメータ受け渡し
• サブエージェントとの連携強化

Release v1.2.2

🐛 バグ修正

task-executorの自律性向上

• task-executorが不要な確認を繰り返す問題を修正
• 一度呼び出されたら承認済みとして即座に実装を実行するように明確化
• CLAUDE.mdの「調査OK・実装STOP」ルールはtask-executorには適用されないことを明記

タスク重複実行の防止

• 完了済みタスク（全チェックボックスが[x]）の場合は「既に完了」と報告して終了する仕組みを追加
• 完了済みタスクを誤って渡しても実害なく空振りで終了することを明記

サブエージェントへの指示方法の改善

• task-executorへの指示方法を明確化（タスクファイルパスのみ指定）
• 詳細な要件説明が不要であることを明記し、混乱を防止

📝 ドキュメント更新

• .claude/agents/task-executor.md: 実装権限セクションを追加
• docs/sub-agents-guide.md: task-executorへの明確な指示方法を追加

これらの修正により、サブエージェントシステムの実行精度が向上し、同じタスクの重複実行や不要な確認による作業の停滞が解消されます。

Release v1.2.1

🎯 概要

このリリースでは、document-fixer サブエージェントのAI実行精度を最大化するための重要な改善を行いました。整合性検証を最終フェーズに移動し、2段階修正プロセスを導入することで、最終成果物の品質とAI解釈精度の両方を保証します。

🔧 改善

Document Fixer の実行精度向上

2段階修正プロセスの導入

• 第1次修正: レビュー結果に基づく内容改善に特化
  • クリティカル → 重要 → 推奨の優先順位で修正
  • 論理的矛盾、誤情報、構造的問題を解決
• 第2次修正: AI解釈精度向上のための最適化に特化
  • 曖昧表現の明確化
  • 参照の具体化
  • 構造の最適化

整合性検証の最終フェーズへの移動

• 従来: 並列レビューの一部として実行
• 改善後: すべての修正完了後に単独実行
• 利点: 修正による新たな不整合を確実に検出・修正

AI実行精度向上のための具体的基準

• 必須修正項目:
  • 「必要に応じて」「適切に」等の曖昧表現を具体的条件に置換
  • 「これ」「それ」等の代名詞を具体的な対象に置換
  • 条件分岐をif-then形式に統一
  • 用語・表記の完全統一

エラーハンドリングの強化

• 第1次修正と第2次修正で異なる競合解決ルールを適用
• ユーザー判断が必要な事項を明確に記録
• 修正不可能なケースの明確な定義

📈 期待される効果

1. 品質保証の向上: 最終フェーズでの整合性検証により、修正による副作用を確実に検出
2. AI実行精度の最大化: 曖昧性を排除し、AIが誤解なく文書を解釈・実行可能に
3. 予測可能性の向上: 明確な修正基準により、一貫した結果を保証

🔄 後方互換性

この変更は内部処理の改善であり、document-fixerの外部インターフェースに変更はありません。既存の使用方法はすべて維持されます。

📝 技術詳細

変更されたファイル

• .claude/agents/document-fixer.md - 実行フローと修正基準を全面的に改善

内部処理の変更点

1. レビュー戦略から整合性検証を除外（最終フェーズに移動）
2. 修正処理を2段階に分離（内容改善 → AI最適化）
3. 統合処理に構造化データ処理と明確な優先順位ルールを追加
4. 最終検証にAI実行可能性チェックを追加

🚀 今後の展望

このアップデートにより、AI主導のドキュメント品質管理がより確実かつ予測可能になります。今後も実行精度向上のための改善を継続的に行っていきます。

📋 コミット履歴

• 5c6627b - feat: enhance document-fixer for maximized AI execution precision

Release v1.2.0

🎉 概要

このリリースでは、新しい document-fixer サブエージェントを導入し、document-reviewer サブエージェントを強化しました。これにより、より強力なドキュメント品質管理機能を提供します。

✨ 新機能

Document Fixer サブエージェント

• レビュー結果に基づいてドキュメントを自動修正する新しい document-fixer サブエージェントを追加
• 複数のレビュー観点を統合し、フィードバックを集約
• 異なるコンテキストで document-reviewer を並列実行
• 分析から修正まで完全に実施

🔧 改善

Document Reviewer の機能強化

• より構造化されたレビュープロセスで document-reviewer を強化
• 観点ベースのレビュー機能を改善
• ドキュメント修正ワークフローとの統合を改善

ドキュメントの更新

• document-fixer の使用方法を含むサブエージェントガイドを更新
• README のサブエージェントリストに document-fixer を追加
• サブエージェント統合パターンの明確性を向上

📝 変更内容

変更されたファイル

• .claude/agents/document-fixer.md - 新しいエージェント定義（初期バージョンから簡略化）
• .claude/agents/document-reviewer.md - レビュー機能を強化
• README.md - サブエージェントリストに document-fixer を追加
• docs/sub-agents-guide.md - document-fixer の説明を追加してガイドを拡張

🔄 移行に関する注意

破壊的変更はありません。新しい document-fixer エージェントは追加機能であり、既存のエージェントと並行して動作します。

📋 コミット履歴

• 7a3e98e - sync: document-fixer/reviewer と sub-agents-guide を更新
• 7bff69a - docs: add document-fixer sub-agent to README
• 7fa901a - fix: update document-fixer to remove operation modes
• 38b111e - Merge pull request #8 from shinpr/sync/document-agents-update

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! 🤖✨