---
id: 21
title: "Migration: Convert single-project to workspace"
assignee: claude
tags: [cli, migration, projects]
created: 2026-02-10
---

## Description

Provide a smooth migration path for existing single-project setups to adopt the workspace model if desired.

### What to build

1. **Auto-wrap detection** — When server starts and finds a single-project dir (tasks/config.yaml at root), create an implicit workspace with one project. No file changes needed.
2. **Explicit migration command** — `mdboard migrate` moves existing `tasks/`, `prompts/`, `documents/` into a named project subdir and creates `.mdboard.yaml`.
3. **CLAUDE.md update** — Update the project's CLAUDE.md to document the workspace/project model.

### Example migration

```
# Before
./tasks/config.yaml
./tasks/backlog/
./prompts/
./documents/

# After `mdboard migrate --name my-project`
./.mdboard.yaml
./my-project/tasks/config.yaml
./my-project/tasks/backlog/
./my-project/prompts/
./my-project/documents/
```

## Acceptance Criteria
- [ ] Single-project dirs auto-wrapped as implicit workspace (no migration needed to keep working)
- [ ] `mdboard migrate --name NAME` restructures into workspace format
- [ ] Migration preserves all task files, prompts, documents, and git history
- [ ] CLAUDE.md updated with workspace/project documentation

## Notes
