What documentation is needed?
Add README or index files explaining ownership, allowed content, and migration rules for the new top-level folders.
Parent epic: #282.
Why is this documentation important?
The restructure changes long-standing .github placement rules. Each folder needs a clear contract so future agents and maintainers do not recreate the same ambiguity.
Acceptance Criteria
What documentation is needed?
Add README or index files explaining ownership, allowed content, and migration rules for the new top-level folders.
Parent epic: #282.
Why is this documentation important?
The restructure changes long-standing
.githubplacement rules. Each folder needs a clear contract so future agents and maintainers do not recreate the same ambiguity.Acceptance Criteria
/.schemas/README.mdexplains schema ownership./agents/README.mdexplains portable agent specs./cookbook/README.mdexplains recipes and examples./hooks/README.mdexplains safe hooks and adapters./instructions/README.mdexplains portable instruction scope./plugins/README.mdexplains plugin family strategy./skills/README.mdexplains skill folder rules./workflows/README.mddistinguishes agentic workflows from GitHub Actions.docs/.