ai-flow-dev 2.1.2 → 2.1.4

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

@@ -1,9 +1,7 @@
 # Project Brief
 
 > Business context and objectives for {{PROJECT_NAME}}
-
 ---
-
 ## 🎯 Project Overview
 
 ### What Problem Are We Solving?
@@ -13,9 +11,7 @@
 ### Description
 
 {{PROJECT_DESCRIPTION}}
-
 ---
-
 ## 👥 Target Users
 
 {{TARGET_USERS_DESCRIPTION}}
@@ -24,9 +20,7 @@
 {{#EACH TARGET_USER}}
 - **{{USER_TYPE}}**: {{USER_DESCRIPTION}}
 {{/EACH}}
-
 ---
-
 ## 🎯 Business Objectives
 
 ### Primary Objectives
@@ -36,9 +30,7 @@
    - {{OBJECTIVE_DESCRIPTION}}
    - Success metric: {{SUCCESS_METRIC}}
 {{/EACH}}
-
 ---
-
 ## ✅ Scope
 
 ### In Scope
@@ -56,9 +48,7 @@
 {{#EACH OUT_OF_SCOPE_FEATURE}}
 - **{{FEATURE_NAME}}**: {{REASON_OUT_OF_SCOPE}}
 {{/EACH}}
-
 ---
-
 ## 🚧 Constraints
 
 {{#EACH CONSTRAINT}}
@@ -69,9 +59,7 @@
 **Impact:** {{CONSTRAINT_IMPACT}}
 
 {{/EACH}}
-
 ---
-
 ## 📊 Success Metrics (KPIs)
 
 ### Technical Metrics
@@ -85,9 +73,7 @@
 {{#EACH BUSINESS_METRIC}}
 - **{{METRIC_NAME}}**: {{METRIC_TARGET}}
 {{/EACH}}
-
 ---
-
 ## 🗓️ Project Context
 
 **Current Phase:** {{PROJECT_PHASE}}
@@ -95,17 +81,13 @@
 {{#IF TIMELINE}}**Estimated Timeline:** {{TIMELINE}}{{/IF}}
 
 {{#IF BUDGET}}**Budget Constraints:** {{BUDGET}}{{/IF}}
-
 ---
-
 ## 🏢 Stakeholders
 
 {{#EACH STAKEHOLDER}}
 - **{{STAKEHOLDER_ROLE}}**: {{STAKEHOLDER_INTEREST}}
 {{/EACH}}
-
 ---
-
 ## 🔄 Integration Points
 
 **External Systems:**
@@ -119,17 +101,13 @@ None - This is a standalone system.
   - Critical: {{IS_CRITICAL}}
 {{/EACH}}
 {{/IF}}
-
 ---
-
 ## 📋 Key Assumptions
 
 {{#EACH ASSUMPTION}}
 - {{ASSUMPTION_DESCRIPTION}}
 {{/EACH}}
-
 ---
-
 ## ⚠️ Risks
 
 {{#EACH RISK}}
@@ -144,9 +122,7 @@ None - This is a standalone system.
 **Mitigation:** {{RISK_MITIGATION}}
 
 {{/EACH}}
-
 ---
-
 ## 🎓 Domain Glossary
 
 **Key terms and concepts:**
@@ -154,9 +130,7 @@ None - This is a standalone system.
 {{#EACH GLOSSARY_TERM}}
 - **{{TERM}}**: {{DEFINITION}}
 {{/EACH}}
-
 ---
-
 ## 📚 References
 
 {{#IF REFERENCES}}
@@ -166,11 +140,11 @@ None - This is a standalone system.
 {{ELSE}}
 No external references.
 {{/IF}}
-
 ---
-
 **Document Version:** 1.0
 
 **Last Updated:** {{GENERATION_DATE}}
 
 **Generated by:** AI Flow v1.0.0
+
+

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

@@ -1,9 +1,7 @@
 # Configuration Specifications
 
 > Environment variables and configuration management for {{PROJECT_NAME}}
-
 ---
-
 ## 📋 Environment Variables
 
 ### Required Variables
@@ -35,9 +33,7 @@
 **Example:** `{{VAR_EXAMPLE}}`
 
 {{/EACH}}
-
 ---
-
 ## 🌍 Configuration by Environment
 
 ### Development
@@ -57,9 +53,7 @@
 ```bash
 {{PRODUCTION_ENV_CONFIG}}
 ```
-
 ---
-
 ## 🔌 External Services
 
 {{#EACH EXTERNAL_SERVICE}}
@@ -77,9 +71,7 @@
 {{#IF SERVICE_FALLBACK}}**Fallback:** {{SERVICE_FALLBACK}}{{/IF}}
 
 {{/EACH}}
-
 ---
-
 ## 💾 Database Configuration
 
 ```bash
@@ -90,9 +82,7 @@
 - Min: {{DB_POOL_MIN}}
 - Max: {{DB_POOL_MAX}}
 - Idle Timeout: {{DB_IDLE_TIMEOUT}}ms
-
 ---
-
 ## 🔐 Secrets
 
 **Never commit these variables:**
@@ -102,9 +92,7 @@
 {{/EACH}}
 
 **Storage:** {{SECRETS_STORAGE}}
-
 ---
-
 ## 🎚️ Feature Flags
 
 {{#IF FEATURE_FLAGS}}
@@ -123,11 +111,11 @@
 Feature flags not implemented yet.
 
 {{/IF}}
-
 ---
-
 **Document Version:** 1.0
 
 **Last Updated:** {{GENERATION_DATE}}
 
 **Generated by:** AI Flow v1.0.0
+
+

package/templates/backend/specs/security.template.md

@@ -1,9 +1,7 @@
 # Security Specifications
 
 > Security policies, authentication, authorization, and compliance for {{PROJECT_NAME}}
-
 ---
-
 ## 🔐 Authentication
 
 ### Method
@@ -53,9 +51,7 @@
 **Scopes:** {{OAUTH_SCOPES}}
 
 {{/IF}}
-
 ---
-
 ## 🛡️ Authorization
 
 ### Model
@@ -93,9 +89,7 @@
 {{/EACH}}
 
 {{/IF}}
-
 ---
-
 ## 🔑 Password Policy
 
 **Requirements:**
@@ -113,9 +107,7 @@
 ```{{LANGUAGE}}
 {{PASSWORD_HASHING_EXAMPLE}}
 ```
-
 ---
-
 ## 🚦 Rate Limiting
 
 **Strategy:** {{RATE_LIMIT_STRATEGY}}
@@ -133,9 +125,7 @@
 ```{{LANGUAGE}}
 {{RATE_LIMIT_IMPLEMENTATION}}
 ```
-
 ---
-
 ## 🌐 CORS Policy
 
 **Allowed Origins:**
@@ -150,9 +140,7 @@
 **Credentials:** {{CORS_CREDENTIALS}}
 
 **Max Age:** {{CORS_MAX_AGE}} seconds
-
 ---
-
 ## 🔒 Data Encryption
 
 ### In Transit
@@ -184,9 +172,7 @@
 **Status:** Not implemented yet
 
 {{/IF}}
-
 ---
-
 ## 🛡️ Security Headers
 
 {{#EACH SECURITY_HEADER}}
@@ -202,9 +188,7 @@
 ```{{LANGUAGE}}
 {{SECURITY_HEADERS_IMPLEMENTATION}}
 ```
-
 ---
-
 ## ✅ Input Validation
 
 **Library:** {{VALIDATION_LIBRARY}}
@@ -220,9 +204,7 @@
 ```{{LANGUAGE}}
 {{INPUT_VALIDATION_EXAMPLE}}
 ```
-
 ---
-
 ## 🚫 Security Vulnerabilities Prevention
 
 ### SQL Injection
@@ -240,9 +222,7 @@
 ### CSRF (Cross-Site Request Forgery)
 
 {{CSRF_PREVENTION_STRATEGY}}
-
 ---
-
 ## 📜 Compliance
 
 {{#EACH COMPLIANCE_REQ}}
@@ -259,9 +239,7 @@
 {{COMPLIANCE_IMPLEMENTATION}}
 
 {{/EACH}}
-
 ---
-
 ## 📝 Audit Logging
 
 **What We Log:**
@@ -275,9 +253,7 @@
 ```json
 {{AUDIT_LOG_FORMAT}}
 ```
-
 ---
-
 ## 🔒 Secrets Management
 
 **Tool:** {{SECRETS_MANAGER}}
@@ -290,9 +266,7 @@
 **Access Policy:** {{SECRETS_ACCESS_POLICY}}
 
 **Rotation:** {{SECRETS_ROTATION}}
-
 ---
-
 ## 🔑 API Keys Management
 
 {{#IF API_KEYS_ENABLED}}
@@ -356,9 +330,7 @@
 {{ELSE}}
 **API Keys:** Not used - Authentication via JWT/Sessions only
 {{/IF}}
-
 ---
-
 ## 🔍 Dependency Security
 
 **Scanning Tool:** {{DEPENDENCY_SCANNER}}
@@ -401,9 +373,7 @@
 - ✅ Regular security audits ({{AUDIT_FREQUENCY}})
 - ❌ Don't ignore critical vulnerabilities
 - ❌ Don't update without testing
-
 ---
-
 ## 🚨 Security Incident Response
 
 **Contact:** {{SECURITY_CONTACT}}
@@ -412,11 +382,11 @@
 {{#EACH INCIDENT_STEP}}
 {{STEP_NUMBER}}. {{STEP_DESCRIPTION}}
 {{/EACH}}
-
 ---
-
 **Document Version:** 1.0
 
 **Last Updated:** {{GENERATION_DATE}}
 
 **Generated by:** AI Flow v1.0.0
+
+

package/templates/frontend/README.template.md

@@ -1,9 +1,7 @@
 # {{PROJECT_NAME}}
 
 > {{PROJECT_DESCRIPTION}}
-
 ---
-
 ## 🚀 Quick Start
 
 ### Prerequisites
@@ -34,17 +32,13 @@ cp .env.example .env
 ```
 
 See `specs/configuration.md` for all environment variables.
-
 ---
-
 ## 📁 Project Structure
 
 ```
 {{FOLDER_STRUCTURE}}
 ```
-
 ---
-
 ## 🛠️ Development
 
 ### Available Scripts
@@ -65,9 +59,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:**
@@ -80,9 +72,7 @@ See `ai-instructions.md` for complete tech stack.
 - `docs/styling.md` - Styling guidelines
 - `docs/testing.md` - Testing strategy
 - `specs/accessibility.md` - A11y requirements
-
 ---
-
 ## 🧪 Testing
 
 ```bash
@@ -95,27 +85,21 @@ See `ai-instructions.md` for complete tech stack.
 # Run E2E tests
 {{PACKAGE_MANAGER}} run test:e2e
 ```
-
 ---
-
 ## 🚢 Deployment
 
 {{DEPLOYMENT_INSTRUCTIONS}}
 
 See `docs/operations.md` for detailed deployment procedures.
-
 ---
-
 ## 🤝 Contributing
 
 See `docs/contributing.md` for contribution guidelines.
-
 ---
-
 ## 📄 License
 
 {{LICENSE}}
-
 ---
-
 **Last Updated:** {{GENERATION_DATE}}
+
+

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

@@ -1,9 +1,7 @@
 # AI Instructions - Frontend
 
 > **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
 
 ### Frontend
@@ -64,9 +60,7 @@
 - **CI/CD:** {{CICD_PLATFORM}}
 - **CDN:** {{CDN_PROVIDER}}
 - **Analytics:** {{ANALYTICS_TOOL}}
-
 ---
-
 ## 🏛️ Architecture
 
 **Component Pattern:** {{COMPONENT_PATTERN}}
@@ -79,9 +73,7 @@
 ```
 {{FOLDER_STRUCTURE}}
 ```
-
 ---
-
 ## ❌ NEVER Rules
 
 **YOU MUST NEVER:**
@@ -174,9 +166,7 @@
 - ❌ Forget responsive design - Mobile-first approach
 - ❌ Ignore dark mode support (if {{THEME_SUPPORT}} includes dark mode)
 - ❌ Use RGB hex colors directly - Use CSS variables or design tokens
-
 ---
-
 ## ✅ ALWAYS Rules
 
 **YOU MUST ALWAYS:**
@@ -273,9 +263,7 @@
 - ✅ Implement proper error messages
 - ✅ Cache responses when appropriate
 - ✅ Cancel requests on component unmount
-
 ---
-
 ## 🎨 Code Style
 
 ### Naming Conventions
@@ -299,9 +287,7 @@
 3. Relative imports (./Button, ../utils)
 4. Styles
 5. Types (if separate file)
-
 ---
-
 ## 🚀 Development Workflow
 
 ### Before Starting Any Task
@@ -335,9 +321,7 @@
 - ✅ Build succeeds: `npm run build`
 - ✅ No console.log statements
 - ✅ No commented code
-
 ---
-
 ## 📊 Performance Targets
 
 **Core Web Vitals:**
@@ -348,9 +332,7 @@
 **Bundle Size:**
 - Initial bundle: {{INITIAL_BUNDLE_TARGET}}
 - Route bundles: {{ROUTE_BUNDLE_TARGET}}
-
 ---
-
 ## 🔗 Related Documents
 
 - [Component Architecture](docs/components.md) - Component patterns and structure
@@ -360,9 +342,9 @@
 - [API Integration](docs/api-integration.md) - API communication patterns
 - [Performance](docs/performance.md) - Performance optimization
 - [Accessibility](specs/accessibility.md) - WCAG compliance details
-
 ---
-
 **Last Updated:** {{GENERATION_DATE}}
 
 **Framework:** {{UI_FRAMEWORK}} {{UI_FRAMEWORK_VERSION}}
+
+

package/templates/frontend/docs/api-integration.template.md

@@ -1,17 +1,13 @@
 # API Integration
 
 > API communication patterns and best practices for {{PROJECT_NAME}}
-
----
-
+---
 ## 🎯 API Integration Strategy
 
 **Pattern:** {{API_INTEGRATION_PATTERN}}
 **Client:** {{API_CLIENT}}
 **Base URL:** {{API_BASE_URL}}
-
----
-
+---
 ## 📡 API Client Setup
 
 ### Base Configuration
@@ -56,9 +52,7 @@ apiClient.interceptors.response.use(
 
 export default apiClient;
 ```
-
----
-
+---
 ## 🏗️ API Layer Pattern
 
 ### Service Layer (Recommended)
@@ -149,9 +143,7 @@ export const useUsers = () => {
   return { getById, create };
 };
 ```
-
----
-
+---
 ## 🔄 Error Handling
 
 ### Error Types
@@ -219,9 +211,7 @@ export function handleApiError(error: unknown): string {
   return 'An unexpected error occurred.';
 }
 ```
-
----
-
+---
 ## 🔁 Retry Strategy
 
 ### Automatic Retry
@@ -259,9 +249,7 @@ const { data } = useQuery({
   retryDelay: (attemptIndex) => Math.min(1000 * 2 ** attemptIndex, 30000),
 });
 ```
-
----
-
+---
 ## 🔐 Authentication
 
 ### Token Management
@@ -314,9 +302,7 @@ export async function refreshAuthToken(): Promise<string> {
   return refreshTokenPromise;
 }
 ```
-
----
-
+---
 ## 📊 Request/Response Transformation
 
 ### Request Transformation
@@ -344,9 +330,7 @@ apiClient.interceptors.response.use((response) => {
   return response;
 });
 ```
-
----
-
+---
 ## 🧪 Testing API Integration
 
 ### Mocking API Calls
@@ -372,19 +356,17 @@ beforeAll(() => server.listen());
 afterEach(() => server.resetHandlers());
 afterAll(() => server.close());
 ```
-
----
-
+---
 ## 🔗 Related Documents
 
 - [State Management](state-management.md) - Server state patterns
 - [Error Handling](error-handling.md) - Error handling strategies
 - [Security](security.md) - Security best practices
-
----
-
+---
 **Last Updated:** {{GENERATION_DATE}}
 
 **API Pattern:** {{API_INTEGRATION_PATTERN}}
 **Client:** {{API_CLIENT}}
 
+
+