# Agents Md Retrospective

> Updates AGENTS.md after a repeated verified failure. Do not use for one-off preferences or speculative rules.

- Skill: `mesteriis/agents-md-retrospective` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add mesteriis/agents-md-retrospective`
- Raw SKILL.md: https://api.skillmd.com/api/skills/mesteriis/agents-md-retrospective/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: Mesteriis (https://skillmd.com/u/mesteriis)
- Updated: 2026-08-19
- Page: https://skillmd.com/skills/mesteriis/agents-md-retrospective

---


# AGENTS.md Retrospective

Make instruction updates only when the pattern is durable.

## Workflow

1. Read the relevant local and global instruction files.
2. Identify the exact repeated failure or missing rule.
3. Add the smallest durable instruction that would have prevented it.
4. Avoid duplicating existing rules.
5. Validate by grepping the final instruction and checking for conflicts.

## Rules

- Do not add secrets or environment-specific sensitive values.
- Do not turn AGENTS.md into a skill body.
- Prefer routing rules and validation commands over broad role prose.
- Respect scoped directory instructions.

## Output

- changed instruction file
- rule added or changed
- why it belongs there
- validation command