Overview
A workspace is not merely storage. Its folder structure, naming rules, instruction files, reusable skills, output locations, and secret boundaries determine how efficiently an agent can find information and how safely it can act. Clean organization reduces search, prevents root-folder pollution, and makes projects easier to move between agent harnesses.
A practical structure separates stable instructions and reusable procedures from active outputs, temporary files, secrets, and project-specific subfolders.