Getting started with ai-repo-structure
This repo can be used in three ways:
1. As a learning repo
Read the structure and understand what each layer is for.
Recommended reading order:
README.mdLEARN.mdAGENTS.mdCLAUDE.md.claude/,.github/, and.codex/.agents/skills/skills/
2. As a starter template
Copy the smallest useful structure into your own repo first.
A good minimal adoption path is:
README.mdAGENTS.mdCLAUDE.md.claude/.github/
For a Codex-only repo, README.md and AGENTS.md are enough to start; add .codex/ when you need agents or hooks.
Then add shared external skills/ only when they are useful.
3. As a reference implementation
Use this repo to compare your own structure against a working example.
Best advice
Start simple.
Do not copy every possible file at once.
Instead:
- copy the core files first
- add only the layers you really need
- keep naming and structure consistent
- expand gradually as your repo grows