# D Workspace Project

> Use when Codex needs to create, initialize, scaffold, or manage a new or existing project (project). Triggered when the user says anything about creating a new project, starting a new project, building a project, scaffolding, or when project files need to be organized. Ensures ALL project work follows the D:\Workspace conventions: D:\Workspace\_global-workbench\README.md (global workbench), D:\Workspace\_global-pitfall-log\README.md (pitfall log), and D:\Workspace\_project-sop\README.md (SOP). Also applies when resuming work on an existing D:\Workspace project, or when the user asks why project files are not going to D:\Workspace.

- Skill: `double-sheng/d-workspace-project` (Agent Skill)
- Install (CLI): `npx skillmds@latest add double-sheng/d-workspace-project`
- Raw SKILL.md: https://api.skillmd.com/api/skills/double-sheng/d-workspace-project/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: double-sheng (https://skillmd.com/u/double-sheng)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/double-sheng/d-workspace-project

---


# D: Workspace Project Convention

## Rules

### 1. ALWAYS use D:\Workspace for projects

**All project files MUST be placed in D:\Workspace.**
The current chat session directory (e.g. C:\Users\...\new-chat-XXX\) is for
chat-level work/ and outputs/ only -- never for actual project files.

Before any project work, read D:\Workspace\_global-workbench\README.md to
confirm the conventions.

### 2. Naming convention

Follow D:\Workspace\_project-sop\README.md strictly:
- Folder name: `project` + `3-digit-number` + `-` + `project-name`
- Example: `project002-my-awesome-app`
- Subdirs: `docs/ src/ tests/ work/ outputs/`
- Project root MUST have `README.md` and `AGENTS.md`

### 3. Start a new project: follow the SOP

1. Read D:\Workspace\_project-sop\README.md
2. Read D:\Workspace\_global-pitfall-log\README.md
3. Determine the next project number (max existing + 1)
4. Create the project folder under D:\Workspace with all subdirs
5. Write README.md and AGENTS.md
6. Initialize git

### 4. Pitfall log is the shared memory

- Read it before starting any project to avoid known issues.
- After solving a new problem, append the solution to the pitfall log so it
  persists across conversations.

### 5. Sandbox limitation

Codex cannot write directly to D:\Workspace from the sandbox.
Workflow:
1. Generate files in the writable work/ directory of the current chat session
2. Use `Copy-Item` with require\_escalated to move them to D:\Workspace
3. Or inform the user to manually cut/paste if escalation is unavailable

## Existing projects on D:\Workspace

- project001-silly-card
- \u5927\u5468\u5973\u5e1d\u5468\u82e5\u79bb (pre-convention, naming exempt)