washingtonguilhardes/adr
.rulesync/skills/adr/SKILL.md
Create Architecture Decision Records documenting technical decisions
testing
Updated Apr 16, 2026
$ install --global
skillsauthnpx skillsauth add washingtonguilhardes/example.hr-module adrInstall 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: Apr 16, 2026, 10:36 PM19.1s1 file scanned
SKILL.md
- name:
- adr
- description:
- Create Architecture Decision Records documenting technical decisions
ADR Task
Persona: Execute this task as the @architect subagent.
Load the persona characteristics from .rulesync/subagents/architect.md before proceeding.
Objective
Create Architecture Decision Records documenting technical decisions, context, alternatives, consequences. Build searchable history.
Instructions
-
Discovery: - Ask: Decision to document?, What prompted? (business requirement, constraint, incident)
-
Gather context: - Ask: Problem solving?, Constraints?, Goals/non-goals?, Stakeholders?
-
Explore alternatives: - For each option: Approach?, Pros?, Cons?, Estimated effort?, Risks?
-
Document: - Check existing ADRs in
docs/decisions/- Create:docs/decisions/DRAFT-{slug}.md(number assigned automatically on merge) - Template sections: Title, Author, Stakeholders, Superseded/Supersedes links, Context and Problem Statement, Decision Drivers, Considered Options (Description/Pros/Cons/Effort), Decision Outcome (Chosen Option, Justification), Consequences (Positive/Negative/Neutral), Implementation (approach, components, migration path, rollback plan), Validation (success metrics, review date), References, Related Decisions - Note: Date and number are auto-assigned by GitHub Action when the PR is merged - Do not specify estimated implementation time - Note: A GitHub Action will automatically assign the next sequential number when the PR is merged -
Update index: - Create/update:
docs/decisions/README.md- Sections: Active Decisions table, Deprecated Decisions table, By Category (Architecture, Database, Infrastructure) -
Link artifacts: - Ask: Related specs, briefs, PRs, issues, discussions, external research/articles? - Add links to ADR
-
Generate diagram (optional): - Offer: Architecture diagram, flow diagram, comparison diagram
-
Set review: - For major decisions: Review checkpoint dates, success metrics
-
Summary (Added to the top): - ADR number, title, file path - Decision summary, key points, alternatives considered, impact, links, index updated
Related Skills
washingtonguilhardes/trace-audit
testing
VerifiedTrustedCommunity
Analyze distributed traces to find blocking queries, N+1 patterns, and missing tRPC encapsulation, then produce prioritized fixes
SKILL.mdUpdated Apr 16, 2026
washingtonguilhardes/test
testing
VerifiedTrustedCommunity
required reading for all test/spec files or test related queries.
SKILL.mdUpdated Apr 16, 2026
washingtonguilhardes/spec
testing
VerifiedTrustedCommunity
Transform Product Brief into Technical Specification
SKILL.mdUpdated Apr 16, 2026
washingtonguilhardes/spec-drift
development
VerifiedTrustedCommunity
Detect drift between code implementations and specification documents
SKILL.mdUpdated Apr 16, 2026