AI Handoff — Index

Shared context for any AI assistant working on this portal. Model-specific entry points:

• Claude / Claude Code: claude.handoff.md (also read root CLAUDE.md)
• ChatGPT / other assistants: chatgpt.handoff.md

The one-minute briefing (read this first)

• What this repo is: a markdown-first system-of-systems portal for Azwaan’s AI venture ecosystem. Documentation and structure, not application code.
• Three layers, never blur them: repo-level docs (in each repo) → portfolio portal (this repo) → public showcase (future).
• Source of truth: portal/registry/repo-registry.md for repos; portal/ventures/ for ventures.
• Rules of the road: CLAUDE.md and docs/update-conventions.md. These are binding.

Hard constraints for any AI

1. Templates only. Never invent a page shape — copy from templates/.
2. No fabrication. Unknown facts are Unknown/TBD, never guesses. This is a factual map.
3. Stay in your layer. Don’t build the public website (Phase C) or implement the orchestrator (spec only) unless explicitly asked.
4. Keep it consistent. Registry ⇄ digests ⇄ diagrams must always agree; no orphans, no dead links.
5. Respect regions. Preserve <!-- HUMAN --> blocks; only <!-- GENERATED --> blocks are automation-owned.
6. Record decisions. Structural choices become ADRs in portal/decisions/.
7. Update current-state. Any change updates the changelog and, if counts change, the status dashboard.

Where to start for common tasks

Definition of done

The checklist at the end of CLAUDE.md applies to every change.