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
# Get recent changes for context
git diff --stat HEAD~1 2>/dev/null || git diff --stat
Always confirm before creating:
╔══════════════════════════════════════════════════════════════════╗
║ DevTrail 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 .devtrail/07-ai-audit/decisions/AIDEC-$(date +%Y-%m-%d)-*.md 2>/dev/null | wc -l
Read .devtrail/config.yml for language setting:
en (default): .devtrail/templates/TEMPLATE-AIDEC.mdes: .devtrail/templates/i18n/es/TEMPLATE-AIDEC.mdFill template with:
id: AIDEC-YYYY-MM-DD-NNNtitle: Decision title from usercreated: Current dateagent: claude-code-v1.0confidence: based on decision clarityrisk_level: based on decision impactKey sections to fill:
Save to: .devtrail/07-ai-audit/decisions/AIDEC-YYYY-MM-DD-NNN-description.md
✅ AIDEC created:
.devtrail/07-ai-audit/decisions/AIDEC-YYYY-MM-DD-NNN-description.md
DevTrail: Created AIDEC-YYYY-MM-DD-NNN-description.md