mirror of https://github.com/catlog22/Claude-Code-Workflow.git synced 2026-02-05 01:50:27 +08:00

Files

catlog22 845925dffb feat: Add intelligent tool selection strategy and simplify plan.md analysis

- Create intelligent-tools.md as strategic guide for tool selection
- Reference intelligent-tools.md from CLAUDE.md for global access
- Add three analysis levels to plan.md (quick/standard/deep)
- Separate tool selection strategy from plan command implementation
- Maintain clear separation of concerns between strategy and execution

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

Co-Authored-By: Claude <noreply@anthropic.com>

2025-09-14 20:10:31 +08:00

2.8 KiB

Raw Blame History

Development Guidelines

Overview

This document defines project-specific coding standards and development principles.

CLI Tool Context Protocols

For all CLI tool usage, command syntax, and integration guidelines:

Gemini (Analysis): @~/.claude/workflows/gemini-unified.md
Codex (Development): @~/.claude/workflows/codex-unified.md
Tool Selection Strategy: @~/.claude/workflows/intelligent-tools.md

Intelligent Context Acquisition

Core Rule: No task execution without sufficient context. Must gather project understanding before implementation.

Context Tools:

Structure: Bash(~/.claude/scripts/get_modules_by_depth.sh) for project hierarchy
Module Analysis: Bash(cd [module] && ~/.claude/scripts/gemini-wrapper -p "analyze patterns")
Full Analysis:

Bash(cd [module] && ~/.claude/scripts/gemini-wrapper -p "analyze [scope] architecture")

Bash(codex --full-auto exec "analyze [scope] architecture")

Context Requirements:

Identify 3+ existing similar patterns before implementation
Map dependencies and integration points
Understand testing framework and coding conventions

Philosophy

Core Beliefs

Incremental progress over big bangs - Small changes that compile and pass tests
Learning from existing code - Study and plan before implementing
Pragmatic over dogmatic - Adapt to project reality
Clear intent over clever code - Be boring and obvious

Simplicity Means

Single responsibility per function/class
Avoid premature abstractions
No clever tricks - choose the boring solution
If you need to explain it, it's too complex

Project Integration

Learning the Codebase

Find 3 similar features/components
Identify common patterns and conventions
Use same libraries/utilities when possible
Follow existing test patterns

Tooling

Use project's existing build system
Use project's test framework
Use project's formatter/linter settings
Don't introduce new tools without strong justification

Important Reminders

NEVER:

Make assumptions - verify with existing code

ALWAYS:

Plan complex tasks thoroughly before implementation
Generate task decomposition for multi-module work (>3 modules or >5 subtasks)
Track progress using TODO checklists for complex tasks
Validate planning documents before starting development
Commit working code incrementally
Update plan documentation and progress tracking as you go
Learn from existing implementations
Stop after 3 failed attempts and reassess

Content Uniqueness Rules

Each layer owns its abstraction level - no content sharing between layers
Reference, don't duplicate - point to other layers, never copy content
Maintain perspective - each layer sees the system at its appropriate scale
Avoid implementation creep - higher layers stay architectural

2.8 KiB Raw Blame History