LLM-Agents-Ecosystem-Handbook

Use when capturing an architecture decision so it survives turnover — produces an ADR-NNNN.md from context, options considered, and the chosen path.

Use after a session to promote useful episodic notes from logs/episodic/ into distilled, dated entries in MEMORY.md and memory/semantic/.

Use when reviewing a proposed REST or GraphQL API change before merge — checks contract clarity, backwards compatibility, errors, pagination, auth, and naming.

Use when first encountering a new dataset — produces a structured profile (schema, missingness, distributions, outliers, gotchas) before any analysis.

Use after an incident is resolved — drafts a blameless postmortem from timeline notes, alerts, and chat threads.

Use before connecting a new MCP server to your agent — produces a structured security review covering source, permissions, tools, network, and approvals.

Use when opening a PR — produces a clean PR description (what / why / how to verify / risks) from a branch diff against base.

Use before opening a PR to audit the changes for stale comments, unused imports, missing tests, and inconsistencies with neighboring code.

Use when the user asks for a sourced briefing on a topic that spans multiple web sources and requires citations.

Use when planning the next sprint — turns ticket intake + team capacity into a planned sprint with explicit non-goals.