AI-Assisted Development

​

Overview

​

How It Works

• Project structure and conventions
• Database patterns (SQLAlchemy 2.x)
• Frontend patterns (Vue 3 + Vuetify 3 without build tools)
• Authentication system (Flask-Security)
• CLI commands available
• How to create new features

​

Using Claude Code

# Claude Code understands Enferno out of the box
claude

# Example prompts:
> "Add a new Post model with title and content"
> "Create an API endpoint to list all users"
> "Add a new page to the dashboard"

​

Using Cursor

• “Create a data table for products following our patterns”
• “Add OAuth login with Microsoft”
• “Generate a RESTful endpoint for orders”

​

What AGENTS.md Contains

​

Development Commands

./setup.sh                    # Setup environment
uv run flask create-db        # Initialize database
uv run flask install          # Create admin user
uv run flask run              # Start server

​

Architecture Overview

• Flask factory pattern in enferno/app.py
• Blueprint organization (public, portal, user)
• Extension initialization in extensions.py

​

Code Patterns

# Query pattern (SQLAlchemy 2.x)
query = db.select(User)
pagination = db.paginate(query, page=page, per_page=per_page)

# Response pattern
return {
    "items": [item.to_dict() for item in pagination.items],
    "total": pagination.total
}

​

Frontend Patterns

• Vue 3 with custom ${} delimiters (avoids Jinja conflicts)
• Vuetify 3 components
• Per-page Vue instances

​

Customizing for Your Project

## Custom Patterns

### Order Processing
Orders follow this flow:
1. Create order via POST /api/orders
2. Process payment via Stripe
3. Update status to 'paid'

​

Benefits

1. Instant Context — AI understands your codebase immediately
2. Consistent Code — Generated code follows your patterns
3. Faster Development — Less time explaining, more time building
4. Team Knowledge — Document patterns once, AI applies everywhere