メニュー
Create an ADR (Architecture Decision Record) for significant architectural decisions. Requires human review.
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
SOC 職業分類に基づく
| 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
# Summarize the CURRENT work (staged + unstaged + untracked) — label each block.
# Avoid `HEAD~1`: it describes the previous commit, not the work being decided on.
git diff --cached --stat # staged changes
git diff --stat # unstaged changes
git status --porcelain # includes untracked files
# 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: your runtime's canonical agent identity (see AGENT-RULES.md §1 — e.g. claude-code-v1.0, gemini-cli-v1.0, codex-cli-v1.0; do not assume Claude)confidence: 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)
Terminal compatibility: If the terminal does not support box-drawing characters (Unicode), use plain-text formatting with dashes and pipes instead (e.g.,
+--+instead of╔══╗).
Maintain the follow-ups backlog registry — the canonical answer to "what's pending?". Session-start glance, pre-commit drift --apply, post-Charter-close triage (note / set-status), ex-ante creation at Charter declaration (new), and operator-gated promote. Thin wrapper over the straymark followups CLI; never edits CLI-owned counters by hand.
Maintain the follow-ups backlog registry — the canonical answer to "what's pending?". Session-start glance, pre-commit drift --apply, post-Charter-close triage (note / set-status), ex-ante creation at Charter declaration (new), and operator-gated promote. Thin wrapper over the straymark followups CLI; never edits CLI-owned counters by hand.
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.
Consolidate N external auditor reports into a critical review document with verdicts, remediation plan, and auditor ratings. Then merge the external_audit YAML block into the Charter telemetry. Counterpart of /straymark-audit-prompt and /straymark-audit-execute.
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.