whylisted

# /specrails:why — In-Context Help Searches explanation records written by sr-architect, sr-developer, and sr-reviewer agents during the OpenSpec implementation pipeline. Records are stored in `.claude/agent-memory/explanations/` as Markdown files with YAML frontmatter (agent, feature, tags, date). **Usage:** - `/specrails:why` — list the 20 most recent explanation records - `/specrails:why <query>` — search records by keyword or tag --- ## Step 1: Find explanation records Glob all files matching `.claude/agent-memory/explanations/*.md`. If the directory does not exist or contains no files: Print: ``` No explanation records found yet. Explanation records are written by the sr-architect, sr-developer, and sr-reviewer agents when they make significant decisions during feature implementation. Run `/specrails:implement` on a feature to generate your first explanation records. ``` Then stop. ## Step 2: Handle no-argument mode (listing) If `$ARGUMENTS` is empty: Read each explanation record file. Extract from frontmatter: `date`, `agent`, `feature`, `tags`. Extract the first sentence of the `## Decision` section as the decision summary. Sort records by `date` descending. Print the 20 most recent as a Markdown table: ``` ## Recent Explanation Records | Date | Agent | Feature | Tags | Decision | |------|-------|---------|------|----------| | 2026-03-14 | sr-architect | in-context-help | [templates, commands] | Chose flat directory over per-agent subdirectories. | | ...