v5.8.0: Enhanced Plan & Verify Templates

v5.8.0: Enhanced Plan & Verify Templates

🚀 New Features

Enhanced Plan Template (/clavix:plan)

• Context-Aware Planning: Added comprehensive codebase analysis phase that detects existing patterns, frameworks, and architectural decisions
• Low-Level Engineering Tasks: Transformed from high-level management tasks to specific technical implementation instructions
• Implementation-Specific Details: Each task now includes exact file paths, technical constraints, and architectural alignment
• Improved Error Handling: Better self-correction protocols with specific detection patterns for common planning mistakes

Enhanced Verify Template (/clavix:verify)

• Spec-Driven Technical Audit: Transformed from basic testing to senior code review approach
• Requirements Comparison: Compares implementation against both the PRD requirements and the technical plan
• Structured Review Comments: Generates Critical, Major, and Minor issues with actionable feedback
• Architecture Compliance: Verifies that code follows the established patterns and design decisions

🔧 Improvements

• Template Consistency: Fixed validation issues and ensured all required sections are present
• Better Protocol Definitions: Enhanced self-correction and state assertion protocols
• Improved Agent Guidance: More specific instructions for AI agents to follow
• Code Quality Focus: Emphasis on technical accuracy over generic advice

📝 Technical Changes

• plan.md: Added 3-phase execution protocol (Context Analysis → PRD Ingestion → Task Generation)
• verify.md: Added spec-driven audit methodology with senior code review patterns
• Enhanced implementation specificity with exact file paths and technical constraints
• Improved error handling and recovery protocols

✅ Quality Assurance

• All consistency checks pass
• Template structure validation compliant
• Pre-commit hooks satisfied
• Automated tests passing
• Version references updated across all templates

---

Recommended Workflow: /clavix:prd → /clavix:plan → /clavix:implement → /clavix:verify → /clavix:archive

v5.7.1 - Template Consistency & Improved Tone

What's Changed

🎨 Major Template Improvements

verify.md - Complete Rewrite

• Rewrote with friendly, conversational tone matching other commands
• Simplified complex tables and verification matrices
• Added clearer examples and better structured reporting
• New title: "Check Your Work" (was "Verify Implementation")
• Improved troubleshooting with "Don't Panic" messaging
• More approachable language throughout

refine.md - Tone & Workflow Improvements

• Rewrote with more casual, approachable tone
• Simplified workflow sections and removed formal checkpoints
• Added better conversational examples
• Streamlined PRD and prompt refinement flows
• Better "When Things Go Wrong" troubleshooting

improve.md - Enhanced Clarity

• Added new "What This Does" section
• Detailed smart depth selection logic (quality score-based)
• Clarified 6-dimension assessment approach

📚 Documentation & Tooling

• Added comprehensive template style guide (docs/template-style-guide.md)
• Added validation script for template consistency (scripts/validate-consistency.ts)
• Fixed validation script to use tsx for Node v25 compatibility
• Updated Agent Transparency to v5.7.1 across all canonical templates

🎯 Impact

All changes maintain full functionality while significantly improving:

• User experience and approachability
• Consistency across the command suite
• Readability and comprehension
• Tone alignment with existing friendly commands

Full Changelog: v5.7.0...v5.7.1

v5.7.0 - Template Quality & Schema Cleanup

What's New in v5.7.0

Template Improvements

• Standardized section order across all 9 templates (CLAVIX MODE → Self-Correction → State Assertion)
• verify.md: Now presents report in chat and asks user what to do next (no file saving)
• plan.md: Added verification section after plan generation
• archive.md: Explicit tool clarity (Read, Bash/Move, Bash/Remove, Glob/List)
• State markers for workflow continuity added to improve, prd, plan, summarize templates
• Recovery patterns added to self-correction-protocol.md

Schema Cleanup

• Removed unused supportsFrontmatter from all adapter types and tests
• Documented argument placeholder strategy in docs/templates.md

Documentation

• Added OUT OF SCOPE section to CONTRIBUTING.md (MCP server, Git hooks, CI/CD templates)
• Fixed CHANGELOG reference in PR checklist
• Fixed LLXPRT naming (was "LLXpert") in integrations.json and docs

Testing

• Added naming-consistency.test.ts with 8 tests for naming conventions
• All 1311 tests passing

Files Changed

• 25 files modified
• +445 lines / -167 lines

---

Full Changelog: v5.6.6...v5.7.0

v5.6.6

🎉 Template Quality & Test Coverage Improvements

Added

• 21 new CLI tests - Enhanced test coverage:

  • 10 command behavior verification tests for update.ts
  • 11 reconfiguration flow tests for init.ts
  • Total: 1306 tests passing

• Template Enhancements:

  • Task dependency guidance in plan.md with explicit dependency markers
  • Scope creep detection and handling in start.md
  • Archive size management guidance in archive.md
  • Multi-topic handling in refine.md troubleshooting

• Quality Dimension Documentation:

  • Workflow-specific dimension usage table
  • Documented why /clavix:summarize excludes Specificity dimension
  • Added quality dimensions reference to refine.md

Fixed

• Updated package.json description to list all 9 slash commands
• Fixed "19+" to "20" AI tools count in README.md and docs
• Standardized quality dimension terminology in refine.md
• Added /clavix:refine to MANIFEST.md usage matrix

Installation

npm install -g clavix

Upgrade

npm update -g clavix

v5.6.5

What's New in v5.6.5

Test Coverage Improvements

• Added 30 comprehensive logger utility tests
• Expanded update.test.ts from 39 to 84 tests (+45 tests)
• Total test count: 1269 tests passing

Code Quality

• Added conflicting flags validation to update command (--docs-only + --commands-only now errors)
• Added /clavix:refine command to octo.md and warp.md agent templates
• Added clean script to package.json for build cleanup

Refactoring

• Extracted init.ts into 6 helper modules (src/cli/helpers/init/):
  • directories.ts - Directory structure creation
  • config.ts - Configuration management
  • documentation.ts - Documentation generation
  • commands.ts - Slash command generation
  • integrations.ts - Integration handling
  • prompts.ts - User prompts

New Features

• JSON Schema generation from Zod schemas
  • schemas/config.schema.json for .clavix/config.json validation
  • schemas/integrations.schema.json for integrations.json validation
  • Enable IDE autocompletion by adding "$schema": "./schemas/config.schema.json" to your config

Install/Update

npm install -g clavix@5.6.5
# or
npx clavix@latest init

Full Changelog: v5.6.4...v5.6.5

v5.6.4

Fixed

• UserConfigSchema Missing Fields - Fixed Zod schema to match ClavixConfig interface:
  • Added version, templates, outputs, preferences, experimental fields
  • Eliminates false "Unknown fields" warnings during clavix update

---

Full Changelog: v5.6.3...v5.6.4

v5.6.3

What's New

Added

• Zod Schema Validation - Runtime validation for integrations.json and user config.json with contextual error messages
• Universal Adapters - 4 new documentation-only integrations: agents-md, copilot-instructions, octo-md, warp-md
• Template Documentation - New docs/templates.md authoring guide with component include system
• Schema Validation Tests - 23 new tests for configuration validation

Changed

• Summarize→Plan Workflow - Added project name prompt and fallback detection for better workflow coordination
• Error Output Standardization - All CLI commands now use this.log()/this.error() for consistent output
• Template Header Standardization - All 9 slash command templates use consistent "## State Assertion (REQUIRED)" format
• README.md - Reorganized by workflow with Mermaid diagram showing command relationships
• CONTRIBUTING.md - Added quick-start decision table for contributors

Fixed

• JSON Parsing Crashes - Wrapped all JSON.parse calls with try-catch for graceful error handling
• Test Suite - Fixed adapter count tests (16 → 20 adapters)

---

Full Changelog: v5.6.2...v5.6.3

v5.6.2 - Build Fix

Build Fix

Hotfix for v5.6.1 - the integrations.json config file was not being copied to dist/ during build, causing CLI commands to fail with MODULE_NOT_FOUND.

Fixed

• Updated copy-templates script to also copy src/config/**/* to dist/
• Removed stale oclif.manifest.json

Testing

• All 1140 tests pass
• CLI commands (init, update, diagnose, version) verified working

Full Changelog: v5.6.1...v5.6.2

v5.6.1 - Integration Path Fixes

Integration Path Corrections

This patch release fixes 6 integration paths that were mismatched with official tool documentation and establishes a JSON source of truth for all integration configurations.

Fixed Integration Paths

Integration	Before	After
Amp	.amp/rules	.agents/commands/
Cline	.cline/rules	.clinerules/
Droid	.droid/rules	.factory/commands/
OpenCode	.opencode/rules	.opencode/command/
Crush	.crush/rules	.crush/commands/
Codex	.codex/instructions	~/.codex/prompts/ (global)

New Features

• JSON Source of Truth: All integration configs now live in src/config/integrations.json
• Global Path Support: Codex CLI now correctly writes to home directory
• Placeholder Support: Added $ARGUMENTS for Droid, OpenCode, and Codex

Documentation

• Updated docs/integrations.md with correct paths
• Added Integration Configuration section to CONTRIBUTING.md

Testing

• Added 127 new consistency tests to prevent future documentation drift
• All 1139 tests pass

Full Changelog: v5.6.0...v5.6.1

v5.6.0 - Documentation & Template Quality

What's New

Template System Improvements

• Circular include protection - MAX_DEPTH=10 prevents infinite loops in {{INCLUDE:}} references
• Reusable agent protocol components - Extracted state-assertion.md and self-correction-protocol.md
• Standardized checkpoint format - All templates now use **CHECKPOINT:** pattern

Documentation Enhancements

• QUICKSTART.md - Quick command reference generated during init
• Quick PRD examples - Compact AI-optimized PRD examples in prd-examples.md
• Command format documentation - Clarified colon (:) vs hyphen (-) variations
• Implement auto-detection - Documented source detection logic (tasks.md vs prompts/)

Quality & Consistency

• Updated terminology: execute → implement
• Fixed ESM __dirname compatibility in init command
• Updated TESTING.md with current architecture (TemplateAssembler)
• Added canonical source documentation to CONTRIBUTING.md

Files Changed

• 13 modified files
• 3 new template components

Full Changelog: v5.5.2...v5.6.0