Skip to content

chore: Repo hygiene + merge readiness notes for integrating into main andhis repo #11

@Whiteks1

Description

@Whiteks1

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

  1. Confirm a single canonical root path is used everywhere: docs/ai/
  2. Remove or mark empty placeholders (no “dead” docs without purpose).
  3. Fix internal links in READMEs and docs to use canonical paths.
  4. 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
  5. 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

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions