packages/teams-catalog/MIGRATION.md
This document records the migration state of the initial bundled and optional teams shipped in @paperclipai/teams-catalog. It exists so future contributors know what was intentionally deferred, what is safe to delete from legacy sources, and which compatibility tests must land before the legacy onboarding assets can be removed.
The approved plan for this package lives at PAP-10206 plan document.
| Source | Status |
|---|---|
server/src/onboarding-assets/ceo/ | Keep as-is. Drives current onboarding default agent creation. Will be removed only when onboarding switches to the teams-catalog service (post-Phase E/G). |
server/src/onboarding-assets/default/ | Keep as-is. Generic AGENTS.md fallback used outside the catalog path. |
skills/paperclip-create-agent/references/agents/coder.md | Migrated content into bundled/software-development/product-engineering/agents/senior-coder/AGENTS.md (collaboration/handoffs/safety sections collapsed for catalog brevity). Keep the template as a reference for ad-hoc hiring until onboarding switches. |
skills/paperclip-create-agent/references/agents/qa.md | Migrated content into both bundled/company-defaults/core-exec-team/agents/qa/AGENTS.md and bundled/software-development/product-engineering/agents/qa/AGENTS.md. Keep the template. |
skills/paperclip-create-agent/references/agents/uxdesigner.md | Migrated content into bundled/product/product-design/agents/ux-designer/AGENTS.md. Lens dictionary intentionally trimmed in the catalog copy — the template stays authoritative for ad-hoc hiring. |
skills/paperclip-create-agent/references/agents/securityengineer.md | Not migrated. No SecurityEngineer team ships in Phase H — see deferred entries below. |
paperclipai/bundled/company-defaults/core-exec-team — defaults: CEO, CTO, QA, starter project, recurring CEO heartbeat task. defaultInstall: true. This is the smallest team that mirrors the historical CEO onboarding flow while staying inside catalog rules.paperclipai/bundled/software-development/product-engineering — optional engineering pod: CTO, Senior Coder, QA, weekly engineering sync routine.paperclipai/bundled/product/product-design — single-designer product design team with wireframe, design-critique, and weekly design review routine.paperclipai/optional/content/content-machine — vendored local content-calendar skill, single content lead, recurring weekly content review. Kept from Phase B as the canonical fixture for local-skill resolution.The plan in PAP-10206 lists additional recommended entry classes that are not part of the Phase H catalog. They wait on:
optional/ops/cloud-operations — needs a CloudOpsEngineer role template under skills/paperclip-create-agent/references/agents/ first, plus an explicit security review of the deployment/secrets routines it implies. Defer until a follow-up curation pass.optional/research/benchmark-quality — needs a benchmark/evals/forensics role template and concrete starter routines from a real benchmark engagement. Defer until that engagement exists.optional/quality/security-review — could wrap the existing securityengineer.md template, but the plan's Phase D security review of external-source handling has to land before bundling a security-focused team with default skill imports. Defer until Phase D is complete.claude_local, codex_local, etc. at install time. Lock these only when onboarding adopts the catalog and needs a deterministic default.SOUL.md, HEARTBEAT.md, TOOLS.md siblings) — collapsed into a single AGENTS.md per agent for Phase H. Move to references/ files if the importer learns to surface them as agent reference attachments without changing trust level.shipped-catalog.test.ts enforces markdown_only / assets trust for every shipped team until Phase D security review covers script-bearing entries.Before removing server/src/onboarding-assets/ceo/ or the skills/paperclip-create-agent/references/agents/*.md templates, the following tests should be in place. None are written yet — they are tracked here so a future remove-legacy issue does not skip them:
paperclipai/bundled/company-defaults/core-exec-team install via the catalog service.ceo, cto, qa keep stable values when reparenting under an existing target manager, so downstream UI links don't churn.requiredSkills references a catalog skill key that no longer exists in the latest @paperclipai/skills-catalog manifest.adapterType pick up the same adapter the legacy onboarding path used.TASK.md entries (first-heartbeat, weekly-engineering-sync, weekly-design-review, weekly-content-review) must still be imported with timer heartbeats disabled, matching current portability behavior.pnpm --filter @paperclipai/teams-catalog validate and pnpm --filter @paperclipai/teams-catalog test both pass.server/src/onboarding-assets/ requires the compatibility tests above to land first and is gated by the onboarding-service switchover task tracked under the same parent goal.