Workspace ConventionsSAFE

wanman is an open-source agent matrix runtime inspired by Japanese one-man trains. It lets human users step back into an observer role while local agent runtimes coordinate autonomous multi-agent workflows, task execution, and artifacts.

The instruction file, verbatim from the audited commit — this is the text the model reads, and the surface the audit's instruction layer examines. Quoted here so you can judge it without cloning anything.

---
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

SAFEgrade B · trust 89/100 Nothing in the source contradicts what it says it does. Grade A is reserved for packages that have also passed the behavioural sandbox.

What the source does

Filesystem

none-observed

Network

none-observed

Shell

none-observed

Dependencies

pinned

Secrets in source

none-found

Findings (0)

No findings outside the package's declared scope.

Gates applied: no_behavioural_pass.