Menu
Create an ADR (Architecture Decision Record) for significant architectural decisions. Requires human review.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Create an AIDEC (AI Decision) document to record a technical decision with alternatives considered.
Create an AILOG (AI Action Log) document for the current changes. Quick shortcut for the most common document type.
Execute an external audit of a Charter inside an auditor-side CLI (gemini-cli, claude-cli, copilot-cli, codex-cli). Reads the resolved audit prompt from the canonical location, audits with tool use, writes the report. Operator invokes one instance per CLI.
Generate the unified audit prompt for a Charter at the canonical filesystem location. The operator then opens N auditor-side CLIs (gemini-cli, claude-cli, copilot-cli, etc.) and invokes /straymark-audit-execute in each โ no copy/paste. Counterpart of /straymark-audit-review.
Scaffold a Charter โ StrayMark's bounded unit of work that pairs declarative ex-ante scope with telemetry ex-post. Use when starting a multi-session implementation block (>1 day, >5 tasks, multi-phase).
Show StrayMark documentation status. Use to verify if AI agents properly documented their changes.
| name | straymark-adr |
| description | Create an ADR (Architecture Decision Record) for significant architectural decisions. Requires human review. |
Create an Architecture Decision Record (ADR) for significant architectural decisions.
Note: ADRs created by AI agents are marked as
draftandreview_required: trueby default.
Use this skill for major architectural decisions that affect the system structure, technology stack, or design patterns.
# Get current date
date +%Y-%m-%d
# Get recent changes for context
git diff --stat HEAD~1 2>/dev/null || git diff --stat
# Check for related ADRs
ls .straymark/02-design/decisions/ADR-*.md 2>/dev/null | tail -5
Always confirm before creating:
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ StrayMark ADR โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฃ
โ โ
โ โ ๏ธ ADRs require human review after creation. โ
โ โ
โ ๐ An ADR documents architectural decisions that affect: โ
โ โข System structure โ
โ โข Technology choices โ
โ โข Design patterns โ
โ โข Integration approaches โ
โ โ
โ Please provide: โ
โ 1. Decision title (what architectural decision) โ
โ 2. Context (why is this decision needed) โ
โ 3. The decision and alternatives considered โ
โ โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
# Count existing ADRs for today
ls .straymark/02-design/decisions/ADR-$(date +%Y-%m-%d)-*.md 2>/dev/null | wc -l
Read .straymark/config.yml for language setting:
en (default): .straymark/templates/TEMPLATE-ADR.mdes: .straymark/templates/i18n/es/TEMPLATE-ADR.mdFill template with:
id: ADR-YYYY-MM-DD-NNNtitle: Architectural decision titlestatus: draft (always for AI-created ADRs)created: Current dateupdated: Current dateagent: gemini-cli-v1.0confidence: based on research donereview_required: true (always for ADRs)risk_level: minimum medium for architectural decisionsKey sections to fill:
Save to: .straymark/02-design/decisions/ADR-YYYY-MM-DD-NNN-description.md
โ ๏ธ ADR created (requires human review):
.straymark/02-design/decisions/ADR-YYYY-MM-DD-NNN-description.md
Status: draft
Review Required: YES
StrayMark: Created ADR-YYYY-MM-DD-NNN-description.md (review required)