ai-flow-dev 2.1.3 → 2.1.4

package/templates/fullstack/ai-instructions.template.md

@@ -1,9 +1,7 @@
 # AI Instructions - Full Stack
 
 > **CRITICAL:** Every AI assistant MUST read and follow this document before any work.
-
----
-
+---
 ## 🎯 Project Overview
 
 **Name:** {{PROJECT_NAME}}
@@ -13,9 +11,7 @@
 **Purpose:** {{PROBLEM_STATEMENT}}
 
 **Target Users:** {{TARGET_USERS}}
-
----
-
+---
 ## 🏗️ Tech Stack
 
 ### Backend
@@ -90,9 +86,7 @@
 ### Key Libraries
 
 {{KEY_LIBRARIES}}
-
----
-
+---
 ## 🏛️ Architecture
 
 **Backend Pattern:** {{ARCHITECTURE_PATTERN}}
@@ -109,9 +103,7 @@
 ```
 {{FOLDER_STRUCTURE}}
 ```
-
----
-
+---
 ## ❌ NEVER Rules
 
 **YOU MUST NEVER:**
@@ -180,9 +172,7 @@
 - ❌ Commit failing tests - All tests must pass before commit
 
 {{CUSTOM_NEVER_RULES}}
-
----
-
+---
 ## ✅ ALWAYS Rules
 
 **YOU MUST ALWAYS:**
@@ -270,9 +260,7 @@
 - ✅ Test accessibility (screen reader compatibility)
 
 {{CUSTOM_ALWAYS_RULES}}
-
----
-
+---
 ## 🔄 Development Workflow
 
 ### 1. Before Starting a Task
@@ -318,9 +306,7 @@
 - Test in staging before production
 - Monitor logs after deployment
 - Verify both backend and frontend deployments
-
----
-
+---
 ## 🎯 Priorities
 
 When there are trade-offs, prioritize in this order:
@@ -330,17 +316,13 @@ When there are trade-offs, prioritize in this order:
 3. **{{PRIORITY_3}}** - {{PRIORITY_3_DESCRIPTION}}
 4. **{{PRIORITY_4}}** - {{PRIORITY_4_DESCRIPTION}}
 5. **{{PRIORITY_5}}** - {{PRIORITY_5_DESCRIPTION}}
-
----
-
+---
 ## 📁 Project Structure
 
 ```
 {{PROJECT_STRUCTURE}}
 ```
-
----
-
+---
 ## 🧪 Testing Commands
 
 **Backend:**
@@ -369,9 +351,7 @@ When there are trade-offs, prioritize in this order:
 # Run E2E tests
 {{PACKAGE_MANAGER}} run test:e2e
 ```
-
----
-
+---
 ## 🚀 Common Commands
 
 **Backend:**
@@ -412,9 +392,7 @@ When there are trade-offs, prioritize in this order:
 # Format code
 {{PACKAGE_MANAGER}} run format
 ```
-
----
-
+---
 ## 📚 Key Documentation Files
 
 - `project-brief.md` - Business context and objectives
@@ -431,9 +409,7 @@ When there are trade-offs, prioritize in this order:
 - `specs/security.md` - Security policies and compliance
 - `specs/configuration.md` - Environment configuration
 - `docs/contributing.md` - Development setup, workflow
-
----
-
+---
 ## 🔐 Environment Variables
 
 See `.env.example` files in both `backend/` and `frontend/` directories for all required environment variables.
@@ -443,9 +419,7 @@ See `.env.example` files in both `backend/` and `frontend/` directories for all
 
 **Frontend Critical Variables:**
 {{FRONTEND_CRITICAL_VARS}}
-
----
-
+---
 ## 🛡️ Security Checklist
 
 Before every feature:
@@ -465,9 +439,7 @@ Before every feature:
 - [ ] User input sanitized
 - [ ] No API keys exposed
 - [ ] Content Security Policy configured
-
----
-
+---
 ## 📞 When in Doubt
 
 1. Check this document first
@@ -476,12 +448,12 @@ Before every feature:
 4. Ask for clarification before making architectural decisions
 5. Prioritize security and maintainability over speed
 6. Consider both backend and frontend implications
-
----
-
+---
 **Remember:** These rules exist to maintain quality, security, and consistency. Following them makes the codebase better for everyone.
 
 **Last Updated:** {{GENERATION_DATE}}
 
 **Generated by:** AI Flow v1.3.0
 
+
+

package/templates/fullstack/project-brief.template.md

@@ -1,9 +1,7 @@
 # Project Brief
 
 > Business context and objectives for {{PROJECT_NAME}}
-
----
-
+---
 ## 🎯 Project Overview
 
 ### What Problem Are We Solving?
@@ -15,9 +13,7 @@
 {{PROJECT_DESCRIPTION}}
 
 **Project Type:** Full Stack Application (Backend API + Frontend Application)
-
----
-
+---
 ## 👥 Target Users
 
 {{TARGET_USERS_DESCRIPTION}}
@@ -26,9 +22,7 @@
 {{#EACH TARGET_USER}}
 - **{{USER_TYPE}}**: {{USER_DESCRIPTION}}
 {{/EACH}}
-
----
-
+---
 ## 🎯 Business Objectives
 
 ### Primary Objectives
@@ -38,9 +32,7 @@
    - {{OBJECTIVE_DESCRIPTION}}
    - Success metric: {{SUCCESS_METRIC}}
 {{/EACH}}
-
----
-
+---
 ## ✅ Scope
 
 ### In Scope
@@ -61,9 +53,7 @@
 {{#EACH OUT_OF_SCOPE_FEATURE}}
 - **{{FEATURE_NAME}}**: {{REASON_OUT_OF_SCOPE}}
 {{/EACH}}
-
----
-
+---
 ## 🚧 Constraints
 
 {{#EACH CONSTRAINT}}
@@ -74,9 +64,7 @@
 **Impact:** {{CONSTRAINT_IMPACT}}
 
 {{/EACH}}
-
----
-
+---
 ## 📊 Success Metrics (KPIs)
 
 ### Technical Metrics
@@ -96,9 +84,7 @@
 {{#EACH BUSINESS_METRIC}}
 - **{{METRIC_NAME}}**: {{METRIC_TARGET}}
 {{/EACH}}
-
----
-
+---
 ## 🗓️ Project Context
 
 **Current Phase:** {{PROJECT_PHASE}}
@@ -106,17 +92,13 @@
 {{#IF TIMELINE}}**Estimated Timeline:** {{TIMELINE}}{{/IF}}
 
 {{#IF BUDGET}}**Budget Constraints:** {{BUDGET}}{{/IF}}
-
----
-
+---
 ## 🏢 Stakeholders
 
 {{#EACH STAKEHOLDER}}
 - **{{STAKEHOLDER_ROLE}}**: {{STAKEHOLDER_INTEREST}}
 {{/EACH}}
-
----
-
+---
 ## 🔄 Integration Points
 
 **Backend External Systems:**
@@ -140,17 +122,13 @@ None - Frontend only consumes backend API.
   - Critical: {{IS_CRITICAL}}
 {{/EACH}}
 {{/IF}}
-
----
-
+---
 ## 📋 Key Assumptions
 
 {{#EACH ASSUMPTION}}
 - {{ASSUMPTION_DESCRIPTION}}
 {{/EACH}}
-
----
-
+---
 ## ⚠️ Risks
 
 {{#EACH RISK}}
@@ -165,18 +143,14 @@ None - Frontend only consumes backend API.
 **Mitigation:** {{RISK_MITIGATION}}
 
 {{/EACH}}
-
----
-
+---
 ## 🎓 Domain Glossary
 
 **Key terms and concepts:**
 {{#EACH GLOSSARY_TERM}}
 - **{{TERM}}**: {{DEFINITION}}
 {{/EACH}}
-
----
-
+---
 ## 📚 References
 
 {{#IF REFERENCES}}
@@ -186,12 +160,12 @@ None - Frontend only consumes backend API.
 {{ELSE}}
 No external references.
 {{/IF}}
-
----
-
+---
 **Document Version:** 1.0
 
 **Last Updated:** {{GENERATION_DATE}}
 
 **Generated by:** AI Flow v1.3.0
 
+
+

package/templates/fullstack/specs/configuration.template.md

@@ -1,9 +1,7 @@
 # Configuration Specifications
 
 > Environment variables and configuration management for {{PROJECT_NAME}} (Full Stack)
-
----
-
+---
 ## 🎯 Configuration Strategy
 
 **Approach:** {{CONFIGURATION_APPROACH}}
@@ -13,9 +11,7 @@
 2. **Security First** - Never expose secrets to client
 3. **Type Safety** - Validate and type all config
 4. **Environment Parity** - Consistent config across environments
-
----
-
+---
 ## 📁 Configuration Files Structure
 
 ```
@@ -36,9 +32,7 @@
 │           ├── schema.ts       # Validation schema
 │           └── constants.ts    # Static constants
 ```
-
----
-
+---
 ## 🔐 Backend Environment Variables
 
 ### Required Variables
@@ -70,9 +64,7 @@
 **Example:** `{{VAR_EXAMPLE}}`
 
 {{/EACH}}
-
----
-
+---
 ## 🎨 Frontend Environment Variables
 
 ### Required Variables
@@ -119,9 +111,7 @@
 - `VITE_ANALYTICS_*` - Analytics services
 
 **Important:** Only variables prefixed with `VITE_` (or your build tool's prefix) are exposed to the client.
-
----
-
+---
 ## 🌍 Configuration by Environment
 
 ### Development
@@ -159,9 +149,7 @@
 ```bash
 {{FRONTEND_PRODUCTION_ENV_CONFIG}}
 ```
-
----
-
+---
 ## 🔌 External Services
 
 ### Backend Services
@@ -199,9 +187,7 @@
 {{#IF SERVICE_FALLBACK}}**Fallback:** {{SERVICE_FALLBACK}}{{/IF}}
 
 {{/EACH}}
-
----
-
+---
 ## 💾 Database Configuration (Backend)
 
 ```bash
@@ -212,9 +198,7 @@
 - Min: {{DB_POOL_MIN}}
 - Max: {{DB_POOL_MAX}}
 - Idle Timeout: {{DB_IDLE_TIMEOUT}}ms
-
----
-
+---
 ## 🔐 Secrets Management
 
 ### Backend Secrets
@@ -242,9 +226,7 @@
 - API secret keys
 - Authentication secrets
 - Private keys
-
----
-
+---
 ## 🚩 Feature Flags
 
 ### Backend Feature Flags
@@ -284,9 +266,7 @@ Backend feature flags not implemented yet.
 Frontend feature flags not implemented yet.
 
 {{/IF}}
-
----
-
+---
 ## 🔒 Security Best Practices
 
 ### Backend
@@ -318,9 +298,7 @@ VITE_STRIPE_PUBLISHABLE_KEY=pk_live_...
 # Backend
 STRIPE_SECRET_KEY=sk_live_...
 ```
-
----
-
+---
 ## 🧪 Testing Configuration
 
 ### Backend Test Environment
@@ -345,9 +323,7 @@ export default defineConfig({
   },
 });
 ```
-
----
-
+---
 ## 📊 Configuration Monitoring
 
 ### Backend
@@ -361,20 +337,18 @@ export default defineConfig({
 - Log config on startup (development only)
 - Monitor API endpoint availability
 - Track feature flag usage
-
----
-
+---
 ## 🔗 Related Documents
 
 - [AI Instructions](../ai-instructions.md) - Configuration rules
 - [Security Specification](security.md) - Security requirements
 - [Deployment Guide](../docs/operations.md) - Environment setup
-
----
-
+---
 **Document Version:** 1.0
 
 **Last Updated:** {{GENERATION_DATE}}
 
 **Generated by:** AI Flow v1.3.0
 
+
+

package/templates/mobile/README.template.md

@@ -1,9 +1,7 @@
 # {{PROJECT_NAME}}
 
 > {{PROJECT_DESCRIPTION}}
-
----
-
+---
 ## 🚀 Quick Start
 
 ### Prerequisites
@@ -56,17 +54,13 @@ cp .env.example .env
 ```
 
 See `specs/configuration.md` for all environment variables.
-
----
-
+---
 ## 📁 Project Structure
 
 ```
 {{FOLDER_STRUCTURE}}
 ```
-
----
-
+---
 ## 🛠️ Development
 
 ### Available Scripts
@@ -89,9 +83,7 @@ See `specs/configuration.md` for all environment variables.
 - **Testing:** {{UNIT_TEST_FRAMEWORK}}, {{E2E_FRAMEWORK}}
 
 See `ai-instructions.md` for complete tech stack.
-
----
-
+---
 ## 📚 Documentation
 
 **For AI Assistants:**
@@ -109,9 +101,7 @@ See `ai-instructions.md` for complete tech stack.
 - `docs/app-store.md` - App Store configuration
 - `specs/build-configuration.md` - Build configuration
 - `specs/deployment.md` - Deployment procedures
-
----
-
+---
 ## 🧪 Testing
 
 ```bash
@@ -128,9 +118,7 @@ See `ai-instructions.md` for complete tech stack.
 {{PACKAGE_MANAGER}} run ios --device
 {{PACKAGE_MANAGER}} run android --device
 ```
-
----
-
+---
 ## 📱 Building for Production
 
 ### iOS
@@ -156,9 +144,7 @@ See `ai-instructions.md` for complete tech stack.
 ```
 
 See `specs/deployment.md` for detailed deployment instructions.
-
----
-
+---
 ## 🚀 Deployment
 
 ### App Store (iOS)
@@ -176,20 +162,16 @@ See `docs/app-store.md` for detailed instructions.
 3. Submit for review
 
 See `docs/app-store.md` for detailed instructions.
-
----
-
+---
 ## 📄 License
 
 {{LICENSE}}
-
----
-
+---
 ## 🤝 Contributing
 
 See `docs/contributing.md` for contribution guidelines.
+---
+**Last Updated:** {{LAST_UPDATED}}
 
----
 
-**Last Updated:** {{LAST_UPDATED}}
 

package/templates/mobile/ai-instructions.template.md

@@ -1,9 +1,7 @@
 # AI Instructions - Mobile
 
 > **CRITICAL:** Every AI assistant MUST read and follow this document before any work.
-
----
-
+---
 ## 🎯 Project Overview
 
 **Name:** {{PROJECT_NAME}}
@@ -13,9 +11,7 @@
 **Purpose:** {{PROBLEM_STATEMENT}}
 
 **Target Users:** {{TARGET_USERS}}
-
----
-
+---
 ## 🏗️ Tech Stack
 
 ### Mobile Platform
@@ -67,9 +63,7 @@
 - **Versioning:** {{VERSIONING_STRATEGY}}
 - **Analytics:** {{ANALYTICS_TOOL}}
 - **Crash Reporting:** {{CRASH_REPORTING_TOOL}}
-
----
-
+---
 ## 🏛️ Architecture
 
 **Architecture Pattern:** {{ARCHITECTURE_PATTERN}}
@@ -82,9 +76,7 @@
 ```
 {{FOLDER_STRUCTURE}}
 ```
-
----
-
+---
 ## ❌ NEVER Rules
 
 **YOU MUST NEVER:**
@@ -119,9 +111,7 @@
 - ❌ Assume iOS and Android are identical - Handle platform-specific code
 - ❌ Use platform-specific APIs without checks - Check platform before using
 - ❌ Ignore platform guidelines - Follow iOS Human Interface Guidelines and Material Design
-
----
-
+---
 ## ✅ ALWAYS Rules
 
 **YOU MUST ALWAYS:**
@@ -161,9 +151,7 @@
 - ✅ Test on multiple screen sizes
 - ✅ Test offline scenarios
 - ✅ Test permission flows
-
----
-
+---
 ## 📱 Mobile-Specific Guidelines
 
 ### iOS
@@ -188,9 +176,7 @@
 - ✅ Test on both platforms
 - ✅ Handle platform differences gracefully
 - ✅ Use platform detection utilities
-
----
-
+---
 ## 🔄 Development Workflow
 
 1. **Read this file first** - Understand tech stack and rules
@@ -199,9 +185,7 @@
 4. **Test on devices** - Not just simulators
 5. **Handle errors** - Graceful error handling
 6. **Optimize performance** - Monitor and optimize
-
----
-
+---
 ## 📚 Key Documentation
 
 - `AGENT.md` - Universal AI context
@@ -212,10 +196,10 @@
 - `docs/permissions.md` - Permissions handling
 - `docs/testing.md` - Testing strategy
 - `docs/app-store.md` - App Store deployment
-
----
-
+---
 **Last Updated:** {{LAST_UPDATED}}
 
 **Version:** {{PROJECT_VERSION}}
 
+
+