found-issues

Plugin found-issues from marketplace altdoug-plugins in AltDoug/claude-plugins. Commands read from the repo's manifest — 14 days ago.

Skills (16)

• verify

  Drive found-issues CLI changes end-to-end — build/launch/drive recipe for verifying bin/found-issues, hooks, and statusline integrations at their real surfaces.

• fi-annotate-commit

  After committing a fix directly (no PR — push-to-main workflows), attach a (commit: <sha>) reference so sync auto-flips the entry once that commit reaches the default branch. Defaults to HEAD: run it AFTER the fix commit exists, never right after cutting a branch — a target already on the default br

• fi-annotate-pr

  After opening a PR that addresses an [open] entry, attach the canonical (PR: org/repo#N) reference so sync auto-flips the entry when the PR merges — bare text like 'PR #N' in an entry is invisible to sync; this command writes the only format that closes the loop. When several entries cite one touche

• fi-archive

  Move old [fixed] entries out of docs/found-issues.md into docs/found-issues-archive.md (keeps the newest 50 or 30 days, whichever threshold hits first). Mutating and one-way — the archive file is append-only and entries do not come back, so use --dry-run to preview. Open and deferred entries are nev

• fi-decide

  Walk the found-issues decision queue: list [open] entries tagged (decide: <question>), present each with 2-4 options and a recommendation, and record the operator's answer with `found-issues decide <match> --answer`. Use when the operator asks to answer pending decisions or SessionStart reports deci

• fi-defer

  Park an [open] entry as [deferred] — it stays in the ledger but leaves the statusline counter, optionally with a reason or mute-until window. Use for known-but-consciously-postponed work, NOT to silence an entry someone should fix (real fixes close via the annotate commands plus sync). Re-deferring

• fi-doctor

  Read-only health check of the found-issues installation — CLI version vs installed plugin, statusline wiring, gh auth, mode detection, hook opt-outs, ledger file state. Run when something looks wrong (counter missing, sync not firing, stale CLI after an update) or after install or upgrade. Diagnoses

• fi-fix

  Work the open ledger as a batch: re-verify every [open] entry against the CURRENT code, triage into buckets, gate on approval, fix the approved ones on a dedicated branch with tests, and ship a precisely annotated PR. Use when asked to fix the found issues or burn down the ledger. Not for logging ne

• fi-log

  Log an out-of-scope issue noticed mid-task to docs/found-issues.md as a dated [open] entry with path:line, symptom, and optional suggested fix. Use whenever a defect, smell, or dead code is noticed that the current task will NOT fix — logging beats dismissing it as pre-existing. Only for NEW observa

• fi-promote-deferred

  Revive a [deferred] entry back to [open], preserving every annotation (touch history, defer-cycle, reason) as evidence of recurrence. Use when a parked issue starts biting again or its mute window expired. Inverse of $fi-defer. Despite the similar name it is unrelated to $fi-promote, which copies br

• fi-promote

  Copy [open] and [deferred] entries that exist only on the current branch onto the default branch before the branch is deleted — entries logged mid-branch would otherwise die with it. Run before branch cleanup; the pre-branch-delete hook blocks deletion until it has run. Despite the similar name it i

• fi-setup

  First-run orientation — explains the system, surfaces optional config, offers the statusline integration and the fi alias. Run once after installing; safe to re-run. Logging itself is zero-config and does not need this.

• fi-status

  Print the current open / in-PR / critical / stale counts as one line. Read-only and safe anytime — use for a quick pulse or when debugging the statusline counter. For the full entry list read docs/found-issues.md directly; for an installation health check use $fi-doctor instead.

• fi-sync

  Reconcile the ledger with reality: flip [open] entries whose annotated PR merged or whose annotated commit landed on the default branch to [fixed], tombstone entries whose cited file git confirms was removed, and surface stale in-PR work. Run after merges land or when the ledger looks out of date. M

• fi-uninstall

  Wipe plugin-private state — statusline segment, onboarding marker, mode cache, fi alias — BEFORE removing the found-issues plugin itself. The ledger (docs/found-issues.md) is repo data and stays untouched. Run only when actually removing the plugin, not for troubleshooting (that is $fi-doctor).

• rules

  Core rules for how AI agents maintain docs/found-issues.md — what to log and how, annotation after PR/commit, the stop marker and the hard rules. The ~1 KB core, injected at session start only when FOUND_ISSUES_SESSION_CONTEXT=lean; the default injects the complete rules from lib/rules-full.md.

Slash commands (14)

• /found-issues:annotate-commit

  Annotate matching [open] entries with a (commit: <sha>) reference

• /found-issues:annotate-pr

  Annotate matching [open] entries with a (PR: org/repo#N) reference

• /found-issues:archive

  Move old [fixed] found-issues entries to an archive file (count threshold 50 OR days threshold 30, whichever first)

• /found-issues:decide

  Answer the found-issues decision queue — entries tagged (decide: <question>) that need a human call before they can be fixed. Walks each question with options and a recommendation, then records the answer so the entry becomes fixable.

• /found-issues:defer

  Defer a [open] found-issue to [deferred] — suppresses it from the statusline counter, optionally adds reason or mute-until window. Re-defers (after promotion) automatically increment the defer-cycle and escalate the touch threshold for the next nudge.

• /found-issues:doctor

  General-purpose health check — CLI version, statusline, gh auth, mode detection, hook opt-outs, issues file state. Read-only diagnostic.

• /found-issues:fix

  Fix open found-issues entries — verify each against current code, triage into buckets, gate on approval, fix on a branch with tests, ship a PR with precise annotations. Runs when the user asks to "fix the found issues" or work through the open ledger.

• /found-issues:log

  Log an out-of-scope issue to docs/found-issues.md

• /found-issues:promote-deferred

  Promote a [deferred] found-issue back to [open] — preserves all annotations (touch history, defer-cycle, reason) as evidence of recurrence and historical context. Inverse of /found-issues:defer.

• /found-issues:promote

  Consolidate [open] and [deferred] entries from current branch into the default branch before deletion

• /found-issues:setup

  First-run setup for found-issues — explains the system, surfaces optional config, walks user through statusline integration if desired

• /found-issues:status

  Print the current open / in-PR / critical / stale counts

• /found-issues:sync

  Sync found-issues — flip merged PRs/commits to [fixed], verify unannotated entries, surface stale work

• /found-issues:uninstall

  Clean up plugin-private state (statusline segment, onboarding marker, mode cache, /fi alias) before /plugin uninstall

Subagents (2)

• found-issues-fixer

  Unattended found-issues auto-fixer for ONE queued auto-fix item. Start it only when a found-issues hook message asks for it, in the background, with the prompt "Fix found-issues auto-fix item <id>." Never use it for general bug fixing.

• found-issues-sweeper

  Unattended found-issues auto-sweep for ONE queued sweep item. Start it only when a found-issues hook message asks for it, in the background, with the prompt "Run found-issues auto-fix sweep <id>." Never use it for general bug fixing.

Hooks (7)

• PreToolUse

  "${CLAUDE_PLUGIN_ROOT}/hooks/format-enforcer.sh"

• PreToolUse

  "${CLAUDE_PLUGIN_ROOT}/hooks/pre-branch-delete.sh"

• PostToolUse

  "${CLAUDE_PLUGIN_ROOT}/hooks/post-bash-dispatch.sh"

• PostToolUse

  "${CLAUDE_PLUGIN_ROOT}/hooks/first-touch.sh"

• SessionStart

  "${CLAUDE_PLUGIN_ROOT}/hooks/session-start.sh"

• Stop

  "${CLAUDE_PLUGIN_ROOT}/hooks/stop-reminder.sh"

• UserPromptSubmit

  "${CLAUDE_PLUGIN_ROOT}/hooks/prompt-nudge.sh"

Similar plugins