Release v1.6.6

🎯 Overview

This patch release clarifies the orchestrator's commit execution responsibility in the sub-agents documentation, ensuring more explicit and reliable operation instructions for AI agents.

✨ What's Changed

Documentation Improvements

• Clarified Orchestrator Commit Responsibilities - The sub-agents guide now explicitly states that the orchestrator (Claude/Me) is responsible for executing git commits during autonomous execution mode
  • Updated both Japanese and English documentation for consistency
  • Added explicit mention of using the Bash tool for commit execution
  • Improved clarity in the quality assurance workflow

Key Enhancements

• 🎭 Explicit Execution Entity: Changed from generic "Create commit" to "Me: Execute git commit" in workflow diagrams
• ✅ Clear Approval Flow: Emphasized immediate git commit execution after quality-fixer's approved: true confirmation
• 📝 Optimized Descriptions: Removed redundant text to ensure reliable operation regardless of context capacity
• 🌐 Bilingual Consistency: Maintained perfect parity between Japanese and English documentation

📊 Impact

These changes ensure:

• More reliable autonomous execution cycles
• Clearer understanding of responsibility boundaries between agents
• Reduced ambiguity in commit execution workflows
• Better AI agent comprehension of orchestration tasks

🔧 Technical Details

Files Modified

• docs/guides/ja/sub-agents.md - Japanese version updates
• docs/guides/en/sub-agents.md - English version updates
• package.json - Version bump to 1.6.6
• package-lock.json - Version sync

Release v1.6.5

🎉 What's New

Modern TypeScript Best Practices (2024-2025)

We've significantly enhanced the TypeScript development experience with cutting-edge patterns and practices:

🏷️ Branded Types

• Type-safe identifiers with runtime validation
• Prevent mix-ups between similar primitive types
• Production-ready patterns for user IDs, email addresses, and more

🔧 Functional Programming Integration

• Effect-TS and fp-ts ecosystem support
• Monadic error handling patterns
• Type-safe composition and pipeline operations

💉 Modern Dependency Injection

• Container-based DI patterns with type safety
• Lifecycle management and circular dependency prevention
• Integration with popular DI libraries

✨ Advanced Type Features

• satisfies operator for better type inference
• Template literal types for API endpoint safety
• Conditional types for flexible library design

🌐 International Development Support

Complete Japanese-English Synchronization

• Fixed systematic inconsistencies between language versions
• Ensured functional parity across all documentation
• Eliminated quality disparities in template-generated content

Enhanced Template Quality

• Design Document template completely restructured (269 lines, 48 sections)
• Added missing critical sections: Change Impact Mapping, Architecture Overview, Data Flow
• Standardized progress tracking in work plan templates

🧪 Improved Testing Experience

Test-First Development Process

• Comprehensive Red-Green-Refactor methodology
• Step-by-step guidance for TDD implementation
• Quality gates and verification procedures

Modern Testing Patterns

• Vitest-optimized configurations
• Test helper utilities and conventions
• Coverage reporting and quality metrics

🔧 Technical Improvements

Rule System Enhancements

• Updated rule index with modern TypeScript tags
• Streamlined technical specifications
• Better cross-references and documentation links

Agent and Command Standardization

• Removed redundant content from English agent files
• Unified command structure across languages
• Consistent documentation patterns

Documentation Quality

• Single source of truth for all development standards
• Clear separation of concerns between different document types
• Improved cross-language consistency

📊 Statistics

• Files Changed: 14
• Lines Added: 348
• Lines Removed: 227
• Languages Supported: Japanese, English (full parity)
• New Patterns: 8+ modern TypeScript practices added

---

Full Changelog: View on GitHub

Release v1.6.4

🔄 Changes

Documentation Improvements

• Simplified document-reviewer sub-agent definition by removing unnecessary complexity
  • Removed "Leveraging Non-determinism" section and iteration-based approach
  • Removed iteration parameter from METADATA section
  • Removed references to non-existent document-fixer sub-agent
  • Applied changes to both Japanese (agents-ja) and English (agents-en) versions

📝 Details

Removed Features

The iteration-based approach in document-reviewer was removed as it was:

• Not being utilized in the actual sub-agents guide (docs/guides/ja/sub-agents.md)
• Adding unnecessary complexity to the document review process
• Creating confusion with non-deterministic review patterns

Cleanup

• Removed references to document-fixer sub-agent which doesn't exist in the codebase
• Streamlined the document-reviewer to focus on its core responsibilities

🎯 Impact

These changes make the document-reviewer sub-agent more focused and easier to understand, removing unused features that could cause confusion during implementation.

📦 Affected Files

• .claude/agents-ja/document-reviewer.md
• .claude/agents-en/document-reviewer.md
• package.json
• package-lock.json

🤖 Compatibility

No breaking changes. The document-reviewer continues to function with the same core features, just with cleaner and more focused implementation guidelines.

Release v1.6.3

🎯 Overview

This release improves AI agent execution accuracy by enhancing how subagents reference and utilize implementation strategy documentation, ensuring more reliable autonomous execution and progress tracking.

🐛 Bug Fixes

Improved Subagent Implementation Strategy References

• Fixed missing implementation-approach.md references in technical-designer and work-planner agents
  • Agents now properly execute Phase 1-4 of metacognitive strategy selection process
  • Vertical/horizontal slice considerations are now consistently applied
  • L1/L2/L3 verification levels are properly utilized in task decomposition

Enhanced Progress Tracking Clarity

• Resolved progress checkbox update omissions in task-executor
  • Replaced abstract "3-location synchronized update" with concrete Edit tool instructions
  • Added progressUpdated field to structured response for better tracking visibility
  • Progress updates are now mandatory with specific tool usage requirements

🔧 Improvements

Autonomous Execution Reliability

• task-executor now operates more reliably in autonomous mode
• Reduced unnecessary approval requests during task execution
• Clearer responsibility boundaries between task-executor and quality-fixer agents

📊 Technical Details

Files Modified

• .claude/agents-ja/technical-designer.md
• .claude/agents-ja/work-planner.md
• .claude/agents-ja/task-executor.md
• .claude/agents-en/technical-designer.md
• .claude/agents-en/work-planner.md
• .claude/agents-en/task-executor.md

Key Changes

1. Added @docs/rules/architecture/implementation-approach.md to initial mandatory tasks
2. Specified Phase 1-4 execution requirements for strategy selection
3. Clarified L1/L2/L3 verification level usage in integration points
4. Improved progress update instructions with concrete tool specifications

💡 Impact on Users

• More accurate AI responses: Agents now better understand and apply implementation strategies
• Fewer interruptions: Reduced approval requests in autonomous execution mode
• Better progress visibility: Clearer tracking of task completion status
• Consistent behavior: Same quality across Japanese and English environments

Release v1.6.2

🚀 What's New

Enhanced Documentation & Rules System

This release focuses on improving AI development precision through comprehensive documentation and rule system enhancements.

✨ Key Improvements

Documentation & Templates

• Enhanced English Agent Definitions: Updated all AI agent definitions with improved capabilities and constraints for better task execution
• Standardized Template Documentation: Unified template structure across ADR, Design Documents, Plans, and PRD templates
• New Architecture Guidelines: Added implementation approach guidelines in docs/rules-en/architecture/implementation-approach.md
• Documentation Quality Criteria: Established clear criteria for documentation quality assessment

Rules & Guidelines

• Improved AI Development Rules: Enhanced rules for better AI execution precision and task management
• Updated Rule Indices: Synchronized rule indices to reflect current project structure
• Streamlined Architecture Process: Removed obsolete architecture decision process documentation

Code Quality

• Template Reference Fixes: Corrected template references in technical-designer agent
• Consistent Formatting: Standardized formatting across all documentation files

🔧 Technical Changes

• Updated 18 files with 920 insertions and 358 deletions
• Removed deprecated docs/rules-en/architecture-decision-process.md
• Added new documentation criteria and implementation guidelines
• Enhanced AI agent precision through refined definitions

📦 Dependencies

No dependency changes in this release.

---

Full Changelog: v1.6.1...v1.6.2

Release v1.6.1

🚀 Overview

This patch release enhances AI agent definitions to maximize execution precision and development quality through structured processes and clearer instructions.

✨ Key Improvements

Task Decomposition

• Verifiability Levels: L1/L2/L3 verification system for systematic task validation
• Slice Strategy: Vertical/horizontal slice determination for optimal task ordering
• Operation Verification: Mandatory verification methods with specific commands

Document Processing

• Composite Review Mode: Multi-angle document verification in single execution
• Interface Analysis: Mandatory impact analysis for interface changes
• PRD Boundaries: Clear exclusion of implementation phases from requirements

Technical Design

• ADR Management: Structured common ADR verification and creation process
• Migration Paths: Clear specification for interface conversion requirements
• Architecture Consistency: Enhanced project-wide consistency verification

🧹 Maintenance

• Agent Cleanup: Removed suspended document-fixer agent
• Dependency Optimization: 2-level maximum task dependency rule
• Bilingual Consistency: All improvements applied to both language versions

📈 Impact

• Enhanced Precision: Clearer instructions reduce AI interpretation errors
• Improved Efficiency: Streamlined review processes and verification levels
• Better Quality: Systematic verification and completion criteria
• Reduced Maintenance: Cleanup of unused components

Installation

npm install [email protected]

---

Full Changelog: v1.6.0...v1.6.1

Release v1.6.0

🚀 New Features

Code Reviewer Agent

• Added comprehensive automated code review capabilities
• Supports multi-perspective code analysis including security, performance, and maintainability
• Available in both Japanese and English versions

Review Command

• New review command for triggering code reviews
• Integrated with the code-reviewer agent for seamless workflow

✨ Improvements

Enhanced AI Agent Precision

• Optimized agent definitions for improved execution accuracy
• Refined prompt templates with clearer instructions and guidelines
• Better task decomposition and execution patterns

Documentation Updates

• Updated README with new commands and agent descriptions
• Added comprehensive design templates for technical documentation

🔧 Refactoring

Streamlined Architecture Documentation

• Removed redundant architecture pattern files (hybrid-progressive, vertical-slice)
• Consolidated documentation structure for better maintainability

Agent Definition Improvements

• Enhanced error handling guidance in quality-fixer agent
• Improved task execution flow in task-executor agent
• Refined work planning templates with better structure

📝 Changes by Component

Agents (Japanese & English)

• code-reviewer: New agent for comprehensive code review
• document-fixer: Minor refinements in review integration
• prd-creator: Updated template references and structure
• quality-fixer: Enhanced error handling and verification steps
• requirement-analyzer: Improved clarity in analysis patterns
• task-executor: Added explicit completion criteria
• technical-designer: Expanded design documentation guidance
• work-planner: Optimized task structuring patterns

Commands

• Added review command for both Japanese and English versions
• Comprehensive review workflow integration

🎯 Impact

This release significantly improves the AI agent ecosystem's accuracy and reliability, providing developers with better tools for automated code review and task execution. The streamlined documentation and optimized agent definitions enhance the overall developer experience.

Release v1.5.1

🔧 Bug Fixes

Improved Stability of Autonomous Execution Mode

This patch release addresses stability issues in the build command's autonomous execution mode that were causing inconsistent behavior during task execution.

What's Changed

Core Improvements

• Fixed structured response processing: The orchestrator now reliably detects and processes readyForQualityCheck: true signals from task-executor
• Enhanced metacognition process: Made the execution flow more explicit with mandatory steps:
  1. Execute rule-advisor to understand task essence
  2. Update TodoWrite for progress tracking
  3. Process structured responses immediately
• Improved quality gate reliability: Ensures all quality checks are properly executed before task completion

Documentation Updates

• Clarified orchestrator responsibilities in both Japanese and English command files
• Improved English translation consistency across all command documentation
• Added explicit scope definitions for better command boundary understanding

Why This Matters

The build command is critical for autonomous task execution in CI/CD pipelines and development workflows. This fix ensures:

• ✅ Consistent quality checks on all executed tasks
• ✅ Proper error detection and handling
• ✅ Reliable autonomous execution without manual intervention
• ✅ Clear execution flow that prevents task omissions

Technical Details

The issue was identified in the orchestration layer where structured responses from sub-agents were occasionally overlooked, causing the quality-fixer to not be triggered even when required. This could lead to tasks being marked as complete without proper quality validation.

Compatibility

This is a patch release with no breaking changes. All existing workflows and commands remain fully compatible.

Version

1.5.0 → 1.5.1

---

Full Changelog: v1.5.0...v1.5.1

Release v1.5.0

🎯 Overview

This release significantly improves AI execution accuracy through enhanced subagent definitions and workflow optimizations. The focus is on providing more intelligent and context-aware assistance for complex development tasks.

✨ New Features

📊 Technical Information Verification

• document-reviewer now actively verifies technical claims against latest information
• Automatic cross-referencing with official documentation and best practices
• WebSearch integration for real-time validation of technology choices

🔄 Reverse Engineering Mode

• prd-creator introduces reverse-engineer mode for existing implementations
• Automatically extracts specifications from code when PRD doesn't exist
• Enables comprehensive documentation for legacy features before major modifications

📈 Enhanced Scale-Based Workflows

• Improved PRD determination logic with three modes: create, update, and reverse-engineer
• Automatic mode selection based on project scale and existing documentation
• Clearer document requirements for small/medium/large scale projects

🔍 Latest Technology Research

• technical-designer now proactively researches latest best practices
• Automatic citation of reliable sources in ADR and Design Docs
• Integration with WebSearch for up-to-date technology comparisons

🐛 Improvements

Terminology Consistency

• Fixed scale assessment/determination terminology inconsistencies
• Unified approval recommendation language across all agents
• Improved English translations for better clarity

Workflow Optimization

• Simplified orchestrator commands for better task delegation
• Enhanced document output principles - immediate execution upon user instruction
• Improved ADR status management with clear recommendation/decision separation

📝 Documentation Updates

• Synchronized all Japanese and English agent definitions
• Updated sub-agents practical guide with clearer orchestration patterns
• Enhanced requirement analyzer with explicit PRD mode determination

🔧 Technical Details

Modified Components

• .claude/agents-en/* - All English agent definitions updated
• .claude/agents-ja/* - All Japanese agent definitions enhanced
• docs/guides/*/sub-agents.md - Orchestration guidelines improved
• .claude/commands/*/implement.md - Simplified orchestrator behavior

Compatibility

• ✅ Fully backward compatible
• ✅ No breaking changes
• ✅ Existing workflows continue to function

📊 Impact

This release enhances:

• Accuracy: Better terminology consistency reduces AI confusion
• Intelligence: Proactive research and verification capabilities
• Efficiency: Clearer workflows and automatic mode selection
• Quality: Technical claims are now verified against latest information

🚀 Upgrade Guide

Simply update to v1.5.0 - no migration needed:

npm install [email protected]

📌 Notes for Claude Code Users

These improvements are specifically optimized for Claude's new models, providing:

• More precise subagent task delegation
• Better understanding of project scale and requirements
• Proactive quality assurance and technical verification
• Reduced need for manual intervention in standard workflows

---

Full Changelog: v1.4.4...v1.5.0

Release v1.4.4

What's Changed

🔧 Improvements

• Removed rule-advisor dependencies from subagent definitions: Improved system maintainability by reducing inter-agent dependencies. Subagents now operate more independently with direct rule references instead of relying on rule-advisor selections.

• Clarified rule-advisor usage examples: Updated documentation to show examples rather than fixed usage patterns, making it clearer that these are flexible guidelines.

• Simplified task-executor configuration: Removed ambiguous "mandatory check items" section that lacked clarity, streamlining the agent's focus on implementation execution.

📝 Documentation

• Updated both Japanese and English versions of CLAUDE.md and agent definition files
• Made rule references more explicit and self-contained in each agent definition

Technical Details

• Changed "rule-advisor selected" references to "project" references throughout agent definitions
• Removed cross-dependencies between subagents to improve system reliability
• Maintained backward compatibility - no breaking changes

Full Changelog: v1.4.3...v1.4.4