Context
We will later integrate these docs into the main andhis repository. We need consistent paths, no duplicates, and clear migration notes to avoid breaking links and history.
Affected paths
- README(s) under docs/ai/ (and any root README that references AI docs)
- docs/ai/** (structure audit)
Steps
- Confirm a single canonical root path is used everywhere:
docs/ai/
- Remove or mark empty placeholders (no “dead” docs without purpose).
- Fix internal links in READMEs and docs to use canonical paths.
- Create
docs/ai/MIGRATION_NOTES.md with:
- target path in main
andhis repo
- mapping rules (what folder goes where)
- merge strategy recommendation (subtree/submodule/copy) and chosen approach
- Ensure no duplicate “source of truth” files exist for the same concept.
Definition of Done
- Canonical path is consistent across docs and links
- No duplicate competing sources of truth in AI docs area
- MIGRATION_NOTES.md exists and is actionable for the future merge
- Repo is clean enough to be integrated without manual link-fixing later
Context
We will later integrate these docs into the main
andhisrepository. We need consistent paths, no duplicates, and clear migration notes to avoid breaking links and history.Affected paths
Steps
docs/ai/docs/ai/MIGRATION_NOTES.mdwith:andhisrepoDefinition of Done