Commit Graph

17 Commits

Author SHA1 Message Date
catlog22
96d4d8e7d4 refactor: Enhance workflow system flexibility and convert to English
## Major Changes

### Workflow Architecture Enhancements
- **Simplified pre_analysis definition**: Removed overly specific JSON examples
- **Added flexibility principles**: Emphasized task-driven approach over template copying
- **Enhanced implementation_approach**: Added four design principles and clear field descriptions
- **Converted all Chinese content to English**: Improved international accessibility

### Agent Documentation Updates
- **code-developer.md**: Updated flow control execution to emphasize four flexible context acquisition methods
- **code-review-test-agent.md**: Simplified context gathering process description with practical examples

### Key Improvements
- **Flexibility over rigidity**: Removed mechanical template copying tendency
- **Clear separation**: pre_analysis for context gathering only, no implementation actions
- **Practical examples**: Added dependency task summary reference patterns
- **Consistent language**: Full English documentation for better collaboration

## Benefits
- Restored system flexibility for diverse task requirements
- Clear guidance without prescriptive templates
- Better international accessibility
- Maintained structural integrity while improving usability

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-09-16 11:18:03 +08:00
catlog22
ab32650cf8 refactor: Enhance workflow system with comprehensive improvements
Agent enhancements:
- Add free exploration phase for supplementary context gathering
- Update project structure documentation with detailed hierarchy
- Improve summary template with standardized naming convention
- Add comprehensive search strategies with bash command examples

Architecture improvements:
- Add extensive combined search strategy examples (rg, grep, find, awk, sed)
- Enhance flow control with pattern discovery commands
- Update path reference format for session-specific commands
- Improve session naming rules with WFS prefix explanation
- Reorganize document structure for better readability

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-09-15 23:31:51 +08:00
catlog22
f1a0412166 docs: Refactor and streamline workflow command documentation
- plan.md: Compress from 307 to 183 lines while preserving all core functionality
  - Add project structure analysis with get_modules_by_depth.sh integration
  - Implement 5-field JSON schema compliance with workflow-architecture.md
  - Add detailed context acquisition strategy with tool templates
  - Include comprehensive file cohesion principles and variable system
  - Maintain 10-task limit enforcement and pre-planning analysis requirements

- execute.md: Compress from 380 to 220 lines with enhanced agent context
  - Preserve complete Task execution patterns with full flow control context
  - Maintain comprehensive session context, implementation guidance, and error handling
  - Streamline discovery process while keeping all critical execution details
  - Keep complete agent assignment and status management functionality

- workflow-architecture.md: Minor structural updates for consistency

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-09-15 22:33:37 +08:00
catlog22
6570af264d Refactor workflow plan command and architecture documentation
- Simplified argument hints and examples in plan.md
- Enhanced input detection logic for files, issues, and text
- Introduced analysis levels for improved context analysis
- Updated core rules for task limits and decomposition strategies
- Improved session management with active session marker system
- Expanded file structure reference and naming conventions
- Clarified task hierarchy and status rules
- Added detailed validation and error handling procedures
- Streamlined document templates for implementation plans and task summaries
2025-09-15 22:11:31 +08:00
catlog22
9371af8d8d refactor: Enforce 10-task limit and file cohesion across workflow system
- Update workflow-architecture.md: Streamline structure, enforce 10-task hard limit
- Update workflow plan.md: Add file cohesion rules, similar functionality warnings
- Update task breakdown.md: Manual breakdown controls, conflict detection
- Update task-core.md: Sync JSON schema with workflow-architecture.md
- Establish consistent 10-task maximum across all workflow commands
- Add file cohesion enforcement to prevent splitting related files
- Replace "Complex" classification with "Over-scope" requiring re-planning

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-09-15 21:55:28 +08:00
catlog22
12f9e34223 refactor: Enhance agent definitions and workflow documentation structure
- Update agent role definitions with clearer responsibilities and capabilities
- Refine task execution workflows with improved context gathering protocols
- Enhance tool implementation guide with better command examples
- Streamline workflow architecture documentation for better clarity

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-09-15 15:58:06 +08:00
catlog22
381c4af865 fix: Replace ls with find for Windows compatibility in workflow architecture
- Replace 'ls .workflow/.active-* 2>/dev/null' with 'find .workflow -name ".active-*"'
- Update session detection, switching, and consistency check commands
- Improves Windows environment compatibility for workflow activation flags

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-09-14 15:44:55 +08:00
catlog22
56bd586506 feat: Implement intelligent task saturation control for workflow planning
- Add task saturation assessment to merge preparation with execution when appropriate
- Optimize complexity thresholds: <3/<8 saturated tasks instead of <5/<15
- Enhance JSON schema with preparation_complexity, preparation_tasks, estimated_prep_time
- Update execute.md to handle merged tasks with PREPARATION_INCLUDED marker
- Add document reference paths for execution phase
- Reduce task fragmentation while preserving complex preparation when needed

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-09-14 10:23:13 +08:00
catlog22
c79672fb25 docs: Emphasize on-demand file creation in workflow architecture
- Update unified file structure to stress on-demand creation principle
- Add creation strategy section with explicit guidance:
  - Initial setup creates only required files (session.json, IMPL_PLAN.md, TODO_LIST.md, .task/)
  - Optional directories (.brainstorming/, .chat/, .summaries/) created when first needed
- Update core design principles to include on-demand file creation
- Add session initialization and directory creation examples in Data Operations

This ensures workflows start lean and expand only as functionality is used.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-09-13 23:10:05 +08:00
catlog22
86c9347b56 docs: Unify workflow architecture and optimize Gemini CLI guidelines
- Simplify workflow-architecture.md to focus on core architecture principles
- Remove progressive file structures, adopt unified structure for all workflows
- Reduce task hierarchy from 3 levels to 2 levels (impl-N.M max)
- Eliminate non-architectural content (performance notes, detailed templates)
- Emphasize dynamic task decomposition over file structure complexity

- Update gemini-unified.md token limit handling guidance
- Remove emphasis on --all-files as default behavior
- Add explicit token limit fallback strategies with examples
- Strengthen guidance for immediate retry with targeted patterns

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-09-13 23:08:26 +08:00
catlog22
b717f229a4 feat: Optimize TODO_LIST structure with hierarchical display and container task handling
- Replace separate Main Tasks/Subtasks sections with unified hierarchical list
- Use ▸ symbol for container tasks (with subtasks) instead of checkboxes
- Maintain standard - [ ]/- [x] for executable leaf tasks
- Add 2-space indentation to show task hierarchy clearly
- Include status legend for better user understanding

Benefits:
- Eliminates confusion about non-executable main tasks
- Provides clear visual hierarchy in single list
- Reduces TODO_LIST complexity and improves usability
- Aligns container task concept with execution model

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-09-13 11:45:52 +08:00
catlog22
9a4003deda feat: Add task-specific path management system for precise CLI analysis
- Add 'paths' field to task JSON schema with semicolon-separated concrete paths
- Create read-task-paths.sh script to convert paths to Gemini @ format
- Update all agents to use task-specific paths instead of --all-files
- Integrate get_modules_by_depth.sh for project structure discovery
- Update workflow planning to populate paths field automatically
- Enhance execute command to pass task-specific paths to agents
- Update documentation for new path management system

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-09-13 11:28:16 +08:00
catlog22
685c0f7f79 feat: Add Codex CLI support as alternative analysis method in workflow system
## Major Changes
- Add --AM flag to /workflow:plan command for analysis method selection
- Support both Gemini CLI (pattern-based) and Codex CLI (autonomous) analysis
- Implement dual marker system: [GEMINI_CLI_REQUIRED] and [CODEX_CLI_REQUIRED]
- Update all 4 agents to handle both analysis markers
- Create analysis method templates for standardized CLI usage

## Files Modified
- workflow-architecture.md: Add Analysis Method Integration section
- plan.md: Add --AM flag and bilingual rule standardization
- execute.md: Update marker mapping logic and standardize to English
- 4 agent files: Add dual CLI support with usage guidelines
- New: analysis-methods/ templates for Gemini and Codex CLI

## Backward Compatibility
- Gemini CLI remains default analysis method
- Existing workflows continue to work unchanged
- Progressive enhancement for autonomous development scenarios

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-09-12 23:40:12 +08:00
catlog22
a944e31962 Add comprehensive analysis and development templates for CLAUDE workflows
- Introduced new analysis templates for architecture, implementation patterns, performance, quality, and security.
- Created detailed development templates for component creation, debugging, feature implementation, refactoring, testing, and migration planning.
- Established structured documentation guidelines for root, domain, module, and sub-module levels to enhance clarity and organization.
- Implemented a hierarchy analysis template to optimize project structure and documentation depth.
- Updated codex-unified documentation to reflect new command structures, template usage, and best practices for autonomous development workflows.
2025-09-10 21:54:15 +08:00
catlog22
5b80c9c242 feat: Streamline agents to pure executor roles with enhanced workflow architecture
## Agent Streamlining
- **code-developer.md**: Reduce from 315 to 122 lines - pure code execution focus
- **action-planning-agent.md**: Reduce from 502 to 124 lines - pure planning execution
- Remove complex decision logic - commands layer now handles control flow
- Add clean code rules: minimize debug output, GBK compatibility, ASCII-only

## Workflow Architecture Enhancements
- Enhanced workflow-architecture.md with progressive complexity system
- Clear separation: Commands (control) → Agents (execution) → Output
- Improved task decomposition and TODO_LIST.md examples
- Added Gemini CLI standards references

## Command System Updates
- Updated task and workflow commands with enhanced functionality
- Better integration with streamlined agents
- Improved error handling and user experience

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-09-10 21:41:58 +08:00
catlog22
44287cf80e fix: Remove unnecessary metadata and timestamps from task and workflow documentation 2025-09-10 20:32:11 +08:00
catlog22
f76e5edbdf refactor: consolidate workflow documentation into unified architecture
- Create unified workflow-architecture.md combining:
  - data-model.md (JSON-only architecture, task schemas)
  - file-structure-standards.md (progressive structures, templates)
  - session-management-principles.md (marker files, session ops)
  - complexity-rules.md (classification thresholds, behaviors)

- Update 11 files with references to new consolidated document
- Remove redundant documentation while preserving all functionality
- Streamline maintenance with single source of truth

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-09-09 22:15:17 +08:00