straymark-aidec

星标9

分支2

更新时间2026年5月19日 21:19

Create an AIDEC (AI Decision) document to record a technical decision with alternatives considered.

安装

用 Codex 或 Claude 帮你安装复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。

来源

StrangeDaysTech

StrangeDaysTech/arborist-metrics

打开 GitHub 仓库查看创作者相关仓库

下载

StrayMark AIDEC Skill

Create an AI Decision (AIDEC) document to record technical decisions and the alternatives considered.

Instructions

Use this skill when you've made a decision between multiple technical approaches and want to document the reasoning.

1. Gather Context

# Get current date
date +%Y-%m-%d

# Get recent changes for context
git diff --stat HEAD~1 2>/dev/null || git diff --stat

2. Confirm with User

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                          ║
║                                                                   ║
╚══════════════════════════════════════════════════════════════════╝

3. Determine Sequence Number

# Count existing AIDECs for today
ls .straymark/07-ai-audit/decisions/AIDEC-$(date +%Y-%m-%d)-*.md 2>/dev/null | wc -l

4. Check Language and Load Template

Read .straymark/config.yml for language setting:

en (default): .straymark/templates/TEMPLATE-AIDEC.md
es: .straymark/templates/i18n/es/TEMPLATE-AIDEC.md

5. Create Document

Fill template with:

id: AIDEC-YYYY-MM-DD-NNN
title: Decision title from user
created: Current date
agent: claude-code-v1.0
confidence: based on decision clarity
risk_level: based on decision impact

Key sections to fill:

Context: Why was a decision needed?
Problem: What specific problem needed solving?
Alternatives Considered: At least 2 options with pros/cons
Decision: Which was chosen and justification
Consequences: Positive, negative, and risks

Save to: .straymark/07-ai-audit/decisions/AIDEC-YYYY-MM-DD-NNN-description.md

6. Report Result

✅ AIDEC created:
   .straymark/07-ai-audit/decisions/AIDEC-YYYY-MM-DD-NNN-description.md

StrayMark: Created AIDEC-YYYY-MM-DD-NNN-description.md

When to Create an AIDEC

Chose between frameworks/libraries
Selected an algorithm or approach
Decided on a data structure
Made a performance vs. readability trade-off
Selected between design patterns

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 ╔══╗).

同仓库更多 Skills

同仓库

straymark-adr

StrangeDaysTech/arborist-metrics

Create an ADR (Architecture Decision Record) for significant architectural decisions. Requires human review.

2026-05-199

straymark-ailog

StrangeDaysTech/arborist-metrics

Create an AILOG (AI Action Log) document for the current changes. Quick shortcut for the most common document type.

2026-05-199

straymark-audit-execute

StrangeDaysTech/arborist-metrics

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.

2026-05-199

straymark-audit-prompt

StrangeDaysTech/arborist-metrics

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.

2026-05-199

straymark-audit-review

StrangeDaysTech/arborist-metrics

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.

2026-05-199

straymark-charter-new

StrangeDaysTech/arborist-metrics

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).

2026-05-199

name	straymark-aidec
description	Create an AIDEC (AI Decision) document to record a technical decision with alternatives considered.
allowed-tools	Read, Write, Glob, Bash(git diff , git log , git status , date , wc *)

StrayMark AIDEC Skill

Create an AI Decision (AIDEC) document to record technical decisions and the alternatives considered.

Instructions

Use this skill when you've made a decision between multiple technical approaches and want to document the reasoning.

1. Gather Context

# Get current date
date +%Y-%m-%d

# Get recent changes for context
git diff --stat HEAD~1 2>/dev/null || git diff --stat

2. Confirm with User

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                          ║
║                                                                   ║
╚══════════════════════════════════════════════════════════════════╝

3. Determine Sequence Number

# Count existing AIDECs for today
ls .straymark/07-ai-audit/decisions/AIDEC-$(date +%Y-%m-%d)-*.md 2>/dev/null | wc -l

4. Check Language and Load Template

Read .straymark/config.yml for language setting:

en (default): .straymark/templates/TEMPLATE-AIDEC.md
es: .straymark/templates/i18n/es/TEMPLATE-AIDEC.md

5. Create Document

Fill template with:

id: AIDEC-YYYY-MM-DD-NNN
title: Decision title from user
created: Current date
agent: claude-code-v1.0
confidence: based on decision clarity
risk_level: based on decision impact

Key sections to fill:

Context: Why was a decision needed?
Problem: What specific problem needed solving?
Alternatives Considered: At least 2 options with pros/cons
Decision: Which was chosen and justification
Consequences: Positive, negative, and risks

Save to: .straymark/07-ai-audit/decisions/AIDEC-YYYY-MM-DD-NNN-description.md

6. Report Result

✅ AIDEC created:
   .straymark/07-ai-audit/decisions/AIDEC-YYYY-MM-DD-NNN-description.md

StrayMark: Created AIDEC-YYYY-MM-DD-NNN-description.md

When to Create an AIDEC

Chose between frameworks/libraries
Selected an algorithm or approach
Decided on a data structure
Made a performance vs. readability trade-off
Selected between design patterns

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 ╔══╗).