bjesuiter/jb-adr
skills/jb-adr/SKILL.md
Use when the user mentions ADR, MADR, decision record, architectural decision, design decision, tech decision, or documenting architecture choices.
testing
Updated Jun 4, 2026
$ install --global
skillsauthnpx skillsauth add bjesuiter/skills jb-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: Jun 4, 2026, 4:41 AM386.6s3 files scanned
SKILL.md
- name:
- jb-adr
- description:
- Use when the user mentions ADR, MADR, decision record, architectural decision, design decision, tech decision, or documenting architecture choices.
MADR - Markdown Architectural Decision Records
Create structured ADRs to document important design decisions for coding projects.
Quick Start
- Create new ADR: Use template below in
docs/adr/ - Name format:
NNNN-title.md(e.g.,0001-use-postgres.md) - Link from README: Add to ADR index
ADR Template (Minimal)
# Title
## Status
Proposed | Accepted | Deprecated | Superseded by [NNNN](./NNNN-new-decision.md)
## Context
What is the issue motivating this decision?
## Decision
What is the change being proposed?
## Consequences
What becomes easier or harder because of this change?
Full Template
For complex decisions, use the full template from references/full-template.md:
- Includes Options considered, Pros/Cons, Related decisions
- Load with:
read references/full-template.md
Naming Convention
- Use 4-digit numbering:
0001,0002, ... - Lowercase hyphenated titles
- Example:
0003-select-database.md
Best Practices
- One ADR per decision
- Write for future developers (explain why)
- Include pros/cons of options considered
- Link related ADRs
- Update status when superseded
File Location
Store in docs/adr/ or adr/ at project root.
Related Skills
bjesuiter/jb-clawpatch-review
testing
VerifiedTrustedCommunity
Use when the user mentions Clawpatch/clawpatch.ai, semantic feature review, repo-wide AI audit, persistent findings, or clawpatch init/map/review/report/fix/revalidate.
SKILL.mdUpdated Jun 4, 2026
bjesuiter/jb-autoreview
development
VerifiedTrustedCommunity
Use when the user asks for autoreview, Codex/Claude second-model review, or final review of dirty changes, a branch, commit, or PR before ship.
SKILL.mdUpdated Jun 4, 2026
bjesuiter/jb-release
testing
VerifiedTrustedCommunity
Use when the user asks to cut, prepare, publish, tag, or verify a release, especially npm/package releases.
SKILL.mdUpdated May 30, 2026
bjesuiter/jb-tuna-script
tools
VerifiedTrustedCommunity
Use when adding, writing, fixing, or exposing a script for the Tuna macOS launcher.
SKILL.mdUpdated May 17, 2026