# Workspace Migration

> Use when migrating an existing repository or workspace into OpenArc conventions, aligning docs, specs, plans, assets, agent guides, versions, and release workflow without destructive rewrites.

- **Type:** Skill
- **Install:** `agentstack add skill-yipxiyi-openarc-workspace-migration`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [Yipxiyi](https://agentstack.voostack.com/s/yipxiyi)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [Yipxiyi](https://github.com/Yipxiyi)
- **Source:** https://github.com/Yipxiyi/OpenArc/tree/main/skills/workspace-migration
- **Website:** https://github.com/Yipxiyi/OpenArc

## Install

```sh
agentstack add skill-yipxiyi-openarc-workspace-migration
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Workspace Migration

Use this skill when a user wants an existing workspace adjusted to OpenArc conventions.

## Goal

Move an existing repository toward OpenArc structure while preserving working project intent and minimizing churn.

## Migration Workflow

1. Inventory the workspace:
   - agent guides
   - README and docs
   - code style docs, formatter config, lint config, tests, and naming conventions
   - repo profile and profile-relevant PRD/design/brand materials
   - specs, plans, tasks
   - assets
   - changelog and releases
   - CI and GitHub workflows
2. Map existing files to OpenArc targets.
3. Identify missing code style preferences that cannot be inferred from existing config or code.
4. For UI, frontend, desktop, mobile, or component profiles, identify missing design preferences that cannot be inferred from existing design docs, components, CSS, or assets.
5. Classify actions:
   - keep as-is
   - patch in place
   - move or rename
   - create missing
   - archive duplicate
6. Produce a migration plan before editing.
7. Ask for confirmation before moving or renaming files.
8. Apply small patches first.
9. Validate links, docs, JSON/YAML, tests, and release workflow as applicable.
10. Report all created, modified, moved, and skipped files.

If `scripts/openarc.py` is available, start with:

```bash
python3 plugins/openarc/scripts/openarc.py scan .
```

Use the scan to seed the migration plan, not to auto-move files.

## Profile-Aware Target Structure

```txt
AGENT.md or AGENTS.md
README.md
docs/
  PROJECT_BRIEF.md
  CODE_STYLE.md
  TASKS.md
  CHANGELOG_AI.md
  specs/
  plans/
  tasks/
  archive/
  PRD.md        # app/product profile when needed
  DESIGN.md     # UI/frontend/desktop/mobile profile when needed
  BRAND.md      # public brand or identity profile when needed
  assets/       # UI, brand, screenshots, or visual references when needed
    brand/
    icons/
    illustrations/
    screenshots/
    references/
```

## Rules

- Existing files win over templates.
- Preserve inferred code style in `docs/CODE_STYLE.md`; ask only for preferences the repo cannot reveal.
- Repo profile controls target scope; script, CLI, automation, library, and docs-only repositories do not need design or brand scaffolding by default.
- Do not flatten useful project-specific organization.
- Do not move files only for aesthetics.
- Do not delete legacy docs unless the user explicitly confirms deletion.
- Prefer aliases, index links, or patching when moving would break references.
- Use `templates/MIGRATION.template.md` for persistent migration plans.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [Yipxiyi](https://github.com/Yipxiyi)
- **Source:** [Yipxiyi/OpenArc](https://github.com/Yipxiyi/OpenArc)
- **License:** MIT
- **Homepage:** https://github.com/Yipxiyi/OpenArc

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-yipxiyi-openarc-workspace-migration
- Seller: https://agentstack.voostack.com/s/yipxiyi
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.