rafaie/adr-review
skills/adr-review/SKILL.md
Ensure architectural decisions are recorded and linked (create/update ADRs) at work item level.
$ install --global
skillsauthnpx skillsauth add rafaie/codex_home adr-reviewInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 5, 2026, 6:18 AM176.2s1 file scanned
SKILL.md
- name:
- adr-review
- description:
- Ensure architectural decisions are recorded and linked (create/update ADRs) at work item level.
- Read the target work item folder
spec/features/<work-id>-<slug>/and any related code changes (diff).- For new work,
<work-id>must useS-<stream>-<nnn>(example:S-core-001). - For legacy single-file specs, read the matching file under
spec/features/.
- For new work,
- Decide if any of these happened:
- A major design choice was made/changed (architecture, data model, interfaces, metrics)
- A tradeoff was chosen (perf vs cost vs correctness)
- A new dependency/technology was introduced
- If yes, create or update an ADR under
spec/decisions/:- Prefer
spec/templates/adr.mdif present. - Use a concise format: Context, Decision, Alternatives, Consequences, Links.
- Prefer
- Ensure
feature.md(or the legacy single-file spec) links to the ADR(s) in a “Decisions/ADRs” section. - End by recommending
docs-index-refreshordocs-update.
Related Skills
rafaie/write-tests
testing
VerifiedTrustedCommunity
Add or improve tests based on a work item folder's acceptance criteria and test plan.
1SKILL.mdUpdated May 5, 2026
rafaie/test-runner
testing
VerifiedTrustedCommunity
Run quick/full checks consistently, include smoke, and summarize failures into actionable buckets.
1SKILL.mdUpdated May 5, 2026
rafaie/test-plan
testing
VerifiedTrustedCommunity
Create a work item test plan from acceptance criteria and add it to the work item docs.
1SKILL.mdUpdated May 5, 2026
rafaie/spec-linter
development
VerifiedTrustedCommunity
Review a work item documentation folder for clarity, testability, and completeness before implementation.
1SKILL.mdUpdated May 5, 2026