🚀 VERSA 1.0 Specification Released!

[alpha912]

🚀 VERSA 1.0 Specification Released!

We're thrilled to announce the release of VERSA 1.0 - the first stable version of the Vendor-neutral Extensible Repo Spec for Agents!

🎉 What's in VERSA 1.0?

📦 8 Canonical Primitives

1. Rules - Persistent project context for every agent call
2. Prompts - Reusable templates with typed variables
3. Agents - Declarative presets with goals and tools
4. Memory - Retention policies (session, project, none)
5. Knowledge - Ingestion config with redaction directives
6. Tools - MCP servers and HTTP tool descriptors
7. Settings - Model routing, budgets, UI preferences
8. Permissions - Policy enforcement with secret bindings

🎯 Key Features

• Portable - One .ai/ folder works with every VERSA-compatible tool
• Security-First - Explicit deny → ask → allow permissions
• Simple - Plain JSON and Markdown, Git-friendly
• Extensible - Profile system for tool-specific overrides
• Validated - JSON Schema definitions for all primitives

📚 Resources

• 📖 Read the Full Specification
• 🌐 Website
• 🔧 CLI Tool
• 📚 Examples
• 📐 JSON Schemas
• 🔌 Adapters

🛠️ Quick Start

# Install the CLI
npm install -g @dotaislash/cli

# Initialize a new .ai/ folder
versa init

# Validate your configuration
versa lint

# Generate context for your agent
versa context

🤝 Get Involved

We need your help to make VERSA the standard for AI agent configuration!

• 🐛 Report bugs
• 💡 Share ideas
• 🔧 Build adapters for your favorite tools
• 📝 Contribute examples and documentation
• ⭐ Star the repositories

🙏 Thank You

Thank you to everyone who contributed feedback, ideas, and code during the development of VERSA 1.0. This is just the beginning!

Let's build the future of portable AI agent configuration together! 🚀

---

Questions? Ask in Q&A
Ideas? Share in Ideas
Built something? Show us in Show and Tell!