Skip to main content

Maintain the Boundary

The core Mapache habit is simple: isolate projects, verify inside the runner, and commit only the changes you understand.

Good Session Hygiene​

  • Stop sessions when active work is finished.
  • Relaunch sessions after image or auth changes.
  • Keep credentials scoped to the workspace that needs them.
  • Run verification commands before publishing changes.
  • Commit code through the connected repository workflow.

When to Create a New Workspace​

Create a new workspace when a project uses a different repository, runtime image, auth profile, or agent toolchain. The extra boundary is cheaper than debugging leaked configuration.

Next Reading​

Read the operations section for notes on maintaining this community site and keeping deployment paths predictable.