How to Audit AGENTS.md and CLAUDE.md for Stale Instructions — Without Deleting Anything

Описание и применение

Инструмент Skill Sunset позволяет безопасно выявлять устаревшие, дублирующиеся и конфликтующие правила в файлах AGENTS.md и CLAUDE.md, генерируя отчёт с рекомендациями и тестовыми шаблонами для подтверждения изменений.

Задача

AI coding agents’ instruction files grow over time, leading to stale, duplicate, or conflicting rules that are hard to clean up safely.

Результат

The audit identifies 11 findings across 5 files, including 2 UPDATE, 1 DEMOTE, 1 RETIRE candidate, and 7 TEST hypotheses, enabling safe, evidence‑based cleanup.

Рабочий процесс

• Run npx skill-sunset@latest audit --codex --open or --claude for a local audit
• Review the generated advisory report bundle
• For TEST findings, generate an experiment template with npx skill-sunset@latest test .skill-sunset/experiment-template.json --root .
• Run experiments only with --run and optionally --inherit-env
• Validate results, obtain human approval, then archive or edit the instruction
• Re‑audit to confirm changes
• Integrate with HOL Guard if desired

Доказательства

The audit is local and read‑only. The core does not call an AI API, consume model quota, or read provider credentials.

Источник

The deterministic findings include a broken local Markdown reference and a complete duplicate generic Skill bundle.

Источник

For a TEST finding, Skill Sunset generates an experiment template.

Источник