Skip to content
workspace.json
Blog

Governance

workspace.json is an open specification. The spec is licensed under Apache 2.0, the reference implementations are Apache 2.0, and all artifacts are designed for donation to the Agentic AI Foundation (AAIF) when the project reaches the appropriate adoption milestones.

The canonical spec source now lives in the agents-audit monorepo: github.com/workspace-json/agents-audit/tree/main/packages/spec.

Origin

Section titled “Origin”

workspace.json was created and initially specified by the team at Vreko. Vreko is the reference implementation of the workspace.json specification — it generates workspace.json through daemon-based behavioral observation of codebases. Vreko is to workspace.json what cURL is to HTTP: the tool that proves the protocol works, built by the people who designed it.

The specification is maintained as an independent open standard under Apache 2.0. Vreko holds no exclusive rights to the specification. Any tool may implement workspace.json without permission, payment, or attribution.

workspace.json is proposed for donation to the Agentic AI Foundation (AAIF). Upon acceptance, AAIF will assume governance. Vreko will continue as a contributor and reference implementation.

Current Status

Section titled “Current Status”

Maintainership

Section titled “Maintainership”

We welcome additional maintainers from organizations that implement workspace.json. Maintainership is granted based on sustained contribution and demonstrated commitment to the spec’s neutrality. Contact: governance@workspacejson.dev

Contribution

Section titled “Contribution”

The spec is developed in public at github.com/workspace-json/agents-audit/tree/main/packages/spec. Substantive changes go through a public RFC process documented in the repo’s CONTRIBUTING.md.

We are explicitly looking for contribution from:

  • AI coding tool teams (Continue, Cline, Cursor, Aider, Zed, Copilot, etc.) who would consume workspace.json
  • Tool authors who would generate workspace.json from behavioral observation
  • Researchers studying AI coding agent context

Code of Conduct

Section titled “Code of Conduct”

The Contributor Covenant applies to all spec discussions and contributions. See CODE_OF_CONDUCT.md in any repo.