Workspai.dev

Create and Adopt

How projects enter Workspace Intelligence through native, official, or existing project paths.

Workspace Intelligence is not limited to frameworks Workspai can scaffold. The project-entry capability contract states the rule in plain language:

Any readable project can enter Workspace Intelligence through adopt/import.

There are two separate capabilities:

CapabilityMeaning
Workspace IntelligenceModel, context, impact, doctor, verify, graph, evidence, and agent grounding around a project
Native CreateWorkspai-owned project generation for supported kits

Existing projects can enter through adopt/import even when Workspai does not own their scaffold path. Registration still depends on a readable project path and enough observable metadata to create valid workspace records. Only specific kits can be created natively.

The runtime signals in the create planner are examples for detection, not a closed allowlist. Existing projects in other languages or frameworks can still enter Workspace Intelligence through adopt/import when they are readable and can be registered.

Create planner lanes

LaneUse whenResult
nativeWorkspai owns the scaffold contractFirst-class generated project
officialOfficial ecosystem generator existsRun an available official generator and register it, or use adopt/import for planned handoffs
existingThe project already exists or native create is not supportedRegister, model, verify, and govern without scaffolding

official contains both shipped and planned entries. Frontend generators such as Next.js and Vite are available official paths: Workspai runs the ecosystem generator, then registers the project in Workspace Intelligence. WordPress, Laravel, Symfony, and Rails are planned official handoffs and should not be presented as shipped automated workflows yet.

Native create kits

Current native create coverage includes:

  • fastapi.standard
  • fastapi.ddd
  • nestjs.standard
  • springboot.standard
  • gofiber.standard
  • gogin.standard
  • dotnet.webapi.clean

Available official generator paths

Current official generator coverage includes:

  • frontend.nextjs
  • frontend.remix
  • frontend.vite-react
  • frontend.vite-vue
  • frontend.vite-svelte
  • frontend.vite-solid
  • frontend.vite-vanilla
  • frontend.nuxt
  • frontend.angular
  • frontend.astro
  • frontend.sveltekit

Planned official handoffs include:

  • wordpress-site
  • wordpress-block
  • laravel
  • symfony
  • rails

Adopt/import examples

npx workspai adopt /path/to/project --json
npx workspai import ../existing-service
npx workspai workspace model --json --write

Use adopt/import for existing repositories, unsupported scaffold paths, or systems that should enter Workspace Intelligence without being moved.

Do not read the create planner's existing runtime signals as the only supported adopt/import technologies. They are planner hints; the architecture boundary is the readable project and its observable workspace evidence.

Claim boundary

It is correct to say:

Existing projects can enter Workspace Intelligence through adopt/import.

It is not correct to say:

Workspai natively scaffolds every language and framework.

The first claim is architecture. The second claim would exceed the create planner contract.

On this page