AgentStack
Browse Sign in
Browse Why AgentStack Sell Docs
Sign in
SKILL verified MIT Self-run

Aidex Decision

skill-yacb2-aidex-aidex-decision · by yacb2

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…

↗ Website ↗ Repository
— No reviews yet
0 installs
11 views
0.0% view→install

Install

$ agentstack add skill-yacb2-aidex-aidex-decision

✓ scanned · ✓ verified, works with Claude Code, Cursor, and more.

Security review

✓ Passed

No issues found. Passed automated security review. · v0.1.0 How review works →

  • ✓ Prompt-injection patterns
  • ✓ Secret / credential exfiltration
  • ✓ Dangerous shell & filesystem operations
  • ✓ Untrusted network calls
  • ✓ Known-malicious package signatures

What it can access

  • ✓ Network access No
  • ✓ Filesystem access No
  • ✓ Shell / process execution No
  • ✓ Environment & secrets No
  • ✓ Dynamic code execution No

From automated source analysis of v0.1.0. “Used” means the capability is present in the source — more access means more to trust, not that it’s unsafe.

View the full security report →

Verified badge

Passed review? Show it. Paste this badge into your README, it links to the public security report.

AgentStack Verified badge Links to your public security report.
[![AgentStack Verified](https://agentstack.voostack.com/badges/verified.svg)](https://agentstack.voostack.com/security/report/skill-yacb2-aidex-aidex-decision)

Reliability & compatibility

✓ Security review passed
0 installs to date
— no reviews yet
● 29d ago

Declared compatibility

Claude CodeClaude Desktop

Compatibility is declared by the source manifest. End-to-end runtime verification is coming, see below.

Preview Execution monitoring

We're building live execution health for every listing: tool-call success rate, median latency, uptime, and last-checked timestamps, measured, not self-reported. It isn't live yet, so we don't show numbers we can't stand behind.

How agent discovery & health will work →
Are you the author of Aidex Decision? Claim this listing to set pricing, connect Stripe payouts, and keep 70% of every sale.
Sign up to claim

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

  1. Create a single dated file: .context/decisions/YYYY-MM-DD-.md

(slug kebab-case; date YYYY-MM-DD).

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

  1. 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 ~/.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:

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
  • Source: yacb2/aidex
  • License: MIT
  • Homepage: https://aidex-lemon.vercel.app

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

Reviews

No reviews yet, be the first.

Write a review

Versions

  • v0.1.0 Imported from the upstream source.

More in Agent Skills