Skip to content

docs: add "host as source of truth" principle for multi-environment setups - #18

Merged
apajon merged 1 commit into
mainfrom
copilot/add-host-as-source-of-truth
Apr 10, 2026
Merged

apajon merged 1 commit into
mainfrom
copilot/add-host-as-source-of-truth

Conversation

Copilot AI commented Apr 10, 2026

Copy link
Copy Markdown
Contributor

Documents the mental model that the host owns the palace and containers are disposable execution environments — a gap that could lead users to accidentally create multiple diverging palaces across environments.

README.md

  • Added ## Host as source of truth section between "How it works" and "Shared memory across environments"
  • Updated Table of Contents
  • Core message: palace lives on host, container mounts it but does not own it, rebuilds are safe

docs/devcontainer_integration.md

  • Added ## Design principle: host as source of truth before the existing "Design rationale" section
  • Covers: containers are ephemeral, palace must outlive container lifecycle, consistency across local/devcontainer/multi-project workflows
  • Includes an explicit warning about silent divergence if the principle is not followed

@apajon
apajon marked this pull request as ready for review April 10, 2026 19:53
@apajon
apajon merged commit 6428cd5 into main Apr 10, 2026
1 check passed
@apajon
apajon deleted the copilot/add-host-as-source-of-truth branch April 10, 2026 19:54
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants