workspace.json is an Apache-2.0 descriptive codebase-intelligence
standard for AI-native development. Its canonical artifact is the committed,
daemon-free .agents/workspace.json file: useful to people and tools without
requiring a service to be running.
- The public publishing surface is workspacejson.dev. It publishes documentation and examples, but is not a second normative source.
- The standard describes a codebase; it does not prescribe approval gates, enforcement policy, or how a team must work.
- The project has no dependency on private Vreko source or
@marcelle-labs/*source.
| Repository | Responsibility |
|---|---|
| standard | Specification, schemas, rules, governance, reference reader, compatibility profiles, and conformance fixtures. |
| cli | Neutral producer, repository scanning, deterministic generation and reconciliation, artifact discovery, explicit execution, and CLI distribution. |
| integrations | MCP, Codex, VS Code, skills/plugins, and other host-specific consumers and adapters. |
The dependencies are intentionally one-way:
standard
↓
cli integrations
standard depends on none of the other repositories. cli and
integrations consume released standard contracts; integrations may invoke the
public CLI interface.
This organization is being established through a move-first, parity-first migration. Repository and publishing authority transfers are recorded only after the corresponding parity and cutover evidence exists. Registry evidence remains authoritative; package versions are not duplicated here.