← ClaudeAtlas

ruleslisted

Rules for how AI agents maintain docs/found-issues.md — logging, annotation after PR/commit, sync, branch-deletion guard, dead code. Auto-loaded every session by the found-issues plugin.
AltDoug/found-issues · ★ 1 · Code & Development · score 71
Install: claude install-skill AltDoug/found-issues
# found-issues — agent rules <!-- loc-override: single auto-loaded ruleset; splitting changes per-session injection --> **Issues found and not tracked are issues lost.** When you notice a defect outside your current task scope, log it — never dismiss it as "pre-existing" or "not my code." The user logs nothing; you maintain `docs/found-issues.md` on their behalf — via the commands below, never direct Write/Edit. ## Logging `/found-issues:log <path:line> — <symptom> (suggested: <fix>)` — `--critical` for urgent items; an abstract topic may replace `path:line`. - **Log:** demonstrable bugs; off-task errors/warnings in test/build/log output; nameable race conditions; security defects; dead code (zero call sites); misleading docs; broken contracts. - **Don't log:** style nits; "could be cleaner"; known deprecations; existing TODOs; things you fixed in-task; third-party bugs; speculation without a concrete symptom; unmeasured perf hypotheticals; duplicates (the command dedups on path:line). - When in doubt, log — false positives get cleaned at sync; false negatives are silent. ## Annotation after PR / commit A hook auto-runs annotation after `gh pr create` and `git commit`: entries whose cited line the diff modifies are annotated automatically and reported in one line. Your job is ONLY the judgment cases the hook surfaces — a candidate list means the CLI could not decide. Compare each candidate's symptom against what the PR/commit actually changes, then run the printed `fou