What's Changed

Added

• Build Agent with Full TCR Workflow: Implemented a complete Test-Commit-Revert agent for test-driven implementation with single-iteration workflow.
• Task Command: Added dedicated /task command for managing project roadmap in tasks.yaml.
• Plan Workflow Improvements: Enhanced task linking workflow with better plan synchronization.

Changed

• Maintenance Command: Reassigned from query agent to plan agent for improved audit workflows.
• Scaffold Command: Streamlined by removing execution phase from command spec.

Refactored

• TypeScript/YAML Migration: Migrated task and journal tools from Python to TypeScript with YAML storage (BREAKING).
• Build Agent Simplification: Simplified to one-off TCR agent, removing preconditions and constraints.
• Subagent Structure: Flattened subagent directory structure in .opencode/.

Documentation

• Updated all references from Python tools to TypeScript/YAML.
• Updated documentation to reference .opencode paths.
• Added context minification feature documentation and principles.

Full Changelog: v0.22.0...v1.0.0

Release v0.22.0

[0.20.0] - 2026-03-23

Added

• Unified Discovery-Plan-Execute Lifecycle: Formally established a strict three-phase architectural boundary (Discovery -> Plan -> Execution).
• Modernized Test Suite (uv/pytest): Replaced legacy testing infrastructure with uv for dependency management and pytest for automated validation.
• Dynamic Structural Testing: Implemented tests/test_structure.py for discover-based, schema-compliant verification of all 15 commands and 6 agents.
• Documentation Overhaul: Updated the entire documentation suite (docs/index.md, docs/design.md, docs/develop.md, docs/user-guide.md) to reflect the new unified lifecycle and technical stack.
• Improved Content Creation: Refactored the /draft command and evolved the writer agent for review-driven refinement.

Changed

• Read-Only Audit Workflows: Refactored /maintenance and /review (formerly /revise) to be strictly read-only 'Discovery' commands that produce artifacts for /plan.
• Review Command Evolution: Evolved the /review command into a non-destructive, multi-phase audit workflow with sidecar reporting.
• Agent Naming Alignment: Renamed editor to reviewer and reporter to writer for improved semantic clarity.
• Test Optimization: Refactored tests/test_review_command.py and tests/test_sync.py to be dynamic and less brittle, removing hardcoded skips and string matches.

Changed

• Documentation Suite Overhaul: Major updates to the entire documentation suite (index.md, deploy.md, design.md, develop.md, user-guide.md, and README.md) to accurately reflect the framework's v0.19.0 improvements, including the /learn command, the dual-layer hook system, and the updated testing philosophy.

[0.18.0] - 2026-03-20

Added

• Installer Boilerplate Generation: docs/install.sh now generates clean, generic boilerplate for README.md, CHANGELOG.md, TASKS.md, and makefile instead of copying project-specific versions when scaffolding a new project.
• Scientific Debugging Documentation: Added comprehensive documentation for the /debug command's scientific, hypothesis-driven workflow in docs/design.md and docs/user-guide.md.

Changed

• Documentation Suite Overhaul: Major updates to the entire documentation suite (index.md, deploy.md, design.md, develop.md, user-guide.md) to reflect recent framework changes, including the Journal-First philosophy, TCR (Test-Commit-Revert) loop details, and safe update logic.

[0.17.1] - 2026-03-20

Changed

• Journal Logic Refinement: Simplified the journal entry mechanism in docs/install.sh by consolidating logic to always utilize the project's internal journal.py script, ensuring consistent audit logs across environments.

Consolidated lifecycle hooks, improved robustness, and enhanced makefile integration.

[0.14.0] - 2026-03-18

Added

• Notification Hook: Implemented a new AfterAgent hook (notify.py) that sends a desktop notification using notify-send and plays a system "ping" sound (via paplay) when the agent completes its turn.
• Hook Robustness: Improved project name detection in notifications by correctly identifying the git repository root.

Changed

• Hook Sequencing: Refined the AfterAgent hook block to be sequential, ensuring notifications only trigger if preceding validation hooks (like make or journal) return an allow decision.

[0.13.0] - 2026-03-18

Added

• Hypothesis-Driven Debugging: Refactored the /debug command and debugger agent to implement a scientific, hypothesis-driven workflow. Includes status analysis, hypothesis formulation with user approval, and isolated testing in temporary debug/hyp-* branches.
• Content: Added a new blog post draft "Revenge of the Test-Driven Nerds" to the drafts/ directory.

Changed

• Command Rename: Renamed the .gemini/commands/docs.toml to .gemini/commands/document.toml for better semantic clarity.
• Settings: Removed the experimental plan setting from .gemini/settings.json.
• Documentation: Enhanced installation and setup documentation with detailed project scaffolding and integration steps.

Added

• Implemented a strict TCR (Test-Commit-Revert) protocol for the /task work command, enforcing Red-Green-Refactor development cycles on dedicated feature branches.

Changed

• Refined install.sh to protect project scaffolding files (e.g., README.md, TASKS.md) from being overwritten while ensuring core framework files are always updated.
• Updated documentation and roadmap to reflect the new workflow improvements.