Claude-Code-Workflow/.claude/workflows/file-modification.md at c16da759b2094dda013983860688d8d943d5428f

mirror of https://github.com/catlog22/Claude-Code-Workflow.git synced 2026-02-11 02:33:51 +08:00

Files

catlog22 c16da759b2 Fix session management location inference and ccw command usage

This commit addresses multiple issues in session management and command documentation:

Session Management Fixes:
- Add auto-inference of location from type parameter in session.ts
- When --type lite-plan/lite-fix is specified, automatically set location accordingly
- Preserve explicit --location parameter when provided
- Update session-manager.ts to support type-based location inference
- Fix metadata filename selection (session-metadata.json vs workflow-session.json)

Command Documentation Fixes:
- Add missing --mode analysis parameter (3 locations):
  * commands/memory/docs.md
  * commands/workflow/lite-execute.md (2 instances)
- Add missing --mode write parameter (4 locations):
  * commands/workflow/tools/task-generate-agent.md
- Remove non-existent subcommands (3 locations):
  * commands/workflow/session/complete.md (manifest, project)
- Update session command syntax to use simplified format:
  * Changed from 'ccw session manifest read' to 'test -f' checks
  * Changed from 'ccw session project read' to 'test -f' checks

Documentation Updates:
- Update lite-plan.md and lite-fix.md to use --type parameter
- Update session/start.md to document lite-plan and lite-fix types
- Sync all fixes to skills/command-guide/reference directory (84 files)

All ccw command usage across the codebase is now consistent and correct.

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

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

2025-12-17 18:09:23 +08:00

1.4 KiB

Raw Blame History

File Modification

Use edit_file (MCP)

Built-in Edit tool failed 1+ times
Need dry-run preview before applying changes
Need line-based operations (insert_after, insert_before)
Need to replace all occurrences at once
Built-in Edit returns "old_string not found"
Whitespace/formatting issues in built-in Edit

Mode Selection:

mode=update: Replace text
mode=line: Line-based operations

Use write_file (MCP)

Creating brand new files
MCP edit_file still fails (last resort)
Need to completely replace file content
Need backup before overwriting
User explicitly asks to "recreate file"

Priority Logic

File Reading:

Known single file → Built-in Read
Multiple files OR pattern matching → read_file (MCP)
Unknown location → smart_search then Read
Large codebase + repeated access → smart_search (indexed)

File Editing:

Always try built-in Edit first
Fails 1+ times → edit_file (MCP)
Still fails → write_file (MCP)

Search:

External knowledge → Exa
Exact pattern in small codebase → Built-in Grep
Semantic/unknown location → smart_search
Large codebase + repeated searches → smart_search (indexed)

Decision Triggers

Start with simplest tool (Read, Edit, Grep) Escalate to MCP tools when built-ins fail or inappropriate Use semantic search for exploratory tasks Use indexed search for large, stable codebases Use Exa for external/public knowledge

1.4 KiB Raw Blame History