skills/findings/SKILL.md
Write reviewer findings to a <slug>.findings.md file for any scoped review target.
npx skillsauth add lightforgelabsstudio/aide findingsInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Write reviewer findings for any scoped target using a two-file message bus. This command applies to a file, ADR, doc set, PR context, diff, uncommitted workspace, or another named review scope.
<slug>.findings.md — owned by the reviewer; primary output of this command; deleted on acceptance<slug>.response.md — owned by the author; deleted on acceptance<slug>.response.md when iterating<slug>.response.md already exists, read it before revising findings.<slug>.findings.md:
# Review: <target name>
## Findings
### Critical
- [path:line or section] Issue. Suggested fix.
### Major / Minor
- ...
## Decision: Request Changes | Approve
<slug>.findings.md."Do not stop at chat-only review output. The findings file is the contract.
<slug>.findings.md.<slug>.response.md:
# Response: <target name>
## Responses
- [Finding ref] Fixed | Deferred: <reason> | Rejected: <reason>
## Target status: Revised | Accepted as-is
<slug>.response.md."Reviewer reads <slug>.response.md. If satisfied: both files deleted, target accepted. If not: iterate.
pr-524, workspace-uncommitted, movement-system, 2026-03-01-network-flow-logistics-system.<issue-number>-<slug> naming when the review is tied to a GitHub issue.testing
Skeptical gap analysis for issues, ADRs, plans, and docs. Use when the user wants a second-pass check for missing decisions, contradictions, edge cases, hidden dependencies, scope drift, or readiness before implementation.
tools
Sync branch with remote and confirm a clean end-of-session state.
testing
Create or update an AIDE skill in .aide/skills with valid frontmatter and a concise workflow.
tools
Decompose an accepted ADR into GitHub issues using the issue-creator tool.