Agent Quickstart

read_order:
  - agent
  - site
  - system
  - runbook
roots:
  - /home/loca/dev/blld.loca.zone
  - /home/loca/dev/blld.loca.zone-private
  - /home/loca/dev/wikis/blld/content
mode: "static brochure/preorder"
authoritative_sources:
  - public root (/home/loca/dev/blld.loca.zone)
  - private root (/home/loca/dev/blld.loca.zone-private)
  - wiki content root (/home/loca/dev/wikis/blld/content)
  - compose file (/home/loca/dev/blld.loca.zone-private/wp-docker/docker-compose.yml)
  - postprocess tool (/home/loca/dev/blld.loca.zone-private/tools/postprocess-static-mirror.mjs)
  - build.sh (/home/loca/dev/wikis/build.sh blld)
never_expose:
  - .env values
  - MariaDB contents
  - private-only files
before_change: "inspect the relevant source and the matching public route, then preserve static-only behavior"
verify:
  - bash /home/loca/dev/wikis/build.sh blld --check-only
  - stat -c %a:%n /home/loca/dev/blld.loca.zone-private/wp-docker/.env
  - ss -tlnp | grep 54321

Source-of-Truth Precedence

  • Public Experience: The live static root establishes the public experience.
  • Editable WordPress State: wp-docker plus wp-content and db_data establish editable WordPress state.
  • Static-Export Transformation: The postprocess tool establishes the static-export transformation.

If these disagree, the agent must stop and inspect the underlying files rather than guessing or overwriting a layer.

0 items under this folder.