sociuu-better-agent
Refactor Agent Instructions
Make repository guidance easier for an agent to load just in time. Preserve the instructions that affect decisions; do not turn a documentation cleanup into a change to product behavior, delivery workflow, or personal settings.
This skill is for refactoring agent instructions, not for implementing a
product task. Keep existing repository-specific authority and nested
AGENTS.md files intact unless the user explicitly includes them in scope.
Discover before changing
Read the root AGENTS.md, applicable nested AGENTS.md files, and the
repository's instruction/source-of-truth documentation. Inventory each rule
with its source, intended scope, and whether it is actionable and current.
Treat higher-authority project instructions as authoritative rather than as a
contradiction with a lower-level convenience note.