WeaveKit Docs
Guides

Project types

The three starting presets — agent, governance, service — and what each one scaffolds.

A project type is just a starting preset. It picks a narrative and two defaults:

  • the initial field-type whitelist (features.fieldTypes),
  • whether the script sandbox is on (subsystems.script).

That's it. It never trims core: every type gets the same engine, REST, MCP and RBAC. You can weave module:add later (audit, script, workflow) or edit weavekit.config.ts by hand. The type is written to projectType in config, mostly so the scaffolder and tooling know the intent.

TypeForScriptField types
agentAI-agent backendoffprimitives only
governanceauditable, permission-scoped objectsoffprimitives + opt-in
serviceheadless backend with RBAConprimitives + opt-in

Pick one with create-weavekit-app my-app --type=agent (default is agent).

  • agent — objects + REST for agents
  • governance — audit and row/field scoping
  • service — RBAC plus script hooks