Changelog

All notable changes to the Claude Code Development Kit will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[2.1.0] - 2025-07-11

Added

New /gemini-consult command for deep, iterative conversations with Gemini MCP
Persistent session support for complex problem-solving
Context-aware problem detection when no arguments provided
Automatic attachment of project documentation and MCP-ASSISTANT-RULES.md
Support for follow-up questions with session continuity
Core Documentation Principle section in /update-docs command
Emphasizes documenting current "is" state only
Provides anti-patterns to avoid and best practices to follow
Ensures documentation reads as if current implementation always existed

Improved

Enhanced setup script with conditional command installation
/gemini-consult command only installed when Gemini MCP is selected
Better user experience with relevant commands based on chosen components
Updated commands README with comprehensive /gemini-consult documentation
Added use cases and workflow examples
Integrated into typical development patterns

What's New in v2.0.0:

Security: Automatic scanning prevents accidental exposure of API keys and secrets
Context Enhancement: Project structure and MCP assistant rules automatically included in Gemini consultations
Sub-Agent Context: All sub-agents now automatically receive core project documentation
Developer Experience: Audio notifications for task completion and input requests
MCP Assistant Rules: Define project-specific coding standards for MCP assistants
No Breaking Changes: All v1.0.0 features remain unchanged and fully compatible

[2.0.0] - 2025-07-10

Added

Comprehensive hooks system as 4th core framework component
Security scanner hook to prevent accidental exposure of secrets when using MCP servers
Gemini context injector for automatic project structure and MCP assistant rules inclusion in consultations
Subagent context injector for automatic documentation inclusion in all sub-agent tasks
Cross-platform notification system with audio feedback
MCP-ASSISTANT-RULES.md support for project-specific coding standards
Template in docs/MCP-ASSISTANT-RULES.md for customization
Automatic injection into Gemini consultations via updated hook
Example implementation in framework root (gitignored)
Hook setup command (/hook-setup) for easy configuration verification
Settings template for Claude Code configuration with all hooks pre-configured
Hook configuration examples and comprehensive documentation
Multi-Agent Workflows documentation section in docs/CLAUDE.md
Automatic context injection documentation in commands/README.md
Remote installation capability via curl command
New install.sh script for one-command installation
Downloads framework from GitHub without cloning
Professional installer with progress indicators
Automatic cleanup of temporary files
Interactive setup.sh script for framework installation
Prerequisite checking with clear explanations for required tools
Interactive prompts for optional components with descriptions
Conditional file copying based on user selections
Conflict resolution for existing files (skip/overwrite/all)
Dynamic OS detection only when notifications are selected
Configuration file generation with selected components only
Cross-platform support (macOS, Linux, Windows via WSL)

Improved

Developer experience with automatic sub-agent context injection
More consistent multi-agent workflow patterns across all commands
Simplified sub-agent prompts by removing manual context loading
Installation experience with two methods: quick install (curl) or manual (git clone)
Documentation with clearer installation instructions and correct MCP server links
User onboarding with step-by-step setup guidance and component descriptions
Setup safety with file conflict resolution instead of automatic overwrites

Changed

Tier 2 and Tier 3 documentation files renamed from CLAUDE.md to CONTEXT.md
Updated all documentation and templates to reflect new naming convention
Clarified that only Tier 1 (master context) remains as CLAUDE.md

[1.0.0] - 2025-07-01

Added

Initial framework release with 3 core components
3-tier documentation system (Foundation/Component/Feature)
Command templates for multi-agent workflows
/full-context - Comprehensive context gathering and analysis
/code-review - Multi-perspective code analysis
/update-docs - Documentation synchronization
/create-docs - Initial documentation generation
/refactor - Intelligent code restructuring
/handoff - Session context preservation
MCP server integration patterns (Context7, Gemini)
Auto-loading mechanism for critical documentation
Comprehensive documentation structure with routing system
Example templates for issues and specifications
Integration guide for external AI services

Core Features

Automatic context management through documentation hierarchy
Sub-agent orchestration for complex tasks
Seamless integration with external AI expertise
Self-maintaining documentation system

Upgrading from v1.0.0 to v2.0.0

The hooks system is optional but recommended for enhanced security and developer experience.

To add hooks to your existing v1.0.0 project:

Copy the hooks directory to your project:
```
cp -r hooks your-project/.claude/hooks/
```

Configure hooks in your project:

# Copy the settings template to your project
cp hooks/setup/settings.json.template your-project/.claude/settings.json

# Edit to update the WORKSPACE path
# All hooks including subagent-context-injector are pre-configured

Test the installation:

# Run the hook setup verification
/hook-setup

Update existing command files (optional):
Commands will work without changes, but you can simplify sub-agent prompts
Remove manual Read /CLAUDE.md instructions from Task prompts
Sub-agents now automatically receive core documentation