mirror of
https://github.com/catlog22/Claude-Code-Workflow.git
synced 2026-02-11 02:33:51 +08:00
95 lines
2.6 KiB
Plaintext
95 lines
2.6 KiB
Plaintext
Template for generating lessons-learned.md
|
|
|
|
## Purpose
|
|
Aggregate lessons learned from workflow sessions, categorized by functional domain and severity.
|
|
|
|
## File Location
|
|
`.claude/skills/workflow-progress/lessons-learned.md`
|
|
|
|
## Update Strategy
|
|
- **Incremental mode**: Merge new session lessons into existing categories, update frequencies
|
|
- **Full mode**: Regenerate entire lessons document from all sessions
|
|
|
|
## Structure
|
|
|
|
```markdown
|
|
# Workflow Lessons Learned
|
|
|
|
## Best Practices (Successes)
|
|
|
|
### {Domain_Category}
|
|
- {success_pattern_1} (sessions: {session_id_1}, {session_id_2})
|
|
- {success_pattern_2} (sessions: {session_id_3})
|
|
|
|
### {Domain_Category_2}
|
|
...
|
|
|
|
---
|
|
|
|
## Known Challenges
|
|
|
|
### High Priority
|
|
- **{challenge_title}**: {description}
|
|
- Affected sessions: {session_id_1}, {session_id_2}
|
|
- Resolution: {resolution_strategy}
|
|
|
|
### Medium Priority
|
|
- **{challenge_title}**: {description}
|
|
- Affected sessions: {session_id_3}
|
|
- Resolution: {resolution_strategy}
|
|
|
|
### Low Priority
|
|
...
|
|
|
|
---
|
|
|
|
## Watch Patterns
|
|
|
|
### Critical (3+ sessions)
|
|
1. **{pattern_name}**: {description}
|
|
- Frequency: {count} sessions
|
|
- Affected: {session_list}
|
|
- Mitigation: {mitigation_strategy}
|
|
|
|
### High Priority (2 sessions)
|
|
...
|
|
|
|
### Normal (1 session)
|
|
...
|
|
```
|
|
|
|
## Data Sources
|
|
- Lessons: `manifest.json` -> `archives[].lessons.{successes|challenges|watch_patterns}`
|
|
- Session metadata: `.workflow/.archives/{session_id}/workflow-session.json`
|
|
|
|
## Aggregation Rules (Use CCW CLI)
|
|
|
|
**Command Pattern**:
|
|
```bash
|
|
ccw cli exec "
|
|
PURPOSE: Aggregate workflow lessons from session data
|
|
TASK: • Group successes by functional domain • Categorize challenges by severity (HIGH/MEDIUM/LOW) • Identify watch patterns with frequency >= 2 • Mark CRITICAL patterns (3+ sessions)
|
|
MODE: analysis
|
|
CONTEXT: @.workflow/.archives/manifest.json
|
|
EXPECTED: Aggregated lessons with frequency counts
|
|
RULES: $(cat ~/.claude/workflows/cli-templates/prompts/workflow/skill-aggregation.txt) | analysis=READ-ONLY
|
|
" --tool gemini --cd .workflow/.archives
|
|
```
|
|
|
|
**Severity Classification**:
|
|
- **HIGH**: Blocked development >4 hours OR repeated in 3+ sessions
|
|
- **MEDIUM**: Required significant rework OR repeated in 2 sessions
|
|
- **LOW**: Minor issues resolved quickly
|
|
|
|
**Pattern Identification**:
|
|
- Successes in 3+ sessions → "Best Practices"
|
|
- Challenges repeated 2+ times → "Known Issues"
|
|
- Watch patterns frequency >= 2 → "High Priority Warnings"
|
|
- Watch patterns frequency >= 3 → "CRITICAL"
|
|
|
|
## Formatting Rules
|
|
- Sort by frequency (most common first)
|
|
- Include session references for traceability
|
|
- Use bold for challenge titles
|
|
- Keep descriptions concise but actionable
|