workspace-setup

Establish, review, migrate, or repair the workspace operator layer for code projects.

2|Updated Apr 15, 2026
One-click install
npx skills add https://github.com/tommylower/cortex --skill workspace-setup-tommylower
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: workspace-setup
Source: https://github.com/tommylower/cortex/tree/main/agent-workflows/workspace-setup
Command: npx skills add https://github.com/tommylower/cortex --skill workspace-setup-tommylower

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Projects accumulate scattered planning files, status notes, and duplicated documentation with no clear owner, making it hard for humans and AI agents to know what is happening, what comes next, and where each kind of truth lives. ## Core Features & Use Cases - Workspace Structuring: Creates a workspace/ operator layer with a stable router (README.md) and a compact management view (PROJECT.md) per independently operated project. - Shape Selection: Chooses coordination, sharing (local, tracked, or mixed), and execution ownership axes based on the project's actual work lifecycle and privacy boundary. - Review and Migration: Audits existing control-room or planning material, classifies every artifact, and migrates files only after an approved move table. - Use Case: You inherit a repository with plans/, STATUS.md, and PROJECT.md scattered at the root. Use this Skill to review the project, propose a consolidated workspace/ layout, and migrate the material while keeping canonical truth in its original home. ## Quick Start Ask the agent to review this repository and propose a workspace structure that consolidates the existing planning and status documentation.

Frequently Asked Questions about workspace-setup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I organize project planning files for AI agents?▼

Create a `workspace/` directory at the project root containing a `README.md` operator router and a compact `PROJECT.md` management view. The router maps where each kind of truth lives, while PROJECT.md tracks purpose, current work, next steps, and open loops.

How to migrate scattered project documentation into one workspace?▼

First classify every existing artifact as stable documentation, workspace coordination, canonical truth, or disposable material. Then propose an exact move table, get approval, and migrate one project at a time while updating links and retiring old paths.

Should a monorepo have one workspace or one per repository?▼

Repository count does not determine workspace count. Create one workspace per independently operated project; a child repository earns its own workspace only when it has a separate work lifecycle, changing state, and operator boundary.

Should workspace files be tracked in git or kept local?▼

Choose based on the privacy boundary: tracked workspaces are reviewed with the code, local workspaces stay ignored or outside the repository, and mixed setups separate a tracked safe router from ignored local material. Never commit credentials or secret values.

When should I not create a workspace for a folder?▼

Do not create a workspace for packages, generated directories, dependency checkouts, category folders, or archives unless they have their own work lifecycle. Also stop if `workspace/` already has an unrelated build or package-manager meaning.