straymark-aidec
Create an AIDEC (AI Decision) document to record a technical decision with alternatives considered.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
القائمة
Create an AIDEC (AI Decision) document to record a technical decision with alternatives considered.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | straymark-aidec |
| description | Create an AIDEC (AI Decision) document to record a technical decision with alternatives considered. |
Create an AI Decision (AIDEC) document to record technical decisions and the alternatives considered.
Use this skill when you've made a decision between multiple technical approaches and want to document the reasoning.
# 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
Always confirm before creating:
╔══════════════════════════════════════════════════════════════════╗
║ StrayMark AIDEC ║
╠══════════════════════════════════════════════════════════════════╣
║ ║
║ 📋 AIDEC documents a decision between alternatives. ║
║ ║
║ Please provide: ║
║ 1. Decision title (what was decided) ║
║ 2. Alternatives considered (2-3 options) ║
║ 3. Which alternative was chosen and why ║
║ ║
╚══════════════════════════════════════════════════════════════════╝
# Count existing AIDECs for today
ls .straymark/07-ai-audit/decisions/AIDEC-$(date +%Y-%m-%d)-*.md 2>/dev/null | wc -l
Read .straymark/config.yml for language setting:
en (default): .straymark/templates/TEMPLATE-AIDEC.mdes: .straymark/templates/i18n/es/TEMPLATE-AIDEC.mdFill template with:
id: AIDEC-YYYY-MM-DD-NNNtitle: Decision title from usercreated: 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 decision clarityrisk_level: based on decision impactKey sections to fill:
Save to: .straymark/07-ai-audit/decisions/AIDEC-YYYY-MM-DD-NNN-description.md
✅ AIDEC created:
.straymark/07-ai-audit/decisions/AIDEC-YYYY-MM-DD-NNN-description.md
StrayMark: Created AIDEC-YYYY-MM-DD-NNN-description.md
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.