petcom/adr
skills/adr/SKILL.md
Manage architecture decisions, gaps, and suggestions
testing
Updated Apr 21, 2026
$ install --global
skillsauthnpx skillsauth add petcom/ai_team_config 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 30, 2026, 11:20 AM7.2s1 file scanned
SKILL.md
- name:
- adr
- description:
- Manage architecture decisions, gaps, and suggestions
- argument-hint:
- [check|gaps|suggest|poll|create|review]
Architecture Decision Management
Manage ADRs, track gaps, and process suggestions.
Configuration
Before performing any action below, resolve the ADR root once:
- Look for
./.adr-config.ymlat the project root. - If present and it defines
adr_root, use that value as{adr_root}. - Otherwise, default
{adr_root}todev_communication/shared/architecture.
Every {adr_root}/… path in the rest of this document refers to the resolved value. Substitute it before acting.
Example .adr-config.yml
# Override the ADR storage root.
# Default when this file is absent: dev_communication/shared/architecture
adr_root: docs/architecture
A project that uses the default layout does not need a config file. See .adr-config.yml.example at the submodule root for the canonical template.
Actions
Based on arguments or user request, perform one of these actions:
1. STATUS (default - no arguments)
Show current architecture status.
Trigger: /adr, /adr status
Steps:
- Read
{adr_root}/index.md - Count files in
{adr_root}/suggestions/ - Read
{adr_root}/gaps/index.mdfor gap count - Read
{adr_root}/decision-log.mdfor ADR count
Output:
## Architecture Status
### ADRs: [count] documented
- [count] Accepted
- [count] Proposed
### Gaps: [count] known
- [count] High priority
- [count] Medium priority
### Suggestions: [count] pending review
Use `/adr check` for full analysis.
2. CHECK - Full Traversal & Analysis
Trigger: /adr check, /adr check [domain]
Steps:
- Read architecture index:
{adr_root}/index.md - Read decision log:
{adr_root}/decision-log.md - Scan all ADRs in:
{adr_root}/decisions/*.md - For each ADR extract: ID, Title, Status, Domain
- Compare against expected architecture areas
- Read
{adr_root}/gaps/index.md - Generate comprehensive report
3. GAPS - Gap Analysis Only
Trigger: /adr gaps
Steps:
- Read
{adr_root}/gaps/index.md - For each gap, summarize: Domain, Priority, Suggested ADR
- Recommend top 3 to address
4. SUGGEST - Create Architecture Suggestion
Trigger: /adr suggest, /adr suggest [topic]
Steps:
- If no topic, ask for: Topic, Context, Teams affected, Priority
- Generate filename:
YYYY-MM-DD_{team}_{topic_slug}.md - Create in
{adr_root}/suggestions/ - Confirm created
5. POLL - Scan Messages/Issues for Architecture Decisions
Trigger: /adr poll
Steps:
- Scan messaging directories for unprocessed messages
- Scan active issues
- Look for keywords: "architecture", "pattern", "design decision", "convention"
- Report findings and suggest actions
6. CREATE - Create ADR
Trigger: /adr create, /adr create [suggestion-file]
Steps:
- If suggestion file provided, use content to populate ADR
- Otherwise ask for: Domain, Title, Context, Decision, Consequences
- Read template from
{adr_root}/templates/adr-template.md - Save to:
{adr_root}/decisions/ADR-{DOMAIN}-{NNN}-{TITLE}.md - Update:
{adr_root}/decision-log.md - Update:
{adr_root}/index.md - If from suggestion, archive the suggestion
- If gap addressed, update gaps index
- Confirm created
7. REVIEW - Review/Update Existing ADR
Trigger: /adr review [ADR-ID]
Steps:
- Read the ADR from
{adr_root}/decisions/ - Check for staleness, missing links, implementation drift
- Suggest updates if needed
- If user approves, update the ADR
- Update decision log if status changed
File Locations
{adr_root}/
├── index.md # Main hub
├── decision-log.md # Chronological ADR list
├── decisions/ # ADR files
├── templates/ # ADR template
├── suggestions/ # Pending suggestions
└── gaps/ # Gap tracker
Related Skills
petcom/context
tools
VerifiedTrustedCommunity
Load relevant ADRs, patterns, and memory before implementation
SKILL.mdUpdated Apr 23, 2026
petcom/comms
tools
VerifiedTrustedCommunity
Manage inter-team communication, issues, and coordination
SKILL.mdUpdated Apr 22, 2026
steipete/skill-creator
testing
VerifiedTrustedCommunity
Create, edit, improve, or audit AgentSkills. Use when creating a new skill from scratch or when asked to improve, review, audit, tidy up, or clean up an existing skill or SKILL.md file. Also use when editing or restructuring a skill directory (moving files to references/ or scripts/, removing stale content, validating against the AgentSkills spec). Triggers on phrases like "create a skill", "author a skill", "tidy up a skill", "improve this skill", "review the skill", "clean up the skill", "audit the skill".
356,423SKILL.mdUpdated Apr 13, 2026
steipete/healthcheck
testing
VerifiedTrustedCommunity
Host security hardening and risk-tolerance configuration for OpenClaw deployments. Use when a user asks for security audits, firewall/SSH/update hardening, risk posture, exposure review, OpenClaw cron scheduling for periodic checks, or version status checks on a machine running OpenClaw (laptop, workstation, Pi, VPS).
356,423SKILL.mdUpdated Apr 13, 2026