[go: up one dir, main page]

P8SHOULD

Discoverable Through Agent Skill Bundles

Definition

Without a skill bundle, every fresh agent invocation begins the same way: pull --help, infer the idioms, try a command, parse the error, try again. A skill bundle (canonical names AGENTS.md or SKILL.md) collapses that loop: agent-discoverable through filesystem convention rather than through --help, loaded once, recognized thereafter.

Why Agents Need It

--help describes what is possible (the flag and subcommand surface); a skill bundle describes what to do (workflow knowledge, common compositions, recovery patterns). Workflow knowledge does not fit in after_help examples. The bundle is also where conventions that span multiple subcommands live (exit-code tables, output-channel discipline, retry semantics): context that --help for a single subcommand cannot carry on its own. Without one, the agent has nowhere to durably register what it learned, and re-pays the discovery cost on every fresh session.

Audited live by anc audit <tool> --principle 8: behavioral and source checks.

Requirements

Evidence

Anti-Patterns

Measured by audit IDs p8-bundle-install, p8-bundle-exists, p8-install-all, p8-bundle-update. Run anc audit --principle 8 . against the CLI under test to see each.