straymark-aidec

Estrellas3

Forks1

Actualizado11 de junio de 2026 a las 06:09

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

Instalación

Instalar con Codex o Claude Copia este prompt, pégalo en Codex, Claude u otro asistente, y deja que revise la página de la skill y la instale por ti.

Fuente

StrangeDaysTech

StrangeDaysTech/straymark

Abrir repositorio de GitHub Ver repositorios del creador

Descarga

Ocupaciones relacionadasSOC

Basado en la clasificación ocupacional SOC

Desarrolladores de softwareOcupaciones informáticas y matemáticas·SOC 15-1252

SKILL.md

readonly

name	straymark-aidec
description	Create an AIDEC (AI Decision) document to record a technical decision with alternatives considered.

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

# 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

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

Más de este repositorio

mismo repositorio

straymark-followups

StrangeDaysTech/straymark

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.

2026-07-263

straymark-followups

StrangeDaysTech/straymark

2026-07-263

straymark-audit-execute

StrangeDaysTech/straymark

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-07-133

straymark-audit-prompt

StrangeDaysTech/straymark

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-07-133

straymark-audit-review

StrangeDaysTech/straymark

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-07-133

straymark-audit-execute

StrangeDaysTech/straymark

2026-07-133

name	straymark-aidec
description	Create an AIDEC (AI Decision) document to record a technical decision with alternatives considered.

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

# 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

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