# Claude Workspace Naming Contract

This repo is for **Claude Workspace** and **Claude Agent** work.

## Canonical product names

Use these names in all new UI, docs, skills, prompts, tests, review comments, and handoffs:

- **Claude Workspace**
- **Claude Agent**
- **Swarm**
- **Claude Kanban**
- **CLAUDE_HOME**
- `~/.claude`

## Forbidden new references

Do **not** introduce these in new work unless quoting legacy history or compatibility behavior:

- Claude Workspace
- Claude Agent
- Claude swarm
- Claude-native paths
- `CLAUDE_HOME`
- `~/.claude`

## Legacy compatibility rule

If older code, docs, tests, or handoffs contain Claude-era wording, treat it as legacy residue.

Default action:
- normalize it to Claude naming
- preserve old wording only when explicitly documenting migration or backwards compatibility

## Runtime/path rules

For Claude-native runtime work, prefer:

- `CLAUDE_HOME`
- `~/.claude/profiles/<workerId>`
- `claude`
- Claude worker sessions

Do not suggest Claude-specific runtime wrappers or profile paths for live Claude Workspace behavior.

## Swarm/UI language rules

Prefer:
- **Ready** not person-specific hardcoded labels
- **Board / Cards / List** for reports views
- **Claude Workspace** and **Claude Agent** in update/config/status UI

Avoid:
- person-specific product labels baked into UI
- Claude-branded wording in Claude Workspace surfaces

## Reviewer rule

Any PR or patch that introduces new Claude-branded naming into Claude Workspace should be treated as a regression unless it is:
- a legacy compatibility note
- a migration guide
- a quoted historical artifact

## Agent instruction rule

When an agent is working in this repo:
- assume Claude naming is canonical
- rewrite Claude-era references to Claude by default
- do not invent Claude-branded paths, products, or wrapper guidance
- if uncertain, prefer repo-native Claude terminology over historical aliases
