mirror of
https://github.com/catlog22/Claude-Code-Workflow.git
synced 2026-02-12 02:37:45 +08:00
Add interactive analysis workflow with documented discussions and CLI exploration
- Introduced `analyze-with-file` command for collaborative analysis. - Implemented session management for new and continued analysis sessions. - Developed structured phases for topic understanding, exploration, discussion, and conclusion synthesis. - Created detailed documentation for the workflow, including examples and implementation details. - Added Codex prompt for deep analysis and exploration of codebase and concepts.
This commit is contained in:
@@ -506,7 +506,7 @@ Each line is a JSON object:
|
||||
## Iteration Flow
|
||||
|
||||
```
|
||||
First Call (/prompts:debug-with-file BUG="error"):
|
||||
First Call (BUG="error"):
|
||||
├─ No session exists → Explore mode
|
||||
├─ Extract error keywords, search codebase
|
||||
├─ Document initial understanding in understanding.md
|
||||
@@ -514,7 +514,7 @@ First Call (/prompts:debug-with-file BUG="error"):
|
||||
├─ Add logging instrumentation
|
||||
└─ Await user reproduction
|
||||
|
||||
After Reproduction (/prompts:debug-with-file BUG="error"):
|
||||
After Reproduction (BUG="error"):
|
||||
├─ Session exists + debug.log has content → Analyze mode
|
||||
├─ Parse log, evaluate hypotheses
|
||||
├─ Update understanding.md with:
|
||||
@@ -578,32 +578,27 @@ Also we checked A and found B, and then we checked C...
|
||||
Why is config value None during update?
|
||||
```
|
||||
|
||||
## Comparison with /prompts:debug
|
||||
## Key Features
|
||||
|
||||
| Feature | /prompts:debug | /prompts:debug-with-file |
|
||||
|---------|-----------------|---------------------------|
|
||||
| NDJSON logging | ✅ | ✅ |
|
||||
| Hypothesis generation | Manual | Analysis-assisted |
|
||||
| Exploration documentation | ❌ | ✅ understanding.md |
|
||||
| Understanding evolution | ❌ | ✅ Timeline + corrections |
|
||||
| Error correction | ❌ | ✅ Strikethrough + reasoning |
|
||||
| Consolidated learning | ❌ | ✅ Current understanding section |
|
||||
| Hypothesis history | ❌ | ✅ hypotheses.json |
|
||||
| Analysis validation | ❌ | ✅ At key decision points |
|
||||
| Feature | Description |
|
||||
|---------|-------------|
|
||||
| NDJSON logging | Structured debug log with hypothesis tracking |
|
||||
| Hypothesis generation | Analysis-assisted hypothesis creation |
|
||||
| Exploration documentation | understanding.md with timeline |
|
||||
| Understanding evolution | Timeline + corrections tracking |
|
||||
| Error correction | Strikethrough + reasoning for wrong assumptions |
|
||||
| Consolidated learning | Current understanding section |
|
||||
| Hypothesis history | hypotheses.json with verdicts |
|
||||
| Analysis validation | At key decision points |
|
||||
|
||||
## Usage Recommendations
|
||||
## When to Use
|
||||
|
||||
Use `/prompts:debug-with-file` when:
|
||||
Best suited for:
|
||||
- Complex bugs requiring multiple investigation rounds
|
||||
- Learning from debugging process is valuable
|
||||
- Team needs to understand debugging rationale
|
||||
- Bug might recur, documentation helps prevention
|
||||
|
||||
Use `/prompts:debug` when:
|
||||
- Simple, quick bugs
|
||||
- One-off issues
|
||||
- Documentation overhead not needed
|
||||
|
||||
---
|
||||
|
||||
**Now execute the debug-with-file workflow for bug**: $BUG
|
||||
|
||||
Reference in New Issue
Block a user