94 lines
2.3 KiB
Markdown
94 lines
2.3 KiB
Markdown
---
|
|
description: Document a TCR failure to build pattern recognition and learning
|
|
---
|
|
|
|
# Log TCR Failure
|
|
|
|
Document what you tried, why it failed, and what you learned when TCR reverts your code.
|
|
|
|
## Purpose
|
|
|
|
Every TCR revert is a teaching moment. Documenting failures helps you:
|
|
- Calibrate step sizes
|
|
- Recognize patterns in what fails
|
|
- Build confidence in what's safe
|
|
- Track fatigue-related failures
|
|
- Learn your personal coding patterns
|
|
|
|
## Usage
|
|
|
|
When TCR reverts your code, immediately document:
|
|
|
|
1. **What you tried** - Describe the change you attempted
|
|
2. **Why it failed** - What test broke or error occurred
|
|
3. **What you learned** - Pattern or insight gained
|
|
4. **Next step** - How you'll break it down smaller
|
|
|
|
## Log File
|
|
|
|
Creates or appends to `TCR-LEARNINGS.md` in current directory.
|
|
|
|
## Template
|
|
|
|
```markdown
|
|
## [Date] [Time] - [Brief description]
|
|
|
|
**What I tried:** [The change you attempted]
|
|
|
|
**Why it failed:** [Test failure, error message, or behavior]
|
|
|
|
**What I learned:** [Pattern or insight]
|
|
|
|
**Next time:** [How to avoid or what to do differently]
|
|
|
|
**Step size:** Too big | Just right but timing wrong | Other: [explain]
|
|
|
|
**Time of day:** [Morning/Afternoon/Evening - track fatigue patterns]
|
|
|
|
---
|
|
```
|
|
|
|
## Example
|
|
|
|
```markdown
|
|
## 2025-01-20 14:30 - Extract validation and rename together
|
|
|
|
**What I tried:** Extract email validation to helper function AND rename emailAddr to email
|
|
|
|
**Why it failed:** Tests failed because they expected old variable name in error messages
|
|
|
|
**What I learned:** Extract and rename are two separate steps, even if they feel related
|
|
|
|
**Next time:**
|
|
1. Extract with existing names first
|
|
2. Verify tests pass
|
|
3. THEN rename in a second TCR cycle
|
|
|
|
**Step size:** Too big - combined two logical changes
|
|
|
|
**Time of day:** Early afternoon (2:30pm) - moderate fatigue
|
|
|
|
**Pattern:** This is the 3rd time I've failed combining extract + rename. Need to internalize this!
|
|
|
|
---
|
|
```
|
|
|
|
## Auto-Generation
|
|
|
|
If `$ARGUMENTS` provided, use as brief description. Otherwise, prompt for:
|
|
- What you tried
|
|
- Why it failed
|
|
- What you learned
|
|
|
|
Then append to `TCR-LEARNINGS.md` with template filled in.
|
|
|
|
## Review Your Log
|
|
|
|
Periodically review your `TCR-LEARNINGS.md` to:
|
|
- Identify recurring failure patterns
|
|
- Calibrate your step sizes
|
|
- Recognize fatigue indicators
|
|
- Build confidence in safe changes
|
|
|
|
Execute the logging and confirm the entry was added to the file.
|