القائمة
Create an ADR (Architecture Decision Record) for significant architectural decisions. Requires human review.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
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.
| 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)