v1.0.0 Released - October 17, 2025
✅ 10/10 Examples Validated
Production-ready examples of .ai/ folder configurations for various project types. Clone, adapt, and use in your own repositories.
Every example is:
- ✅ Validated against VERSA schemas
- 📝 Documented with inline comments
- 🧪 Tested with real AI tools
- 🎨 Practical based on real-world projects
# Clone the examples
git clone https://github.com/dotAIslash/dotaislash-examples.git
# Copy an example to your project
cp -r dotaislash-examples/typescript-project/.ai your-project/
# Or use the CLI
versa initThe absolute basics. Perfect for learning VERSA.
.ai/
├── context.json # Just the essentials
└── rules/
└── style.md # One simple rule
View context.json
{
"version": "1.0",
"rules": ["rules/style.md"],
"settings": {
"model": "claude-sonnet-4"
}
}A good starting point for most projects.
.ai/
├── context.json
├── profiles/
│ └── cursor.json
├── rules/
│ ├── style.md
│ └── security.md
└── agents/
└── code-reviewer.json
Full-featured TypeScript setup with linting, testing, and documentation agents.
Highlights:
- TypeScript-specific rules
- ESLint + Prettier integration
- Multiple agents (reviewer, documenter, tester)
- Cursor + Windsurf profiles
Python project with pytest, black, and mypy configuration.
Highlights:
- Python style guidelines (PEP 8)
- Type checking rules
- Testing best practices
- Virtual environment awareness
Next.js 15 application with React best practices.
Highlights:
- Server/client component rules
- Tailwind CSS guidelines
- API route conventions
- Performance optimization tips
Multi-package repository with shared and package-specific configs.
.ai/
├── context.json # Global config
├── packages/
│ ├── frontend/
│ │ └── .ai/ # Package-specific
│ │ └── context.json
│ └── backend/
│ └── .ai/
│ └── context.json
└── tools/
└── shared-mcp.json
Highlights:
- Configuration inheritance
- Workspace-level rules
- Package-specific overrides
- Shared tooling
Distributed system with service-specific configurations.
Highlights:
- Service boundaries
- API contract enforcement
- Shared standards
- Service-specific agents
OSS project with contributor guidelines and issue templates.
Highlights:
- Contributing rules
- Code of conduct enforcement
- Issue/PR templates
- Documentation requirements
Data science project with Jupyter, pandas, and ML best practices.
Highlights:
- Notebook guidelines
- Data validation rules
- Model documentation
- Reproducibility checks
REST API with OpenAPI spec and security guidelines.
Highlights:
- API design patterns
- Security checklists
- Error handling standards
- Documentation requirements
React Native application with platform-specific rules.
Highlights:
- iOS/Android conventions
- Performance guidelines
- Accessibility rules
- Native module patterns
Enterprise-grade setup with compliance and security.
Highlights:
- SOC 2 compliance rules
- Security scanning
- Audit logging
- Access control policies
Each example includes:
example-name/
├── README.md # Example overview
├── .ai/
│ ├── context.json # Base configuration
│ ├── profiles/ # Tool-specific configs
│ │ ├── cursor.json
│ │ ├── windsurf.json
│ │ └── claude.json
│ ├── rules/ # Guidelines
│ │ ├── style.md
│ │ ├── security.md
│ │ └── architecture.md
│ ├── agents/ # Agent definitions
│ │ ├── code-reviewer.json
│ │ ├── documenter.json
│ │ └── tester.json
│ └── tools/ # MCP servers
│ └── project-tools.json
└── sample-project/ # Example project files
└── (actual code)
Pick the example closest to your project type.
cp -r dotaislash-examples/typescript-project/.ai your-project/Edit files to match your needs:
// .ai/context.json
{
"version": "1.0",
"rules": [
"rules/style.md", // Keep
"rules/security.md", // Keep
"rules/your-custom.md" // Add your own
]
}cd your-project
versa lintAll examples are automatically tested:
# Run validation tests
pnpm test
# Test specific example
pnpm test typescript-project
# Generate test report
pnpm test:report| Example | Language | Framework | Complexity | Best For |
|---|---|---|---|---|
| minimal | Any | None | 🟢 Simple | Learning |
| quick-start | Any | None | 🟢 Simple | Most projects |
| typescript-project | TypeScript | Any | 🟡 Medium | TS apps |
| python-project | Python | Any | 🟡 Medium | Python apps |
| nextjs-app | TypeScript | Next.js | 🟡 Medium | Web apps |
| monorepo | Multi | Multi | 🔴 Complex | Large projects |
| microservices | Multi | Multi | 🔴 Complex | Distributed |
| enterprise | Any | Any | 🔴 Complex | Compliance |
- Start with minimal
- Explore quick-start
- Try typescript-project or python-project
- Study nextjs-app for framework integration
- Learn open-source best practices
- Explore api-server patterns
- Master monorepo configuration
- Understand microservices architecture
- Implement enterprise compliance
Help expand our examples!
- 📝 Add Examples - Share your
.ai/configs - 🐛 Report Issues - Found a problem? Let us know
- 💡 Suggest Use Cases - What examples are missing?
- 🧪 Improve Tests - Better validation
- 📚 Write Guides - Help others learn
# 1. Fork the repository
git clone https://github.com/your-username/dotaislash-examples.git
# 2. Create new example
mkdir my-example
cd my-example
# 3. Add .ai/ folder and README
# 4. Test it
versa lint
# 5. Submit PR
git add .
git commit -m "feat: add my-example configuration"
git push origin mainSee CONTRIBUTING.md for guidelines.
MIT © dotAIslash
All examples are free to use and modify.
- 📖 VERSA Spec - Read the specification
- 🔧 CLI Tool - Command-line interface
- 📐 Schemas - JSON Schema definitions
- 🔌 Adapters - Tool integrations
Real examples from real projects