ai-flow-dev 2.1.3 → 2.1.5

package/templates/frontend/docs/testing.template.md

@@ -1,9 +1,7 @@
 # Testing Strategy
 
 > Testing approach and best practices for {{PROJECT_NAME}}
-
 ---
-
 ## 🎯 Testing Philosophy
 
 **Goal:** Ship with confidence through comprehensive automated testing
@@ -13,9 +11,7 @@
 2. **Write tests that give confidence** - Focus on tests that catch real bugs
 3. **Avoid testing implementation details** - Refactors shouldn't break tests
 4. **Fast feedback loops** - Unit tests run in milliseconds, E2E in seconds
-
 ---
-
 ## 🏗️ Testing Pyramid
 
 ```
@@ -32,9 +28,7 @@
 - **70%** Unit Tests (fast, isolated)
 - **20%** Integration Tests (component + hooks + API)
 - **10%** E2E Tests (full user flows)
-
 ---
-
 ## 🧪 Testing Stack
 
 ### Test Frameworks
@@ -48,9 +42,7 @@
 - **Mocking:** {{MOCKING_LIBRARY}}
 - **Code Coverage:** {{COVERAGE_TOOL}}
 - **Visual Regression:** {{VISUAL_REGRESSION_TOOL}}
-
 ---
-
 ## 📦 Unit Testing
 
 ### What to Unit Test
@@ -146,9 +138,7 @@ describe('useCounter', () => {
   });
 });
 ```
-
 ---
-
 ## 🔗 Integration Testing
 
 ### What to Integration Test
@@ -301,9 +291,7 @@ describe('LoginForm', () => {
   });
 });
 ```
-
 ---
-
 ## 🌐 E2E Testing
 
 ### What to E2E Test
@@ -406,9 +394,7 @@ test('displays dashboard with mocked data', async ({ page }) => {
   await expect(page.locator('[data-testid="total-orders"]')).toHaveText('234');
 });
 ```
-
 ---
-
 ## 🎨 Visual Regression Testing
 
 ### Strategy: {{VISUAL_REGRESSION_TOOL}}
@@ -428,9 +414,7 @@ test('button variants', async ({ page }) => {
   await expect(page.locator('.button-secondary')).toHaveScreenshot('button-secondary.png');
 });
 ```
-
 ---
-
 ## 🧩 Testing Best Practices
 
 ### 1. Query Priorities (Testing Library)
@@ -509,9 +493,7 @@ describe('UserDashboard', () => {
   });
 });
 ```
-
 ---
-
 ## 📊 Code Coverage
 
 ### Coverage Targets
@@ -557,9 +539,7 @@ export default defineConfig({
   }
 });
 ```
-
 ---
-
 ## 🔧 Mocking Strategies
 
 ### 1. Mock Service Worker (API Mocking)
@@ -627,9 +607,7 @@ test('renders dashboard', () => {
   expect(screen.getByText('Chart Mock')).toBeInTheDocument();
 });
 ```
-
 ---
-
 ## ⚠️ Common Testing Pitfalls
 
 ### 1. Testing Implementation Details
@@ -677,9 +655,7 @@ vi.mock('./Form', () => ({ Form: () => <div>Form</div> }));
 // ✅ Good - Only mock external dependencies
 vi.mock('./api', () => ({ fetchData: vi.fn() }));
 ```
-
 ---
-
 ## 🚀 CI/CD Integration
 
 ### GitHub Actions Example
@@ -719,18 +695,16 @@ jobs:
           name: playwright-screenshots
           path: test-results/
 ```
-
 ---
-
 ## 🔗 Related Documents
 
 - [Component Architecture](components.md) - Component structure to test
 - [State Management](state-management.md) - Testing stores and hooks
 - [AI Instructions](../ai-instructions.md) - Testing requirements
 - [Contributing](contributing.md) - How to write tests
-
 ---
-
 **Last Updated:** {{GENERATION_DATE}}
 
 **Testing Stack:** {{UNIT_TEST_FRAMEWORK}} + {{COMPONENT_TEST_LIBRARY}} + {{E2E_FRAMEWORK}}
+
+

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

@@ -1,9 +1,7 @@
 # Project Brief
 
 > Business context and objectives for {{PROJECT_NAME}}
-
 ---
-
 ## 📋 Project Overview
 
 **Name:** {{PROJECT_NAME}}
@@ -13,43 +11,31 @@
 **Problem Statement:** {{PROBLEM_STATEMENT}}
 
 **Target Users:** {{TARGET_USERS}}
-
 ---
-
 ## 🎯 Objectives
 
 {{PROJECT_OBJECTIVES}}
-
 ---
-
 ## 🔍 Scope
 
 {{PROJECT_SCOPE}}
-
 ---
-
 ## 🚫 Out of Scope
 
 {{OUT_OF_SCOPE}}
-
 ---
-
 ## 📊 Success Metrics
 
 {{SUCCESS_METRICS}}
-
 ---
-
 ## ⏱️ Timeline
 
 {{PROJECT_TIMELINE}}
-
 ---
-
 ## 👥 Stakeholders
 
 {{STAKEHOLDERS}}
-
 ---
-
 **Last Updated:** {{GENERATION_DATE}}
+
+

package/templates/frontend/specs/accessibility.template.md

@@ -1,17 +1,13 @@
 # Accessibility Specification
 
 > Accessibility requirements and WCAG compliance for {{PROJECT_NAME}}
-
----
-
+---
 ## 🎯 Accessibility Target
 
 **WCAG Level:** {{A11Y_COMPLIANCE}}
 **Screen Reader Testing:** {{SCREEN_READER_TESTING}}
 **Keyboard Navigation:** {{KEYBOARD_NAVIGATION}}
-
----
-
+---
 ## ♿ WCAG Compliance
 
 ### Level AA Requirements
@@ -27,9 +23,7 @@
 - **Color Contrast:** 7:1 for normal text, 4.5:1 for large text
 - **Sign Language:** Sign language interpretation for audio
 - **Extended Audio Description:** Extended audio descriptions
-
----
-
+---
 ## ⌨️ Keyboard Navigation
 
 ### Focus Management
@@ -63,9 +57,7 @@ function trapFocus(element: HTMLElement) {
 ```html
 <a href="#main-content" class="skip-link">Skip to main content</a>
 ```
-
----
-
+---
 ## 🗣️ Screen Reader Support
 
 ### ARIA Labels
@@ -95,17 +87,15 @@ function trapFocus(element: HTMLElement) {
   <div><span>Home</span></div>
 </div>
 ```
-
----
-
+---
 ## 🔗 Related Documents
 
 - [Styling](../docs/styling.md) - Accessibility in styling
 - [Components](../docs/components.md) - Accessible components
-
----
-
+---
 **Last Updated:** {{GENERATION_DATE}}
 
 **WCAG Level:** {{A11Y_COMPLIANCE}}
 
+
+

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

@@ -1,9 +1,7 @@
 # Configuration Specification
 
 > Environment variables, feature flags, and configuration management for {{PROJECT_NAME}}
-
 ---
-
 ## 🎯 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
 
 ### File Structure
@@ -42,9 +38,7 @@
 ```
 
 **Note:** {{BUILD_TOOL}} automatically loads these files in priority order.
-
 ---
-
 ## 🔐 Environment Variables
 
 ### .env.example Template
@@ -120,9 +114,7 @@ VITE_SOURCE_MAPS=true
 - `VITE_ANALYTICS_*` - Analytics services
 
 **Important:** Only variables prefixed with `VITE_` (or your build tool's prefix) are exposed to the client.
-
 ---
-
 ## ⚙️ Configuration Loader
 
 ### src/config/index.ts
@@ -232,9 +224,7 @@ export const configSchema = z.object({
 
 export type Config = z.infer<typeof configSchema>;
 ```
-
 ---
-
 ## 🏗️ Build-Time vs Runtime Config
 
 ### Build-Time Configuration
@@ -284,9 +274,7 @@ export async function loadRuntimeConfig() {
 - Dynamic feature flags
 - A/B testing variants
 - Per-customer configs
-
 ---
-
 ## 🚩 Feature Flags
 
 ### Implementation Strategies
@@ -357,9 +345,7 @@ export function isFeatureEnabled(
 // Usage
 const showNewFeature = isFeatureEnabled('new-dashboard', user.id, 25); // 25% rollout
 ```
-
 ---
-
 ## 🔒 Security Best Practices
 
 ### 1. Never Expose Secrets
@@ -402,9 +388,7 @@ if (isNaN(port) || port < 1 || port > 65535) {
   throw new Error('Invalid port number');
 }
 ```
-
 ---
-
 ## 🌍 Environment-Specific Config
 
 ### Development (.env.development)
@@ -435,9 +419,7 @@ VITE_SOURCE_MAPS=false
 VITE_ENABLE_DEVTOOLS=false
 VITE_SENTRY_ENVIRONMENT=production
 ```
-
 ---
-
 ## 🧪 Testing Configuration
 
 ### Mocking Config in Tests
@@ -462,9 +444,7 @@ test('feature flag enabled', () => {
 
 vi.unstubAllEnvs();
 ```
-
 ---
-
 ## 📊 Configuration Monitoring
 
 ### Log Config on Startup (Development Only)
@@ -504,17 +484,15 @@ if (isProduction && config.analytics.sentryDsn) {
   });
 }
 ```
-
 ---
-
 ## 🔗 Related Documents
 
 - [AI Instructions](../ai-instructions.md) - Configuration rules
 - [Security Specification](security.md) - Security requirements
 - [Deployment Guide](../docs/operations.md) - Environment setup
-
 ---
-
 **Last Updated:** {{GENERATION_DATE}}
 
 **Configuration Approach:** {{CONFIGURATION_APPROACH}}
+
+

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

@@ -1,9 +1,7 @@
 # Security Specification
 
 > Frontend security requirements and best practices for {{PROJECT_NAME}}
-
----
-
+---
 ## 🎯 Security Strategy
 
 **CSP:** {{CSP_ENABLED}}
@@ -11,9 +9,7 @@
 **Secure Storage:** {{SECURE_STORAGE}}
 **HTTPS:** {{HTTPS_ENFORCEMENT}}
 **Dependency Scanning:** {{DEPENDENCY_SCANNING}}
-
----
-
+---
 ## 🛡️ Content Security Policy (CSP)
 
 ### CSP Configuration
@@ -47,9 +43,7 @@
   upgrade-insecure-requests;
 ">
 ```
-
----
-
+---
 ## 🔒 XSS Prevention
 
 ### Input Sanitization
@@ -89,9 +83,7 @@ export function isValidUrl(url: string): boolean {
   }
 }
 ```
-
----
-
+---
 ## 🔐 Secure Storage
 
 ### Token Storage Strategy
@@ -134,9 +126,7 @@ export function savePreferences(prefs: UserPreferences): void {
   localStorage.setItem(PREFERENCE_KEY, JSON.stringify(prefs));
 }
 ```
-
----
-
+---
 ## 🔒 HTTPS Enforcement
 
 ### Redirect HTTP to HTTPS
@@ -153,9 +143,7 @@ if (location.protocol === 'http:' && location.hostname !== 'localhost') {
 ```
 Strict-Transport-Security: max-age=31536000; includeSubDomains
 ```
-
----
-
+---
 ## 🔍 Dependency Security
 
 ### Automated Scanning
@@ -181,17 +169,15 @@ npx snyk test
 - [ ] Review security advisories
 - [ ] Use Dependabot or similar
 - [ ] Remove unused dependencies
-
----
-
+---
 ## 🔗 Related Documents
 
 - [Configuration](configuration.md) - Environment security
 - [Error Handling](../docs/error-handling.md) - Security error handling
-
----
-
+---
 **Last Updated:** {{GENERATION_DATE}}
 
 **Security Level:** {{SECURITY_LEVEL}}
 
+
+

package/templates/fullstack/README.template.md

@@ -1,26 +1,20 @@
 # {{PROJECT_NAME}}
 
 > {{PROJECT_DESCRIPTION}}
-
----
-
+---
 ## 📋 Overview
 
 {{PROBLEM_STATEMENT}}
 
 **Target Users:** {{TARGET_USERS_SUMMARY}}
-
----
-
+---
 ## ✨ Features
 
 {{#EACH FEATURE}}
 
 - **{{FEATURE_NAME}}**: {{FEATURE_DESCRIPTION}}
   {{/EACH}}
-
----
-
+---
 ## 🏗️ Tech Stack
 
 ### Backend
@@ -37,9 +31,7 @@
 - **Styling:** {{STYLING_APPROACH}}
 - **State Management:** {{STATE_MANAGEMENT}}
 - **Testing:** {{UNIT_TEST_FRAMEWORK}}, {{E2E_FRAMEWORK}}
-
----
-
+---
 ## 🚀 Getting Started
 
 ### Prerequisites
@@ -94,9 +86,7 @@ cd frontend
 ```
 
 The frontend application will be available at `{{FRONTEND_DEV_URL}}`
-
----
-
+---
 ## 🧪 Testing
 
 **Backend:**
@@ -121,9 +111,7 @@ cd frontend
 # Run E2E tests
 {{PACKAGE_MANAGER}} run test:e2e
 ```
-
----
-
+---
 ## 📦 Building
 
 **Backend:**
@@ -145,9 +133,7 @@ cd frontend
 # Preview production build
 {{PACKAGE_MANAGER}} run preview
 ```
-
----
-
+---
 ## 🔧 Available Scripts
 
 **Backend:**
@@ -168,17 +154,13 @@ cd frontend
 - {{PACKAGE_MANAGER}} run lint - Run linter
 - {{PACKAGE_MANAGER}} run format - Format code
 ```
-
----
-
+---
 ## 📁 Project Structure
 
 ```
 {{PROJECT_STRUCTURE}}
 ```
-
----
-
+---
 ## 📚 Documentation
 
 ### Backend Documentation
@@ -206,9 +188,7 @@ cd frontend
 
 - [AGENT.md](AGENT.md) - Universal AI configuration
 - [AI Instructions](ai-instructions.md) - AI development rules and workflow
-
----
-
+---
 ## 🔐 Environment Variables
 
 See `.env.example` files in both `backend/` and `frontend/` directories for all required environment variables.
@@ -224,9 +204,7 @@ See `.env.example` files in both `backend/` and `frontend/` directories for all
 
 - `{{VAR_NAME}}` - {{VAR_DESCRIPTION}}
   {{/EACH}}
-
----
-
+---
 ## 🚀 Deployment
 
 See [docs/operations.md](docs/operations.md) for deployment procedures.
@@ -240,9 +218,7 @@ See [docs/operations.md](docs/operations.md) for deployment procedures.
 - Development: Backend `{{DEV_URL}}` | Frontend `{{FRONTEND_DEV_URL}}`
 - Staging: Backend `{{STAGING_URL}}` | Frontend `{{FRONTEND_STAGING_URL}}`
 - Production: Backend `{{PRODUCTION_URL}}` | Frontend `{{FRONTEND_PRODUCTION_URL}}`
-
----
-
+---
 ## 🤝 Contributing
 
 See [docs/contributing.md](docs/contributing.md) for contribution guidelines.
@@ -252,31 +228,25 @@ See [docs/contributing.md](docs/contributing.md) for contribution guidelines.
 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) | `npm i -g ai-flow-dev` 🚀
 
----
 
-**Generated with** [AI Flow](https://github.com/victorvelazquez/ai-flow) | `npm i -g ai-flow-dev` 🚀