Agent Start Here

2026-03-31

Use this repo as the system-wide architectural baseline for DIRAC-aligned work.

Read Order

1. ADR index
2. Platform architecture overview
3. DIRAC framework architecture
4. Canonical ADRs
5. Overrides guidance
6. Operations and workflows when the task is process-heavy

How To Use This Repo

• Start here when a task spans multiple repos or needs shared architecture rules.
• Prefer canonical ADRs for baseline direction.
• If a downstream repo publishes an explicit local ADR or manifest that narrows scope, defer to the repo owner for repo-local implementation decisions.
• Use override materials to understand exceptions rather than to replace the canonical model by default.

Typical Questions This Repo Should Answer

• What does the DIRAC framework consider canonical architecture?
• Which cross-repo contracts or naming conventions matter?
• When is a repo allowed to deviate from framework defaults?
• Which documents should an agent read before touching a dirac-* repo?