Session Retrospective

Capture repeated mistakes and workflow friction after meaningful work. Use when a task exposed recurring failures, confusing prompts, missing guardrails, or instructions that should be tightened for future Codex sessions.

jwilger 491d43a 1.1 KB Updated

File contents

Session Retrospective

Use this skill to tighten the workflow without turning every task into process work.

Trigger conditions

  • The same correction happened more than once.
  • A risky command path needed a manual catch.
  • AGENTS.md or a skill was missing an important routing rule.
  • A hook should warn earlier or more clearly.

Workflow

  1. Summarize the friction in one sentence.
  2. Identify whether the fix belongs in:
    • AGENTS.md
    • a plugin skill
    • a hook script
    • a helper script
  3. Prefer the smallest durable fix.
  4. Do not mutate this plugin automatically unless the user asked for it or the current task is explicitly about plugin maintenance.

Output

  • A concise proposed change
  • Why it prevents the repeat failure
  • Whether it is local to one repo or belongs in the shared plugin

jwilger/codex-sdlc/tree/main/plugins/codex-sdlc/skills/session-retrospective commit 491d43a1aa

Frequently asked questions

npx skillmds@latest add jwilger/session-retrospective