AttuneLearning/adr
codex-workflow/skills/adr/SKILL.md
Manage architecture decisions, gaps, and suggestions in dev_communication/shared/architecture.
development
Updated Apr 3, 2026
$ install --global
skillsauthnpx skillsauth add AttuneLearning/agent-workflow 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 3, 2026, 11:45 AM50.4s1 file scanned
SKILL.md
- name:
- adr
- description:
- Manage architecture decisions, gaps, and suggestions in dev_communication/shared/architecture.
ADR Skill
Use this skill when the user asks to inspect architecture state, create suggestions, draft ADRs, or review ADR drift.
Team-awareness
Read active team config from .codex-workflow/config/active-team.json when present.
Use team default paths (especially architecture_root) as the first lookup location.
Actions
1. Status (default)
- Read architecture hub/index files.
- Count decisions, gaps, and pending suggestions.
- Return concise status summary.
2. Check (full analysis)
- Scan architecture decisions and logs.
- Extract: ADR ID, title, status, and domain.
- Cross-check against gap tracker.
- Report missing/weakly-covered domains.
3. Gaps
- Read gap index.
- Summarize by priority and domain.
- Recommend next ADRs to create.
4. Suggest
- Gather topic, context, teams impacted, and priority.
- Create suggestion in
dev_communication/shared/architecture/suggestions/. - Filename:
YYYY-MM-DD_{team}_{topic_slug}.md.
5. Poll
- Scan team inboxes and active issues.
- Detect architecture-significant changes.
- Propose ADR suggestions where needed.
6. Create ADR
- Gather ADR fields (or source from suggestion file).
- Use ADR template from architecture templates.
- Save ADR under
dev_communication/shared/architecture/decisions/. - Update indexes/logs and mark linked suggestion/gap if addressed.
7. Review ADR
- Read target ADR.
- Check for staleness and implementation drift.
- Propose updates; apply on user approval.
Output expectations
- Include exact file paths touched.
- Separate observations from recommendations.
- Keep summaries short unless the user requests deep analysis.
Related Skills
AttuneLearning/reflect
tools
VerifiedTrustedCommunity
Capture implementation learnings, pattern candidates, and architecture gaps after coding work.
SKILL.mdUpdated Apr 3, 2026
AttuneLearning/refine
data-ai
VerifiedTrustedCommunity
Periodically review patterns, promote mature patterns to ADRs, and identify coverage gaps.
SKILL.mdUpdated Apr 3, 2026
AttuneLearning/memory
tools
VerifiedTrustedCommunity
Manage the project memory vault for notes, entities, patterns, and session summaries.
SKILL.mdUpdated Apr 3, 2026
AttuneLearning/context
tools
VerifiedTrustedCommunity
Load relevant ADRs, patterns, and memory before implementation work.
SKILL.mdUpdated Apr 3, 2026