---
name: Workspace Conventions
slug: workspace-conventions
category: Automation
description: Workspace Conventions defines where each agent can write files and how to name outputs in shared workspaces. Use it when organizing reports, web pages, and cross-agent references.
github: "https://github.com/chekusu/wanman/tree/main/packages/core/skills/workspace-conventions"
language: TypeScript
stars: 679
forks: 106
install: "npx degit https://github.com/chekusu/wanman/tree/main/packages/core/skills/workspace-conventions ~/.claude/skills/workspace-conventions"
installs_to: ~/.claude/skills/workspace-conventions
source_path: packages/core/skills/workspace-conventions/SKILL.md
collection_size: 6
category_size: 1523
collection_url: "https://dirskills.com/collections/chekusu/wanman"
added: 2026-08-24T05:16:35.062Z
last_synced: 2026-08-24T05:16:35.062Z
canonical_url: "https://dirskills.com/skills/workspace-conventions"
---

# Workspace Conventions

Workspace Conventions defines where each agent can write files and how to name outputs in shared workspaces. Use it when organizing reports, web pages, and cross-agent references.

**Install:**

```bash
npx degit https://github.com/chekusu/wanman/tree/main/packages/core/skills/workspace-conventions ~/.claude/skills/workspace-conventions
```

## README

# Workspace Conventions

## Directory Structure

Each agent's working directory is `/workspace/agents/{agent-name}/`.

**Rule: Only write files within your own working directory.**

```
/workspace/agents/
├── ceo/           ← CEO's working directory
├── marketing/     ← Marketing agent
├── finance/       ← Finance agent
├── feedback/      ← Feedback/research agent
├── dev/           ← Dev agent
└── devops/        ← DevOps agent
```

## Output File Naming

| Type | Naming | Example |
|------|--------|---------|
| Report | `{topic}-report.md` | `budget-report.md` |
| Brand guide | `brand-guide.md` | |
| Content plan | `{platform}-plan.md` | `social-media-plan.md` |
| Web page | `index.html` | |
| Design | `{name}-brief.md` | `poster-brief.md` |

## Cross-Agent References

When a task description references another agent's output, use the full path:

```
See brand guide at /workspace/agents/marketing/brand-guide.md
```

## Agent Name Identifier

When using `wanman artifact put`, the system automatically records the agent name. Ensure the environment variable `WANMAN_AGENT_NAME` is correctly set.

## Task Completion Checklist

1. Write key data to artifacts (`wanman artifact put`)
2. Write detailed reports to MD files
3. Mark the task as done with `wanman task done`, noting the number of artifacts in the result