# Adopt an existing workspace

Survey first, resolve only real ambiguity, and bring Megamono into a repository without erasing its history.

## See what is already there

The survey inventories Nx projects, project types, platforms, documentation, toolchains, workflows, and generated surfaces without changing the repository.

```sh
megamono init --survey
```

## Choose how projects fit together

If Megamono cannot identify a project or document, review its question and supply the requested mapping. This lets you keep the structure and ownership your team already understands.

## Start small and review the changes

Choose the modules you need, preview the changes, and keep existing workflows that already work for your team. Run your tests and builds before committing the adoption.

megamono.json records exactly what the repository adopted

```text
"adoption": {
  "modules": [
    "docs", "agents", "ci",
    "lint", "skills", "health", "inference"
  ],
  "reductions": [],
  "ratchets": []
}
```