ai-flow-dev 1.0.1

package/templates/mobile/specs/build-configuration.template.md

@@ -0,0 +1,116 @@
+# Build Configuration
+
+> Build and CI/CD configuration for {{PROJECT_NAME}}
+
+---
+
+## 🔧 Build Tools
+
+**CI/CD Platform:** {{CICD_PLATFORM}}
+
+**Build Automation:** {{BUILD_AUTOMATION_TOOL}}
+
+**Versioning:** {{VERSIONING_STRATEGY}}
+
+---
+
+## 📦 Build Configuration
+
+### iOS Build
+
+**Xcode Version:** {{XCODE_VERSION}}
+
+**iOS Deployment Target:** {{IOS_DEPLOYMENT_TARGET}}
+
+**Build Configuration:**
+{{IOS_BUILD_CONFIGURATION}}
+
+### Android Build
+
+**Gradle Version:** {{GRADLE_VERSION}}
+
+**Android SDK:** {{ANDROID_SDK_VERSION}}
+
+**Min SDK:** {{MIN_ANDROID_SDK}}
+
+**Target SDK:** {{TARGET_ANDROID_SDK}}
+
+**Build Configuration:**
+{{ANDROID_BUILD_CONFIGURATION}}
+
+---
+
+## 🔐 Code Signing
+
+**Code Signing Strategy:** {{CODE_SIGNING_STRATEGY}}
+
+### iOS
+
+{{IOS_CODE_SIGNING_DESCRIPTION}}
+
+### Android
+
+{{ANDROID_CODE_SIGNING_DESCRIPTION}}
+
+---
+
+## 🚀 CI/CD Pipeline
+
+**Pipeline Configuration:**
+{{CICD_PIPELINE_DESCRIPTION}}
+
+### Build Steps
+
+{{BUILD_STEPS}}
+
+### Test Steps
+
+{{TEST_STEPS}}
+
+### Deployment Steps
+
+{{DEPLOYMENT_STEPS}}
+
+---
+
+## 📊 Build Artifacts
+
+**iOS:**
+- IPA file
+- dSYM file (for crash reporting)
+
+**Android:**
+- APK file (for testing)
+- AAB file (for Play Store)
+
+---
+
+## 🔄 Version Management
+
+**Versioning Strategy:** {{VERSIONING_STRATEGY}}
+
+**Version Format:** {{VERSION_FORMAT}}
+
+**Version Increment:** {{VERSION_INCREMENT_RULES}}
+
+---
+
+## 🛠️ Environment Variables
+
+{{ENVIRONMENT_VARIABLES}}
+
+---
+
+## ✅ Build Checklist
+
+- [ ] Build succeeds locally
+- [ ] Tests pass
+- [ ] Linting passes
+- [ ] Code signing configured
+- [ ] Environment variables set
+- [ ] Build artifacts generated
+
+---
+
+**Last Updated:** {{LAST_UPDATED}}
+

package/templates/mobile/specs/deployment.template.md

@@ -0,0 +1,114 @@
+# Deployment Procedures
+
+> Step-by-step deployment guide for {{PROJECT_NAME}}
+
+---
+
+## 🚀 Deployment Overview
+
+**Deployment Strategy:** {{DEPLOYMENT_STRATEGY}}
+
+**Release Frequency:** {{RELEASE_FREQUENCY}}
+
+**Rollback Strategy:** {{ROLLBACK_STRATEGY}}
+
+---
+
+## 📱 iOS Deployment
+
+### Prerequisites
+
+- Apple Developer Account
+- Xcode installed
+- Code signing certificates configured
+
+### Steps
+
+{{IOS_DEPLOYMENT_STEPS}}
+
+### Fastlane (if used)
+
+```bash
+fastlane ios release
+```
+
+---
+
+## 🤖 Android Deployment
+
+### Prerequisites
+
+- Google Play Developer Account
+- Signing keystore configured
+- AAB file built
+
+### Steps
+
+{{ANDROID_DEPLOYMENT_STEPS}}
+
+### Fastlane (if used)
+
+```bash
+fastlane android release
+```
+
+---
+
+## 🔄 Staged Rollout
+
+**Rollout Strategy:** {{ROLLOUT_STRATEGY}}
+
+{{ROLLOUT_DESCRIPTION}}
+
+---
+
+## 🔙 Rollback Procedure
+
+**Rollback Strategy:** {{ROLLBACK_STRATEGY}}
+
+{{ROLLBACK_PROCEDURE}}
+
+---
+
+## 📊 Post-Deployment
+
+### Monitoring
+
+- Monitor crash reports
+- Monitor analytics
+- Monitor user reviews
+
+### Verification
+
+- [ ] App appears in stores
+- [ ] App installs correctly
+- [ ] Key features work
+- [ ] No critical crashes
+
+---
+
+## ✅ Deployment Checklist
+
+### Pre-Deployment
+
+- [ ] All tests pass
+- [ ] Version number updated
+- [ ] Release notes prepared
+- [ ] Screenshots updated
+- [ ] Metadata reviewed
+
+### Deployment
+
+- [ ] Build uploaded
+- [ ] Metadata submitted
+- [ ] Submitted for review
+
+### Post-Deployment
+
+- [ ] Monitoring active
+- [ ] Ready for rollback if needed
+
+---
+
+**Last Updated:** {{LAST_UPDATED}}
+

package/templates/shared/AGENT.template.md

@@ -0,0 +1,252 @@
+# AGENT.md
+
+> Universal AI Assistant Configuration
+>
+> This file provides context for ALL AI development tools (Claude, Copilot, Cursor, Gemini, etc.)
+
+---
+
+## 📋 About This Project
+
+**Project Name:** {{PROJECT_NAME}}
+
+**Description:** {{PROJECT_DESCRIPTION}}
+
+**Problem We're Solving:** {{PROBLEM_STATEMENT}}
+
+**Target Users:** {{TARGET_USERS}}
+
+### Technical Context
+
+**Project Type:** Backend API/Service
+**Architecture:** {{ARCHITECTURE_PATTERN}}
+**Primary Language:** {{LANGUAGE}} {{LANGUAGE_VERSION}}
+**Framework:** {{FRAMEWORK}}
+**Database:** {{DATABASE}} with {{ORM}}
+
+**Key Characteristics:**
+
+- Authentication: {{AUTH_METHOD}}
+- API Style: {{API_STYLE}}
+- Deployment: {{DEPLOYMENT_PLATFORM}}
+- Current Phase: {{PROJECT_PHASE}}
+
+> This project uses AI-assisted development with comprehensive documentation.
+> All files below provide context to AI assistants for consistent, high-quality code generation.
+
+---
+
+## 🏗️ Documentation Architecture
+
+This project follows **AI-assisted development** with comprehensive documentation.
+All documentation is structured to guide AI assistants in understanding the project deeply.
+
+### 📚 Core Documentation (Read in Order)
+
+1. **`ai-instructions.md`** ⭐ **START HERE**
+
+   - Tech stack and versions
+   - NEVER/ALWAYS rules
+   - Development workflow
+   - Priorities
+
+2. **`project-brief.md`**
+
+   - Business context
+   - Objectives and scope
+   - Constraints and success metrics
+
+3. **`README.md`**
+
+   - Quick start
+   - Installation and commands
+   - Project directory tour
+
+4. **`docs/architecture.md`**
+
+   - System architecture pattern
+   - Component structure
+   - Request/response flow
+
+5. **`docs/data-model.md`**
+
+   - Database schema
+   - Entity relationships
+   - Data patterns
+
+6. **`docs/code-standards.md`**
+
+   - Naming conventions
+   - Code quality rules
+   - Error handling patterns
+
+7. **`docs/testing.md`**
+
+   - Testing strategy
+   - Coverage requirements
+   - Test patterns
+
+8. **`docs/operations.md`**
+
+   - Deployment procedures
+   - Monitoring and alerts
+   - Scaling strategy
+
+9. **`docs/business-flows.md`**
+
+   - End-to-end business processes
+   - Key actors and systems
+   - Flow diagrams
+
+10. **`docs/api.md`**
+
+    - Endpoint conventions
+    - Authentication and pagination rules
+    - Request/response examples
+
+11. **`docs/contributing.md`**
+
+    - Development setup
+    - Contribution guidelines
+    - Code review process
+
+12. **`specs/security.md`**
+
+    - Authentication/Authorization
+    - Security policies
+    - Compliance requirements
+
+13. **`specs/configuration.md`**
+
+    - Environment variables
+    - External services
+    - Configuration by environment
+
+14. **`.env.example`**
+    - Required environment variables
+    - Default/local values
+    - Secrets handling guidance
+
+---
+
+## ⚡ Quick Reference
+
+### Tech Stack
+
+**Backend:**
+
+- Framework: {{FRAMEWORK}}
+- Language: {{LANGUAGE}} {{LANGUAGE_VERSION}}
+- Database: {{DATABASE}}
+- ORM: {{ORM}}
+- Authentication: {{AUTH_METHOD}}
+- Caching: {{CACHE_STRATEGY}}
+
+**Infrastructure:**
+
+- Deployment: {{DEPLOYMENT_PLATFORM}}
+- CI/CD: {{CICD_PLATFORM}}
+- Monitoring: {{MONITORING_TOOLS}}
+
+### Critical Rules
+
+**❌ NEVER:**
+{{NEVER_RULES}}
+
+**✅ ALWAYS:**
+{{ALWAYS_RULES}}
+
+---
+
+## 🤖 AI Assistant Workflow
+
+When working on this project:
+
+1. **Before starting ANY task:**
+
+   - Read `ai-instructions.md` for project-wide rules
+   - Check relevant documentation for the area you're working on
+   - Understand the business context from `project-brief.md`
+
+2. **When implementing features:**
+
+   - Follow architecture patterns from `docs/architecture.md`
+   - Respect data models from `docs/data-model.md`
+   - Apply code standards from `docs/code-standards.md`
+   - Add tests according to `docs/testing.md`
+
+3. **When handling security:**
+
+   - Consult `specs/security.md` for auth/authz
+   - Never hardcode secrets (use `specs/configuration.md`)
+   - Follow security headers and encryption requirements
+
+4. **When deploying:**
+   - Follow procedures in `docs/operations.md`
+   - Update configuration per environment
+   - Check health endpoints
+
+---
+
+## 🛠️ Tool-Specific Configurations
+
+Different AI tools have specific configuration files that extend this AGENT.md:
+
+### Claude Code
+
+- **File:** `.clauderules`
+- **Purpose:** Claude-specific instructions and preferences
+- **References:** This AGENT.md + project docs
+
+### Cursor
+
+- **File:** `.cursorrules`
+- **Purpose:** Cursor-specific context and rules
+- **References:** This AGENT.md + project docs
+
+### GitHub Copilot
+
+- **File:** `.github/copilot-instructions.md`
+- **Purpose:** Copilot workspace instructions
+- **References:** This AGENT.md + project docs
+
+**All tool-specific configs reference this AGENT.md as the source of truth.**
+
+---
+
+## 📊 Project Status
+
+**Current Phase:** {{PROJECT_PHASE}}
+
+**Architecture:** {{ARCHITECTURE_PATTERN}}
+
+**Compliance:** {{COMPLIANCE_REQUIREMENTS}}
+
+---
+
+## 🚀 Getting Started
+
+### For AI Assistants
+
+1. Read this AGENT.md completely
+2. Read `ai-instructions.md` for critical rules
+3. Familiarize with `docs/architecture.md`
+4. Review `docs/code-standards.md` for coding patterns
+5. Check `specs/security.md` before handling auth/sensitive data
+
+### For Developers
+
+See `README.md` for installation and setup instructions.
+
+---
+
+## 📝 Document Update Policy
+
+- Documents are **living artifacts** - update as project evolves
+- Breaking changes to architecture → Update `docs/architecture.md`
+- New security requirements → Update `specs/security.md`
+- Stack changes → Update `ai-instructions.md` AND this AGENT.md
+
+**Last Updated:** {{GENERATION_DATE}}
+
+**Generated by:** AI Flow v1.1.1