ai-flow-dev 1.0.1

package/templates/backend/.clauderules.template

@@ -0,0 +1,111 @@
+# Claude Code Configuration for {{PROJECT_NAME}}
+
+## 📋 Quick Start
+
+**IMPORTANT:** Read `AGENT.md` first for complete project context.
+
+This file contains Claude Code-specific preferences and workflows.
+
+---
+
+## 🎯 Project Summary
+
+**Name:** {{PROJECT_NAME}}
+
+**Description:** {{PROJECT_DESCRIPTION}}
+
+**Stack:** {{FRAMEWORK}} + {{LANGUAGE}} + {{DATABASE}}
+
+---
+
+## 📚 Documentation Architecture
+
+**Always reference these files in order:**
+
+1. `AGENT.md` - Universal AI configuration (READ FIRST)
+2. `ai-instructions.md` - Tech stack, rules, workflow
+3. `project-brief.md` - Business context
+4. `README.md` - Developer onboarding & commands
+5. `docs/architecture.md` - System architecture
+6. `docs/data-model.md` - Database design
+7. `docs/code-standards.md` - Code quality standards
+8. `docs/testing.md` - Testing strategy
+9. `docs/operations.md` - Deployment & operational procedures
+10. `docs/business-flows.md` - Business process flows and diagrams
+11. `docs/api.md` - API reference and conventions
+12. `docs/contributing.md` - Contribution workflow
+13. `specs/security.md` - Security policies
+14. `specs/configuration.md` - Environment config
+
+---
+
+## ❌ CRITICAL RULES - NEVER
+
+{{NEVER_RULES_SUMMARY}}
+
+---
+
+## ✅ CRITICAL RULES - ALWAYS
+
+{{ALWAYS_RULES_SUMMARY}}
+
+---
+
+## 🏗️ Architecture Pattern
+
+**Pattern:** {{ARCHITECTURE_PATTERN}}
+
+**File Organization:** {{FILE_ORGANIZATION}}
+
+---
+
+## 🧪 Testing Requirements
+
+- Minimum {{MIN_COVERAGE}}% coverage
+- Write tests for all new features
+- Run tests before committing: `{{TEST_COMMAND}}`
+
+---
+
+## 📝 Commit Format
+
+{{COMMIT_FORMAT_EXAMPLE}}
+
+---
+
+## 🚀 Claude Code Workflow
+
+### Plan Mode
+1. Always use plan mode for complex features
+2. Break down into small, testable chunks
+3. Get user approval before implementation
+
+### Implementation
+1. Follow architecture patterns strictly
+2. Write tests alongside code
+3. Update documentation if behavior changes
+
+---
+
+## 🔒 Security Checklist
+
+- [ ] Input validation with {{VALIDATION_LIBRARY}}
+- [ ] Authentication/authorization checked
+- [ ] No hardcoded secrets
+- [ ] No sensitive data in logs
+- [ ] Rate limiting for public endpoints
+
+---
+
+## 💡 Claude-Specific Tips
+
+- Use `/bootstrap` command for starting documentation generation
+- Use plan mode for architectural decisions
+- Reference `AGENT.md` for any clarifications
+- Ask user before making breaking changes
+
+---
+
+**For full context, always read `AGENT.md` and `ai-instructions.md` before starting work.**
+
+**Generated by:** AI Flow v1.0.0

package/templates/backend/.cursorrules.template

@@ -0,0 +1,102 @@
+# Cursor Configuration for {{PROJECT_NAME}}
+
+## 📋 Quick Start
+
+**IMPORTANT:** Read `AGENT.md` first for complete project context.
+
+This file contains Cursor-specific preferences and workflows.
+
+---
+
+## 🎯 Project Summary
+
+**Name:** {{PROJECT_NAME}}
+**Description:** {{PROJECT_DESCRIPTION}}
+**Stack:** {{FRAMEWORK}} + {{LANGUAGE}} + {{DATABASE}}
+
+---
+
+## 📚 Documentation
+
+Read these files in order:
+
+1. `AGENT.md` - Universal AI configuration (⭐ START HERE)
+2. `ai-instructions.md` - Tech stack, rules, workflow
+3. `project-brief.md` - Business context
+4. `README.md` - Developer onboarding & commands
+5. `docs/architecture.md` - System architecture
+6. `docs/data-model.md` - Database design
+7. `docs/code-standards.md` - Code quality standards
+8. `docs/testing.md` - Testing strategy and coverage rules
+9. `docs/operations.md` - Deployment & operational procedures
+10. `docs/business-flows.md` - Business process flows and diagrams
+11. `docs/api.md` - API reference and conventions
+12. `docs/contributing.md` - Contribution workflow
+13. `specs/security.md` - Security policies
+14. `specs/configuration.md` - Environment configuration
+
+---
+
+## ❌ NEVER
+
+{{NEVER_RULES_SUMMARY}}
+
+---
+
+## ✅ ALWAYS
+
+{{ALWAYS_RULES_SUMMARY}}
+
+---
+
+## 🏗️ Architecture
+
+**Pattern:** {{ARCHITECTURE_PATTERN}}
+**Organization:** {{FILE_ORGANIZATION}}
+
+---
+
+## 🎨 Code Style
+
+- Indentation: {{INDENTATION}}
+- Quotes: {{QUOTE_STYLE}}
+- Formatter: {{FORMATTER}}
+- Linter: {{LINTER}}
+
+---
+
+## 🧪 Testing
+
+- Coverage: {{MIN_COVERAGE}}%+ required
+- Framework: {{TEST_FRAMEWORK}}
+- Command: `{{TEST_COMMAND}}`
+
+---
+
+## 📝 Commits
+
+{{COMMIT_FORMAT_EXAMPLE}}
+
+---
+
+## 🔒 Security
+
+- Validate all inputs: {{VALIDATION_LIBRARY}}
+- Auth method: {{AUTH_METHOD}}
+- Never hardcode secrets
+- Use environment variables
+
+---
+
+## 💡 Cursor Tips
+
+- Use `@AGENT.md` to reference project context
+- Use `@ai-instructions.md` for coding rules
+- Run `/bootstrap` to start documentation generation
+- Check `docs/` folder for detailed specifications
+
+---
+
+**Always reference `AGENT.md` for complete project understanding.**
+
+**Generated by:** AI Flow v1.0.0

package/templates/backend/.env.example.template

@@ -0,0 +1,122 @@
+# Environment Configuration for {{PROJECT_NAME}}
+# Copy this file to .env and fill in your values
+
+# =============================================================================
+# APPLICATION
+# =============================================================================
+NODE_ENV={{ENV_TYPE}}
+PORT={{DEFAULT_PORT}}
+APP_URL={{APP_URL}}
+
+{{#IF LOG_LEVEL}}
+# Logging
+LOG_LEVEL={{LOG_LEVEL_DEFAULT}}
+{{/IF}}
+
+# =============================================================================
+# DATABASE
+# =============================================================================
+{{#IF POSTGRESQL}}
+DATABASE_URL=postgresql://{{DB_USER}}:{{DB_PASSWORD}}@{{DB_HOST}}:{{DB_PORT}}/{{DB_NAME}}
+{{/IF}}
+{{#IF MYSQL}}
+DATABASE_URL=mysql://{{DB_USER}}:{{DB_PASSWORD}}@{{DB_HOST}}:{{DB_PORT}}/{{DB_NAME}}
+{{/IF}}
+{{#IF MONGODB}}
+DATABASE_URL=mongodb://{{DB_USER}}:{{DB_PASSWORD}}@{{DB_HOST}}:{{DB_PORT}}/{{DB_NAME}}
+{{/IF}}
+
+DATABASE_POOL_MIN={{DB_POOL_MIN}}
+DATABASE_POOL_MAX={{DB_POOL_MAX}}
+
+# =============================================================================
+# AUTHENTICATION
+# =============================================================================
+{{#IF JWT}}
+JWT_SECRET=your-secret-key-here-change-in-production
+JWT_EXPIRATION={{JWT_EXPIRATION}}
+REFRESH_TOKEN_SECRET=your-refresh-secret-here-change-in-production
+REFRESH_TOKEN_EXPIRATION={{REFRESH_TOKEN_EXPIRATION}}
+{{/IF}}
+
+{{#IF OAUTH}}
+{{#EACH OAUTH_PROVIDER}}
+{{PROVIDER_NAME_UPPER}}_CLIENT_ID=your-client-id
+{{PROVIDER_NAME_UPPER}}_CLIENT_SECRET=your-client-secret
+{{PROVIDER_NAME_UPPER}}_CALLBACK_URL={{CALLBACK_URL}}
+{{/EACH}}
+{{/IF}}
+
+# =============================================================================
+# REDIS / CACHE
+# =============================================================================
+{{#IF REDIS}}
+REDIS_URL=redis://localhost:6379
+REDIS_TTL={{REDIS_DEFAULT_TTL}}
+{{/IF}}
+
+# =============================================================================
+# EXTERNAL SERVICES
+# =============================================================================
+
+{{#EACH EXTERNAL_SERVICE}}
+# {{SERVICE_NAME}}
+{{SERVICE_ENV_VARS_EXAMPLE}}
+
+{{/EACH}}
+
+# =============================================================================
+# EMAIL
+# =============================================================================
+{{#IF EMAIL_SERVICE}}
+EMAIL_HOST={{EMAIL_HOST}}
+EMAIL_PORT={{EMAIL_PORT}}
+EMAIL_USER=your-email@example.com
+EMAIL_PASSWORD=your-email-password
+EMAIL_FROM={{EMAIL_FROM}}
+{{/IF}}
+
+# =============================================================================
+# FILE STORAGE
+# =============================================================================
+{{#IF S3}}
+AWS_ACCESS_KEY_ID=your-access-key
+AWS_SECRET_ACCESS_KEY=your-secret-key
+AWS_REGION={{AWS_REGION}}
+AWS_S3_BUCKET={{S3_BUCKET}}
+{{/IF}}
+
+{{#IF AZURE_BLOB}}
+AZURE_STORAGE_ACCOUNT=your-account
+AZURE_STORAGE_ACCESS_KEY=your-key
+AZURE_STORAGE_CONTAINER={{CONTAINER_NAME}}
+{{/IF}}
+
+# =============================================================================
+# SECURITY
+# =============================================================================
+CORS_ORIGIN={{CORS_ORIGIN_DEFAULT}}
+RATE_LIMIT_WINDOW_MS={{RATE_LIMIT_WINDOW}}
+RATE_LIMIT_MAX_REQUESTS={{RATE_LIMIT_MAX}}
+
+{{#IF ENCRYPTION}}
+ENCRYPTION_KEY=your-32-character-encryption-key-here
+{{/IF}}
+
+# =============================================================================
+# MONITORING
+# =============================================================================
+{{#IF SENTRY}}
+SENTRY_DSN=your-sentry-dsn
+{{/IF}}
+
+{{#IF DATADOG}}
+DATADOG_API_KEY=your-datadog-api-key
+{{/IF}}
+
+# =============================================================================
+# FEATURE FLAGS
+# =============================================================================
+{{#EACH FEATURE_FLAG}}
+{{FLAG_NAME}}={{FLAG_DEFAULT}}
+{{/EACH}}

package/templates/backend/README.template.md

@@ -0,0 +1,200 @@
+# {{PROJECT_NAME}}
+
+> {{PROJECT_DESCRIPTION}}
+
+---
+
+## 📋 Overview
+
+{{PROBLEM_STATEMENT}}
+
+**Target Users:** {{TARGET_USERS_SUMMARY}}
+
+---
+
+## ✨ Features
+
+{{#EACH FEATURE}}
+
+- **{{FEATURE_NAME}}**: {{FEATURE_DESCRIPTION}}
+  {{/EACH}}
+
+---
+
+## 🏗️ Tech Stack
+
+- **Framework:** {{FRAMEWORK}} {{FRAMEWORK_VERSION}}
+- **Language:** {{LANGUAGE}} {{LANGUAGE_VERSION}}
+- **Database:** {{DATABASE}}
+- **Authentication:** {{AUTH_METHOD}}
+
+---
+
+## 🚀 Getting Started
+
+### Prerequisites
+
+{{#EACH PREREQUISITE}}
+
+- {{PREREQUISITE_NAME}} {{PREREQUISITE_VERSION}}
+  {{/EACH}}
+
+### Installation
+
+```bash
+# Clone repository
+git clone {{REPOSITORY_URL}}
+cd {{PROJECT_DIR}}
+
+# Install dependencies
+{{INSTALL_COMMAND}}
+
+# Copy environment variables
+cp .env.example .env
+
+# Edit .env with your configuration
+# See .env.example for required variables
+
+# Setup database
+{{DB_SETUP_COMMAND}}
+
+# Run migrations
+{{MIGRATION_COMMAND}}
+
+# Start development server
+{{DEV_COMMAND}}
+```
+
+The application will be available at `{{DEV_URL}}`
+
+---
+
+## 🧪 Testing
+
+```bash
+# Run all tests
+{{TEST_COMMAND}}
+
+# Run with coverage
+{{COVERAGE_COMMAND}}
+
+# Run specific tests
+{{TEST_SPECIFIC_COMMAND}}
+```
+
+---
+
+## 📦 Building
+
+```bash
+# Build for production
+{{BUILD_COMMAND}}
+
+# Start production server
+{{PROD_COMMAND}}
+```
+
+---
+
+## 🔧 Available Scripts
+
+```bash
+{{#EACH SCRIPT}}
+# {{SCRIPT_DESCRIPTION}}
+{{SCRIPT_COMMAND}}
+
+{{/EACH}}
+```
+
+---
+
+## 📁 Project Structure
+
+```
+{{PROJECT_STRUCTURE}}
+```
+
+---
+
+## 📚 Documentation
+
+- [Architecture](docs/architecture.md) - System architecture and design patterns
+- [Data Model](docs/data-model.md) - Database schema and relationships
+- [Business Flows](docs/business-flows.md) - Main business processes and flowcharts
+- [API Reference](docs/api.md) - Endpoints and conventions
+- [Code Standards](docs/code-standards.md) - Coding conventions and quality rules
+- [Testing](docs/testing.md) - Testing strategy and requirements
+- [Operations](docs/operations.md) - Deployment and operational procedures
+- [Security](specs/security.md) - Security policies and compliance
+- [Configuration](specs/configuration.md) - Environment configuration
+- [Contributing](docs/contributing.md) - How to contribute
+
+### For AI Assistants
+
+- [AGENT.md](AGENT.md) - Universal AI configuration
+- [AI Instructions](ai-instructions.md) - AI development rules and workflow
+
+---
+
+## 🔐 Environment Variables
+
+See `.env.example` for all required environment variables.
+
+Critical variables:
+{{#EACH CRITICAL_VAR}}
+
+- `{{VAR_NAME}}` - {{VAR_DESCRIPTION}}
+  {{/EACH}}
+
+---
+
+## 🚀 Deployment
+
+See [docs/operations.md](docs/operations.md) for deployment procedures.
+
+**Platform:** {{DEPLOYMENT_PLATFORM}}
+
+**Environments:**
+
+- Development: {{DEV_URL}}
+- Staging: {{STAGING_URL}}
+- Production: {{PRODUCTION_URL}}
+
+---
+
+## 🤝 Contributing
+
+See [docs/contributing.md](docs/contributing.md) for contribution guidelines.
+
+1. Fork the repository
+2. Create feature branch (`git checkout -b feature/amazing-feature`)
+3. Commit changes (`git commit -m 'feat: add amazing feature'`)
+4. Push to branch (`git push origin feature/amazing-feature`)
+5. Open Pull Request
+
+---
+
+## 📝 License
+
+{{LICENSE}}
+
+---
+
+## 👥 Team
+
+{{#EACH TEAM_MEMBER}}
+
+- **{{MEMBER_NAME}}** - {{MEMBER_ROLE}}
+  {{/EACH}}
+
+---
+
+## 📞 Support
+
+{{#IF SUPPORT_EMAIL}}- Email: {{SUPPORT_EMAIL}}{{/IF}}
+{{#IF SUPPORT_SLACK}}- Slack: {{SUPPORT_SLACK}}{{/IF}}
+{{#IF ISSUE_TRACKER}}- Issues: {{ISSUE_TRACKER}}{{/IF}}
+
+---
+
+**Generated with** [AI Flow](https://github.com/victorvelazquez/ai-flow) 🚀