agents-bootstrap-layout

To bootstrap a clean Codex workspace layout, run $agents-init from the workspace root. This process generates baseline AGENTS.md templates and creates a centralized .agents/skills folder structure without overwriting existing files.

Setting up shared skills across a polyrepo project involves creating a workspace-level .agents/skills folder. The bootstrap process provides pointers or symlinks from the workspace root to share skills across multiple repositories consistently.

Bootstrapping a Codex workspace does not overwrite existing AGENTS.md files. The process respects existing configurations and workflows to prevent destructive changes, applying safely to empty workspaces, single repos, and multi-repo polyprojects.

You can use this workspace bootstrap for empty directories, existing single repos, and multi-repo polyprojects. It generates a root SKILL.md with required frontmatter and sets up .agents/skills subfolders for various project scales.

To update your Codex workspace configuration after the initial bootstrap, use the $agents-refresh command. This provides safe, non-destructive guidance to update your workspace and repository-level AGENTS.md files and shared skills structure.