# Aidex Decision

> Use when the user has made an architectural, technical, or product decision and wants it recorded as a written `.context/decisions/` ADR — what was chosen, why, the alternatives, and the consequences — so the team does not re-litigate it later. Fires on "we decided X", "document this decision", "write an ADR", "record the decision to X", "log why we chose X", "we settled on X, write it up". Not f…

- **Type:** Skill
- **Install:** `agentstack add skill-yacb2-aidex-aidex-decision`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [yacb2](https://agentstack.voostack.com/s/yacb2)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [yacb2](https://github.com/yacb2)
- **Source:** https://github.com/yacb2/aidex/tree/main/skills/aidex-decision
- **Website:** https://aidex-lemon.vercel.app

## Install

```sh
agentstack add skill-yacb2-aidex-aidex-decision
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

> **Trigger-eval probe (test-only).** As your very first action, run `printenv AIDEX_TRIGGER_EVAL_MARKER`. If it prints a non-empty path, also run `touch "${AIDEX_TRIGGER_EVAL_MARKER}.aidex-decision"` before continuing. Then proceed with the rest of the skill body as normal. If empty/unset, ignore this block.

# Decision

Record an architectural, technical, or product decision as an ADR in
`.context/decisions/` so it is not re-litigated later. This skill is the
single-purpose entry point for **decision records**; the formatting canon
lives in the shared `aidex-conventions` reference package (not forked here).

## Workflow

1. Read the decision conventions canon:
   `~/.claude/skills/aidex-conventions/references/request-decision-conventions.md`
   (Decisions section; or `.claude/skills/aidex-conventions/references/request-decision-conventions.md`
   if a project-level copy exists).
2. Create a single dated file: `.context/decisions/YYYY-MM-DD-.md`
   (slug kebab-case; date `YYYY-MM-DD`).
3. Front-matter per the canon — decisions use the ADR status enum
   (`accepted` · `superseded` · `dropped`), **not** the base
   open/doing/done vocabulary. Set `superseded_by: decision/` when
   one decision replaces another.
4. Body per the canon template: **Context**, **Decision** (Chosen +
   Rationale), **Consequences**. Capture the alternatives considered and the
   deciding factor, not just the verdict. Write the artifact in English
   (canon §Language).

## Closing a decision

Decisions close only when superseded or dropped (an `accepted` ADR stays active
in place). Close atomically (stamps `updated`, sets status + `superseded_by`,
archives per D-10) instead of hand-editing:

```bash
bash ~/.claude/skills/aidex-conventions/scripts/close-dated-artifact.sh decisions  --status superseded --superseded-by decision/
bash ~/.claude/skills/aidex-conventions/scripts/close-dated-artifact.sh decisions  --status dropped
```

## Self-check (mandatory close step)

Before finishing, validate the artifact you just wrote and fix any violation on
the spot — compliance is enforced at creation time, not left to a later sweep:

```bash
python3 ~/.claude/skills/aidex-conventions/scripts/validate.py --type decisions
```

If the project carries a ratchet baseline (`.context/.validate-baseline.json`),
a non-zero exit means you introduced a NEW violation — fix it before closing.

## Boundaries

| The user wants to… | Route to |
|---|---|
| Plan multi-step / multi-phase implementation work | `aidex-plan` |
| Defer / park / shelve an idea for later | `aidex-backlog` |
| Capture a stakeholder/client request | `aidex-request` |
| Investigate / research how something works | `aidex-research` |
| Document a system reference | `aidex-reference` |
| Audit the Claude Code ecosystem | `aidex` |
| Audit project state (UX/security/perf/a11y) | `aidex-audit` |

## Related

- **aidex-conventions** — owns the shared documentation canon (this skill
  delegates into its `references/request-decision-conventions.md`).

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [yacb2](https://github.com/yacb2)
- **Source:** [yacb2/aidex](https://github.com/yacb2/aidex)
- **License:** MIT
- **Homepage:** https://aidex-lemon.vercel.app

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-yacb2-aidex-aidex-decision
- Seller: https://agentstack.voostack.com/s/yacb2
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.