researchlisted

Use when the user needs to investigate, explore, or spike on how something works and the findings should land as written `.context/research/` notes before any plan or implementation. Fires on "research how X works", "investigate X", "spike on X", "look into how X is done", "I need to understand X before planning". Not for: planning multi-step work once the approach is known (/aidex:plan); recording a decision/ADR (/aidex:decision); capturing a stakeholder request (/aidex:request); documenting a settled, stable reference (/aidex:reference); deferring/parking an idea (/aidex:backlog); ecosystem audits (/aidex:aidex); project-state audits (/aidex:audit).
yacb2/aidex · ★ 2 · AI & Automation · score 78

Install: claude install-skill yacb2/aidex

# Research Capture an investigation or spike as written notes in `.context/research/<topic>/` before committing to a plan or implementation. This skill is the single-purpose entry point for **research notes**; the shared rules (language, IDs, statuses, archive) live in the `conventions` canon, but research's own body shape is defined here. ## Workflow 1. Read the shared documentation canon: `${CLAUDE_PLUGIN_ROOT}/skills/conventions/references/00-global.md` (language, IDs, statuses, archive rules. Or the `.claude/skills/...` project-level copy if one exists). Research has its **own** body shape (below) — it does **not** borrow the reference runbook/MODULE template. 2. Pick the shape by size (ADR `decision/2026-07-02-research-artifact-shape`): a **single-document spike** is one flat dated file (`.context/research/YYYY-MM-DD-<slug>.md` — no folder); a **multi-document topic** is a dated folder (`.context/research/YYYY-MM-DD-<slug>/`) with `00-index.md` (`00-overview.md` is the accepted alias in `research/` only) plus sequential `NN-<slug>.md` files. When a spike gains a second document, promote it: create the dated folder and move the spike in as `00-index.md`. 3. Front-matter = the global minimum only: `title`, `status`, `created`, `updated`. No `version` — a dated spike is a point-in-time investigation, not an evergreen doc that gets revised. 4. Body = research's own minimal shape, three sections: - **Question / Scope** — what you set