malhajri07/add-adr
.claude/skills/add-adr/SKILL.md
Create a new Architecture Decision Record in the vault Decisions/ folder, update the ADR Index, and cross-link from related notes. Use when a meaningful trade-off is made, an architectural pattern is chosen, or the user says "we decided to X because Y".
testing
Updated Apr 16, 2026
$ install --global
skillsauthnpx skillsauth add malhajri07/real-estate-CRM-project add-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, 12:55 AM5.3s1 file scanned
SKILL.md
- name:
- add-adr
- description:
- Create a new Architecture Decision Record in the vault Decisions/ folder, update the ADR Index, and cross-link from related notes. Use when a meaningful trade-off is made, an architectural pattern is chosen, or the user says "we decided to X because Y".
add-adr
Capture a non-obvious architectural decision so it survives across sessions.
When to use
Trigger this skill when one of these happens:
- The user explicitly says "let's go with X over Y because..."
- A pattern is chosen that future-Claude could plausibly question
- A trade-off is made between security/perf/dev-speed
- A library, framework, or service is added/replaced
Do not use this for routine implementation choices (variable names, file locations within an existing pattern).
Steps
-
Read
Aqarkom_Knowledge/Decisions/ADR Index.mdto find the next number. -
Create
Aqarkom_Knowledge/Decisions/{NNN} - {Title}.mdwith this template:--- tags: [decision, adr] created: YYYY-MM-DD adr: NNN status: Proposed | Accepted | Superseded --- # ADR NNN — {Title} ## Context What problem are we solving? What constraints are in play? ## Decision The choice we made, in one paragraph. ## Alternatives considered - **Option A** — pros/cons - **Option B** — pros/cons ## Consequences - Positive: ... - Negative: ... - Neutral: ... ## Related - [[Decisions/ADR Index]] - [[other relevant notes]] -
Update the index at
Aqarkom_Knowledge/Decisions/ADR Index.md— add a row to the table. -
Cross-link — find any vault notes affected by this decision and add a "See [[Decisions/NNN - Title]]" line at the bottom.
-
Save a memory of the form
feedbackorprojectif the decision affects how Claude should behave going forward (e.g., "always do X, never do Y").
Verification
- [ ] New ADR file exists
- [ ] Index updated
- [ ] At least one related note links back to it
- [ ] Memory saved if behaviorally relevant
Related Skills
malhajri07/obsidian-markdown
testing
VerifiedTrustedCommunity
Create and edit Obsidian Flavored Markdown with wikilinks, embeds, callouts, properties, and other Obsidian-specific syntax. Use when working with .md files in Obsidian, or when the user mentions wikilinks, callouts, frontmatter, tags, embeds, or Obsidian notes.
SKILL.mdUpdated Apr 16, 2026
malhajri07/obsidian-cli
tools
VerifiedTrustedCommunity
Interact with Obsidian vaults using the Obsidian CLI to read, create, search, and manage notes, tasks, properties, and more. Also supports plugin and theme development with commands to reload plugins, run JavaScript, capture errors, take screenshots, and inspect the DOM. Use when the user asks to interact with their Obsidian vault, manage notes, search vault content, perform vault operations from the command line, or develop and debug Obsidian plugins and themes.
SKILL.mdUpdated Apr 16, 2026
malhajri07/obsidian-bases
data-ai
VerifiedTrustedCommunity
Create and edit Obsidian Bases (.base files) with views, filters, formulas, and summaries. Use when working with .base files, creating database-like views of notes, or when the user mentions Bases, table views, card views, filters, or formulas in Obsidian.
SKILL.mdUpdated Apr 16, 2026
malhajri07/json-canvas
tools
VerifiedTrustedCommunity
Create and edit JSON Canvas files (.canvas) with nodes, edges, groups, and connections. Use when working with .canvas files, creating visual canvases, mind maps, flowcharts, or when the user mentions Canvas files in Obsidian.
SKILL.mdUpdated Apr 16, 2026