Devops Setup Environment

Setting up a working environment end-to-end: a fresh checkout, a new worktree, after a long-lived branch switch, or whenever bearings shows multiple staleness warnings at once. Runs the individual devops skills in dependency order; for a single stale piece, use the specific skill instead.

Run the steps in order; each is idempotent.

1. Fetch and check out the latest main, detached — a stale branch (e.g. one still sitting on an already-merged/deleted feature branch) makes every later step operate on the wrong tree:

   git fetch origin main && git checkout --detach origin/main
   

2. Sync the vcpkg submodule to what main's tree expects — a stale vcpkg pin causes hard-to-diagnose build failures later:

   git submodule update --init vcpkg
   

3. Sync the doc indexes (doc-sync-index):

   ./projects/ores.compass/compass.sh index --org-roam-db-sync
   

4. Deploy the skills bundle (devops-deploy-skills):

   ./projects/ores.compass/compass.sh build --direct skills
   

5. Deploy Claude Code settings (devops-deploy-settings):

   ./projects/ores.compass/compass.sh build --direct settings
   

6. Initialise the environment — .env, certificates, IAM key. The -y flag answers the "reuse passwords?" prompt; without it, a non-interactive shell hits EOF and the command fails:

   ./projects/ores.compass/compass.sh env configure -y
   

7. Recreate the database (devops-recreate-db) — stop services first if they hold connections:

   ./projects/ores.compass/compass.sh db recreate -y -k
   

8. Build the project — required before services can start or the shell can provision anything; use compass build, never raw cmake invocations:

   ./projects/ores.compass/compass.sh build
   

9. Provision the Acme Corporation tenant via the shell — run the full Acme holding-group provisioning script from the generated library (the system's reference fully-populated test/demo entity):

   ./projects/ores.compass/compass.sh shell -f projects/ores.shell/scripts/library/provisioning/how_do_i_provision_the_system_with_acme_corporation_holding_group.ores
   

10. Verify — bearings clean. Do not start services as part of this skill; only run compass services start if the user explicitly asks for it:

    ./projects/ores.compass/compass.sh bearings
    

• How do I orient a new session? — the verification at the end.
• How do I index notes for compass? — step 3 in detail.
• How do I deploy the skills? — step 4 in detail.

• Skills catalogue§DevOps — the per-piece skills this composes.