Skip to content

Instantly share code, notes, and snippets.

@GanemoCorp
GanemoCorp / agent-workspace-as-code.md
Last active April 30, 2026 21:32
Agent Workspace as Code (AWaC) — a declarative pattern for composing AI agent workspaces from layered GitHub stacks. Solves drift and context bloat at team scale.

Agent Workspace as Code (AWaC)

A pattern for composing AI agent workspaces declaratively from versioned, layered sources — so the agent's operating context is reproducible, auditable, and free of drift.

TL;DR

If your team uses AI coding agents across multiple products and creates short-lived workspaces frequently, you eventually hit two problems at the same time:

  1. Drift. The transversal files that shape your agent's behavior — rules, skills, workflows — get edited inside individual workspaces. Soon you have eight slightly different versions of the same rule, and consolidating them is painful enough that nobody does it.
  2. Bloat. Every new workspace inherits everything, including capabilities that don't apply to the current product. The agent's context fills with irrelevant material, costing tokens and degrading focus.