The portable repo spec for agentic coding. Capture rules, prompts, agents, and more—ship to any IDE, CLI, or hosted copilot.
.ai/
├── context.json # Base configuration
├── profiles/
│ ├── cursor.json # Cursor IDE settings
│ ├── windsurf.json # Windsurf overrides
│ └── claude.json # Claude-specific
├── rules/
│ ├── style.md # Code style guide
│ └── security.md # Security policies
├── agents/
│ └── code-reviewer.json
└── tools/
└── mcp-servers.jsonEverything you need to hand consistent project context to modern agents, built with AAA accessibility and security best practices.
One `.ai/` folder that every agent runtime can parse. Structured merge rules keep overrides predictable across tools.
Explicit deny → ask → allow permissions, secret bindings, and knowledge redaction baked into the spec from day one.
Lintable, diffable, testable. Designed for CI/CD pipelines while staying approachable for humans to author.
VERSA balances machine readability with human-friendly authoring. Markdown gets JSON front matter, JSON gets deeply merged.
Persistent project context delivered to every agent call.
Reusable templates with typed variables and inline tests.
Declarative presets describing goals, tools, context attachments.
Retention policies and durable notes – session, project, or none.
Ingestion config for docs, repos, URLs with redaction directives.
MCP servers and HTTP descriptors for reproducible capabilities.
Model routing, budgets, UI preferences, and profile overlays.
Policy enforcement with secret bindings and ask-before-run prompts.
Designed for DX: lintable, diffable, and easy to automate in CI while staying approachable for humans.
Capture durable guidance in Markdown with `ai:meta` preambles for scope, priority, and attach mode.
Run `versa lint` to check JSON Schemas and Markdown metadata across environments.
Start MCP servers, merge profile overlays, hand the same `.ai/` context to all tools.
Ship conformance scenarios, design updates, and spec proposals via issues.
All 8 repositories: specs, schemas, CLI tooling, examples, adapters, conformance suites, website, and community.
Reference CLI tool (versa init, lint, context) - v1.0.0 released.
Open repository10 validated example configurations for various project types.
Open repositoryTransform VERSA to native tool formats (Cursor, Windsurf) - v1.0.0.
Open repository70 black-box scenarios to certify VERSA-compatible runtimes.
Open repositoryLanding site and documentation built with Next.js 15 + Tailwind 4.
Open repositoryClone the examples, lint your .ai/ folder, and open a spec issue if you need new capabilities. We're building VERSA openly with the community.