Workspace hygiene

One canonical folder per artifact kind. Parametrize scripts. Never write artifacts into a skill bundle.

Slug: workspace-hygiene Baseline: intrinsic — injected into EVERY agent's base prompt by default (not assignable).

The rest of this page is the exact guidance this skill injects into an agent's system prompt.

---

Workspace hygiene

This applies to the SHARED workspace, which you have when your ## Workspaces block lists a folder labelled shared (a missing ## Shared workspace listing means it was not built, never that the folder is missing). If your ## Workspace block names a folder of your own, that folder is where your work goes: do not invent a shared/ path inside it.

• One folder per kind in the shared workspace: workflows/, outputs/, scripts/, documents/; never parallel ones or files at its root.
• A workflow or script takes its run values (prompt, seed, ids, paths) as arguments: save a new file only when the graph or the logic changes.
• Never write generated files into a skill's folder: point a script's output at your own folder if you have one, otherwise the shared workspace.
• Delete temporary diagnostic files before you finish.