Files
5chan/docs/agent-playbooks/bug-investigation.md
T
plebeius e06d367468 docs: split AGENTS.md into core policy and on-demand playbooks
2602.12670 and 2602.11988 findings favoring curated, minimal, modular guidance over comprehensive always-on context
2026-02-23 20:39:58 +08:00

33 lines
895 B
Markdown

# Bug Investigation Workflow
Use this when a bug is reported in a specific file/line/code block.
## Mandatory First Step
Before editing, check git history for the relevant code. Previous contributors may have introduced behavior for an edge case/workaround.
## Workflow
1. Scan recent commit titles (titles only) for the file/area:
```bash
# Recent commit titles for a specific file
git log --oneline -10 -- src/components/post-desktop/post-desktop.tsx
# Recent commit titles for a specific line range
git blame -L 120,135 src/components/post-desktop/post-desktop.tsx
```
2. Inspect only relevant commits with scoped diffs:
```bash
# Show commit message + diff for one file
git show <commit-hash> -- path/to/file.tsx
```
3. Continue with reproduction and fix after understanding the history context.
## Troubleshooting Rule
When blocked, search the web for recent fixes/workarounds.