annotations/.cursor/skills/refactor/templates/list-of-changes.md

List of Changes Template

Save as RUN_DIR/list-of-changes.md. Produced during Phase 1 (Discovery).

---

# List of Changes

**Run**: [NN-run-name]
**Mode**: [automatic | guided]
**Source**: [self-discovered | path/to/input-file.md]
**Date**: [YYYY-MM-DD]

## Summary

[1-2 sentence overview of what this refactoring run addresses]

## Changes

### C01: [Short Title]
- **File(s)**: [file paths, comma-separated]
- **Problem**: [what makes this problematic / untestable / coupled]
- **Change**: [what to do — behavioral description, not implementation steps]
- **Rationale**: [why this change is needed]
- **Risk**: [low | medium | high]
- **Dependencies**: [other change IDs this depends on, or "None"]

### C02: [Short Title]
- **File(s)**: [file paths]
- **Problem**: [description]
- **Change**: [description]
- **Rationale**: [description]
- **Risk**: [low | medium | high]
- **Dependencies**: [C01, or "None"]

---

Guidelines

• Change IDs use format C## (C01, C02, ...) — sequential within the run
• Each change should map to one atomic task (1-5 complexity points); split if larger
• File(s) must reference actual files verified to exist in the codebase
• Problem describes the current state, not the desired state
• Change describes what the system should do differently — behavioral, not prescriptive
• Dependencies reference other change IDs within this list; cross-run dependencies use tracker IDs
• In guided mode, the input file entries are validated against actual code and enriched with file paths, risk, and dependencies before writing
• In automatic mode, entries are derived from Phase 1 component analysis and Phase 2 research findings