Release v1.7.2

🎉 New Features

Project Context Injection Command

Added /project-inject slash command for streamlined project setup when using the boilerplate for production projects.

What's New

• Interactive Context Configuration: No more manual placeholder replacements
• Bilingual Support: Available in both Japanese (/project-inject) and English
• AI-Optimized Output: Generates context following AI execution accuracy maximization criteria

How It Works

# Start with the boilerplate
npx github:shinpr/ai-coding-project-boilerplate my-project

# Configure your project context interactively
/project-inject

# The command will guide you through:
# - Problem your project solves
# - Target users and usage scenarios
# - Business constraints
# - Development structure

📝 Documentation Updates

README Improvements

• Added /project-inject to slash commands reference
• Updated project configuration workflow to use the new command
• Clarified initial setup process for production projects
• Updated FAQ section with new customization method

Workflow Enhancement

Before: Manual editing of placeholder text in project-context.md
After: Interactive command that ensures proper context structure

🔧 Technical Details

Command Structure

• Follows single responsibility principle for project-context.md
• Clear separation between project context and technical choices
• Structured output format optimized for AI comprehension

AI Execution Accuracy Criteria

The command generates context following these principles:

• Minimal yet efficient: Essential information only
• AI-decidable: Measurable and verifiable criteria
• Unambiguous: Specific numbers, conditions, and examples
• Positive framing: "Do this" rather than "Don't do that"

💡 Why This Matters

When using a boilerplate for real projects, the first critical step is adapting it to your specific needs. The /project-inject command transforms this from a manual, error-prone process into a guided, interactive experience that ensures:

1. Consistency: All projects follow the same context structure
2. Completeness: No critical information is missed
3. Clarity: AI assistants understand your project's essence
4. Efficiency: Get started faster with less configuration overhead

---

Full Changelog: v1.7.1...v1.7.2

Release v1.7.1

🐛 Bug Fixes

Fixed Section References in Agent Definitions

• Japanese version (.claude/agents-ja/quality-fixer.md):
  • Fixed incorrect section reference from "品質チェックフェーズ" to "品質チェックコマンドリファレンス"
• English version (.claude/agents-en/quality-fixer.md):
  • Fixed incorrect section reference from "Quality Check Commands" to "Quality Check Command Reference"

📝 Details

The quality-fixer agent definitions in both language versions were referencing a non-existent section name in the ai-development-guide.md file. This fix ensures that the agent definitions correctly point to the actual "Quality Check Command Reference" section, improving documentation accuracy and preventing confusion when agents reference rule files.

🔍 What Changed

• .claude/agents-ja/quality-fixer.md: Line 48 updated
• .claude/agents-en/quality-fixer.md: Line 30 updated
• package.json: Version bumped to 1.7.1
• package-lock.json: Version bumped to 1.7.1

📌 Note

This is a documentation fix that improves the accuracy of internal agent references. No functional changes to the code or behavior.

---

Full Changelog: v1.7.0...v1.7.1

Release v1.7.0

🚀 Enhanced AI Agent Specifications and Documentation

This release significantly improves AI execution accuracy through comprehensive enhancements to agent specifications, documentation templates, and development workflows.

✨ New Features

E2E Test Generator Agent

• Introduced e2e-test-generator agent for automated integration test skeleton creation
• Generates comprehensive test structures based on Design Documents
• Supports both API and UI testing patterns
• Automatically creates test fixtures and helper functions

🔧 Improvements

Enhanced Agent Specifications

Quality Fixer Agent

• Strengthened validation workflows with comprehensive error handling patterns
• Added structured approach for TypeScript project quality assurance
• Improved autonomous error resolution with zero-tolerance for quality issues
• Enhanced pre-commit hook handling and retry mechanisms

Task Executor Agent

• Added structured task decomposition with granular progress tracking
• Implemented real-time status updates and completion verification
• Enhanced error recovery patterns with automatic retry logic
• Improved task prioritization based on dependencies

Technical Designer Agent

• Clarified ADR (Architecture Decision Record) decision-making process
• Enhanced Design Document structure with acceptance criteria
• Improved technical trade-off analysis and documentation
• Added integration point specifications

Work Planner Agent

• Integrated Design Document alignment for cohesive planning
• Enhanced phase-based implementation approach
• Added E2E verification procedures for each phase
• Improved risk assessment and mitigation strategies

Documentation Templates

Design Document Template

• Added structured E2E verification procedures
• Enhanced integration point specifications
• Improved acceptance criteria definitions
• Clarified technical dependency mappings

Work Plan Template

• Added phase-specific E2E verification steps
• Integrated Design Document cross-references
• Enhanced completion criteria with quality gates
• Improved progress tracking mechanisms

📚 Documentation Updates

• Refined sub-agent documentation with clearer usage patterns
• Enhanced capability descriptions and limitations
• Improved examples for agent collaboration patterns
• Added troubleshooting guides for common scenarios

🎯 Key Benefits

1. Improved AI Execution Accuracy: Better structured guidance leads to more precise task execution
2. Enhanced Error Prevention: Comprehensive validation patterns reduce runtime failures
3. Clearer Completion Criteria: Well-defined success metrics ensure quality deliverables
4. Better Task Management: Structured decomposition enables efficient parallel execution
5. Stronger Quality Assurance: Multi-layered validation ensures production-ready code

Release v1.6.7

🎯 Highlights

This release significantly improves AI execution accuracy by clarifying the existing code investigation process and preventing duplicate implementations.

✨ What's New

Enhanced Code Investigation Process

• Pattern 5 Added: New anti-pattern "Insufficient Existing Code Investigation" to prevent duplicate implementations
• Pre-implementation Checks: All AI agents now enforce thorough existing code investigation before implementation
• Better Decision Recording: Design Docs now require explicit documentation of similar functionality searches and decisions

📝 Changes

Documentation Improvements

• Added Pattern 5 to AI Development Guide for preventing architectural inconsistencies
• Enhanced technical-designer agent with similar functionality search workflow
• Updated task-executor with pre-implementation verification steps
• Strengthened code-reviewer validation checklist
• Improved work-planner with code investigation references

Technical Enhancements

• Added code-reading and best-practices tags to rules index
• Synchronized all improvements between Japanese and English documentation
• Clarified "Existing Codebase Analysis" section requirements in Design Docs

🔧 Developer Impact

This update ensures:

• Reduced Duplicate Code: AI agents will detect and reuse existing implementations
• Better Architecture Consistency: Similar functionality is handled uniformly across the codebase
• Clearer Decision Trail: All implementation decisions are documented with rationale
• Improved Code Quality: Pre-implementation checks prevent architectural drift

📚 Documentation

The following key processes have been clarified:

1. Search for similar functionality before implementation
2. Decision workflow: Use existing / Improve with ADR / Create new
3. Record all decisions in Design Doc's "Existing Codebase Analysis" section

---

Full Changelog: v1.6.6...v1.6.7

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