workspace-conventions

name	workspace-conventions
description	File and output conventions for agent workspaces

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