- Never auto-update this file - only update when explicitly requested
- Verify the bug is reproducible before attempting fixes
- Run build/check after changes to verify code compiles
- Test the fix against the reproduction steps
- Update task status via Task Master when starting (
in-progress) and completing (done)
- Use Context7 MCP tool to fetch library documentation when needed
- Document by feature (e.g.,
editor-widget.md), not by task (e.g., task-1.md)
- Update
docs/index.md when adding new documentation
- Project: [Project Name]
- Path: [Full path to project]
- Tech Stack: [Language, frameworks, key dependencies]
- Version: [Current version]
| Field | Value |
|---|
| Issue | [#XX or N/A] |
| Task ID | [Task Master ID if applicable] |
| Severity | [Critical / High / Medium / Low] |
| Reproducible | [Yes / No / Intermittent] |
| Reported By | [User / Tester / Self] |
| First Seen | [Version or date] |
- [Step 1]
- [Step 2]
- [Step 3]
- Bug occurs: [What happens]
| File | Relevance |
|---|
path/to/file.rs | [Why this file is suspected] |
| Attempt | What Was Tried | Result |
|---|
| 1 | [Approach] | [Why it didn't work] |
| 2 | [Approach] | [Why it didn't work] |
- Follow reproduction steps above
- [Expected: Bug no longer occurs]