# SpecVerse AI Development Guide

**📖 This guide has been superseded by the comprehensive guide.**

## Updated Documentation Location

For complete SpecVerse AI development guidance, please see:

The SpecVerse guides live with the toolchain on GitHub:
- **User guide**: [SPECVERSE-SPECIFYING.md](https://github.com/SpecVerse/specverse-self/blob/main/docs/guides/SPECVERSE-SPECIFYING.md)
- **Golden Rules**: [GOLDEN-RULES.md](https://github.com/SpecVerse/specverse-self/blob/main/docs/GOLDEN-RULES.md)
- **This project's AI guide**: see `CLAUDE.md` in the project root

The complete guide includes everything from this legacy guide plus:

## Enhanced Content

- **Complete structure reference** - Every schema element documented
- **Practical examples** - From simple blog to enterprise SaaS
- **Convention syntax patterns** - Full shorthand reference
- **AI development workflows** - Step-by-step AI operation guidance
- **Deployment patterns** - Real-world deployment configurations for all scales
- **Command reference** - All CLI commands in one place
- **Best practices** - Common pitfalls and recommendations
- **Type reference** - Complete primitive and format types
- **Manifest system** - Implementation guidance patterns

## Quick Reference for AI Assistants

### Key Principles
1. Use conventions: `attributeName: TypeName modifiers` for 90% of attributes
2. Component names: PascalCase (UserManagement, PaymentService)
3. Start minimal: Let AI inference expand to complete architecture
4. Scale appropriately: Personal ≠ Enterprise complexity

### Quick Syntax Reference

For working examples showing all essential SpecVerse syntax patterns, see the
example corpus on GitHub:
**[examples/00-reference/00-01-minimal-syntax-reference.specly](https://github.com/SpecVerse/specverse-self/blob/main/examples/00-reference/00-01-minimal-syntax-reference.specly)**

These examples demonstrate core concepts with practical, schema-valid specs.

### Essential Commands
```bash
# Validate specification
specverse validate specs/main.specly

# Generate complete architecture with AI inference
specverse infer specs/main.specly -o specs/complete.specly

# Generate all outputs
specverse gen all specs/main.specly
```

## Migration Note

The legacy AI-GUIDE.md has been archived to `archive/AI-GUIDE-legacy.md` for reference.

---
*For comprehensive guidance, see SPECVERSE-COMPLETE-GUIDE.md in your SpecVerse installation*