HomeGitHub
Docs/Commands/Adopt

Adopt

Survey a working codebase and create Blueprint plans that acknowledge shipped behavior.

Commandscommandadoptbrownfield

When to use it

Use $adopt or /adopt after installing Blueprint into a repository with meaningful existing code. Use onboard instead for a fresh or early scaffold.

What it does

Adoption surveys the stack, routes, data model, features, tests, commands, and conventions. It then asks focused questions about users, business intent, future direction, and ambiguous code.

Outputs

  • A project plan that combines observable behavior with your stated intent
  • A build plan with existing features checked and future work unchecked
  • Coding standards that reflect the repository instead of template defaults

Review gate

The generated plans are proposals. Check feature names, shipped status, boundaries, and future order before generating the overview.

What it never does

Adoption does not rewrite the application, delete obsolete-looking code, or merge changes. Its job is to describe the real starting point.

Documentation

Search AI Blueprint

Start typing to search the documentation.