feat: Add workflow commands and lifecycle documentation - #5
Merged
Conversation
Add new workflow commands: - /project:debug - Systematic debugging with hypothesis testing - /project:refactor - Safe refactoring with test verification - /project:release - Release preparation and changelog generation - /project:document - Documentation generation for code Improvements: - Revised plan.md for better balance (not over-emphasizing TDD) - Added workflow lifecycle diagram to CLAUDE.md - Organized commands by category (discovery, implementation, quality) - Added "When to Use Each" guidance
Implement comprehensive autonomous development workflow that minimizes human intervention after requirements are confirmed. New components: - Reviewer subagents (.claude/agents/): - exploration-reviewer: Validates exploration completeness - plan-reviewer: Catches planning flaws before implementation - code-reviewer: Reviews for bugs, security, quality - documentation-reviewer: Ensures doc accuracy - experiment-reviewer: Validates spike conclusions - /project:auto command: Master orchestrator with 7 phases - Phase 0: Requirements lock-in (human-in-loop) - Phases 1-4: Autonomous with self-review gates - Phase 5: Final validation (tests, lint, type check) - Phase 6: Completion and reporting - Escalation protocol for edge cases - Enhanced /project:improve: Self-critique by domain, full-audit mode - CLAUDE.md: Full autonomous workflow documentation with flow diagram Philosophy: Thorough human collaboration upfront, then autonomous execution with quality gates that prevent error accumulation.
Implement closed-loop self-improvement that follows the same explore → plan → implement → review cycle as development work. New components: Diagnostic system: - diagnostic-agent: Traces errors to root causes in system components (commands, agents, hooks, docs, memories) - improvement-reviewer: Validates proposed improvements for proportionality, safety, and effectiveness - /project:diagnose command: Root cause analysis for specific issues - Signal log structure: .claude/logs/signals/ for capturing error signals Enhanced /project:improve: - Now follows full improvement cycle with self-review gates - Integrates with /project:diagnose for each pattern found - System health checks (CLAUDE.md lines, agent/hook counts) - Clear improvement type taxonomy Documentation: - CLAUDE.md: Self-improvement loop diagram and documentation - Signal types, improvement types, review agents documented - System health limits defined (<500 lines, <10 agents, <10 hooks) This creates a meta-system where the development infrastructure continuously improves itself based on error signals.
Synced commands: - signal.md (NEW): Capture human corrections for self-improvement loop - init.md (NEW): 6-phase onboarding with codebase assessment - analyze-logs.md (NEW): Native Claude log analysis - improve.md: Updated with corrections.jsonl support - diagnose.md: Latest version with log awareness Synced hooks: - session-logger.md: Session logging hook template Synced docs: - parallelization-guide.md: Parallel execution patterns Cleanup: - Removed 10 old session log files
rookslog
added a commit
that referenced
this pull request
Dec 26, 2025
Resolves merge conflict in .claude/commands/plan.md by accepting the more comprehensive main branch version. Brings in workflow improvements from PRs #5, #6, #7: - Autonomous development workflow with review gates - Enhanced commands (auto, debug, diagnose, review-pr, etc.) - Session logging and signal capture - Parallelization guide
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Adds new workflow commands and comprehensive lifecycle documentation based on Claude Code ecosystem best practices from claude-enhanced docs.
New Commands
/project:debug- Systematic debugging with hypothesis testing/project:refactor- Safe refactoring with test verification/project:release- Release preparation and changelog generation/project:document- Documentation generation for codeImprovements
plan.mdfor better balance (previously over-emphasized TDD anchors)Workflow Lifecycle
Test Plan
/helpoutput/project:debugwith a sample error/project:refactoron existing code/project:releasefor changelog generation/project:documenton a function/class