v0.1.38

🚀 Release Highlights — v0.1.38 (2026-01-14)

📋 Task Planning Mode

• CLI Flags: New --plan flag with --plan-depth (shallow/medium/deep) creates structured plans for future workflows (no auto-execution)
• Codebase Exploration: Auto-adds current directory to context paths for planning agents to explore existing code
• Interactive Q&A: Clarifying questions via ask_others tool during planning
• Structured Output: Generates feature_list.json with task dependencies and priorities for later execution

📁 Two-Tier Workspace

• Git-Backed Separation: Scratch workspace for exploration vs deliverable workspace for final outputs, with automatic change tracking for rollback

📖 Project Instructions Auto-Discovery

• CLAUDE.md & AGENTS.md: Automatically loads and prepends project-specific instructions to agent system messages

🖼️ Batch Image Analysis

• Multi-Image Processing: Process multiple images in single read_media call for comparison and batch analysis

🔧 Reliability Improvements

• Circuit Breaker: Prevents infinite tool denial loops with configurable retry limits
• Timeout Handling: Fixed soft-to-hard timeout race condition; MCP tools properly restored after restarts
• Vote Tracking: Ignored votes no longer leak into final results
• Docker Diagnostics: Container health monitoring on MCP failures

---

📖 Getting Started

• Quick Start Guide: Try the new features today
• Try These Examples:

# Task planning mode - creates a plan (no auto-execution)
uv run massgen --plan --plan-depth medium \
  "Build a REST API for a todo application"

# Will read from CLAUDE.md/AGENTS.md in cwd, if it exists
uv run massgen --config massgen/configs/basic/multi/three_agents_default.yaml \
  "Explain the current functionality of this repo @./"

• three_agents_default.yaml - Multi-agent configuration for collaborative tasks
• task_planning_example.yaml - Example configuration for task planning mode

What's Changed

• docs: update slides after v0.1.36 by @sonichi in #779
• feat: Timeout, workspaces, plan mode by @ncrispino in #789
• docs: Docs for v0.1.38 by @Henry-811 in #790
• feat: v0.1.38 by @Henry-811 in #787

Full Changelog: v0.1.37...v0.1.38