sky-lattice/docs/recipes/add-domain.md

How To Add a Domain

Add a business domain to an existing Sky Lattice customer project after the platform is already applied.

Prerequisites

• Customer project with intent.yaml
• platformctl installed

Steps

1. Open the customer project directory.

2. Run:

   platformctl add domain finance --access-profile restricted
   

3. If this breaks a default (e.g. early prod curated read), record a decision:

   platformctl decision add \
     --applies-to domains.finance \
     --rationale "Month-end needs prod curated read; revisit after SSO" \
     --expires 2026-10-01
   

4. Link an override in intent.yaml if needed (overrides with that decision_id).

5. Run platformctl validate then platformctl plan.

6. Review the plan summary and apply via platformctl apply or a PR.

Expected results

Plan shows new database/schemas/roles for the domain across configured environments.