Devops Setup Environment

Table of Contents

When to use this skill

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.

How to use this skill

Run the steps in order; each is idempotent.

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

    ./projects/ores.compass/compass.sh index --org-roam-db-sync
    
  2. Deploy the skills bundle (devops-deploy-skills):

    ./projects/ores.compass/compass.sh build --direct skills
    
  3. Deploy Claude Code settings (devops-deploy-settings):

    ./projects/ores.compass/compass.sh build --direct settings
    
  4. Initialise the environment — .env, certificates, IAM key:

    ./projects/ores.compass/compass.sh env init
    
  5. Recreate the database (devops-recreate-db) — stop services first if they hold connections:

    ./projects/ores.compass/compass.sh db recreate -y -k
    
  6. Optionally, provision via the shell — run a provisioning script from the generated library (e.g. a full Barclays/GLEIF system, or the lightweight bootstrap smoke):

    ./projects/ores.compass/compass.sh shell -f projects/ores.shell/scripts/library/barclays_system_provision.ores
    
  7. Verify — services up, bearings clean:

    ./projects/ores.compass/compass.sh services start && ./projects/ores.compass/compass.sh bearings
    

Recipes

Reference

Emacs 29.1 (Org mode 9.6.6)