Legacy Migration Guide
Use this guide when an existing collaboration project contains older task metadata.
What Changed In v0.4.0
- Skill path is
.claude/skills/cross-agent-coordination/. - Project config is
config/collab.yaml. - Task types are read from
config/task-types.yaml, then the Skill default registry. - New task README frontmatter uses
assignee;agentis only read as a legacy fallback. - Dashboard and Obsidian sync helpers were removed from this Skill.
The scripts intentionally do not read old github-monorepo-collab or config/monorepo.yaml paths.
Low-Risk Migration Order
- Copy old local configuration into
config/collab.yaml. - Add
config/task-types.yamlfor project-specific task categories. - Add
templates/tasks/default.mdand type-specific templates if needed. - Run
python3 scripts/audit_repo.py .. - Fix only the task README files that block current work.
- For new tasks, use
task_scaffold.pyso metadata is written in the v0.4.0 format.
Common Fixes
- Rename
agenttoassigneewhen touching an active task. - Add
dependencies: []andartifact_paths: []if missing. - Replace old script references with
task_scaffold.pyandaudit_repo.py. - Remove any workflow that invokes a removed dashboard generator.