low-code-react-app-b/src/data/documentation/agents-data.json

{
  "title": "Agents Files",
  "subtitle": "AI agent configuration and service architecture",
  "overview": "CodeForge uses a modular AI service architecture that integrates OpenAI's GPT models across all features. Each designer has specialized prompts and validation logic to ensure high-quality generated code.",
  "coreServices": [
    {
      "filename": "ai-service.ts",
      "path": "/src/lib/ai-service.ts",
      "description": "Central AI service orchestrating OpenAI API calls",
      "features": [
        "Complete application generation from descriptions",
        "Model generation with Prisma schema validation",
        "Component generation with Material UI integration",
        "Theme generation with color theory and accessibility",
        "Code explanation and documentation",
        "Code improvement and optimization",
        "Test generation for Playwright, Storybook, and unit tests"
      ]
    },
    {
      "filename": "error-repair-service.ts",
      "path": "/src/lib/error-repair-service.ts",
      "description": "Error detection and automated repair system",
      "features": [
        "Syntax error detection and repair",
        "Import statement validation and fixes",
        "TypeScript type error resolution",
        "ESLint violation detection and fixes",
        "Context-aware repair using related files",
        "Batch repair operations",
        "Repair explanation generation"
      ]
    },
    {
      "filename": "generators.ts",
      "path": "/src/lib/generators.ts",
      "description": "Code generation utilities for project export",
      "features": [
        "Next.js project structure generation",
        "Prisma schema file generation",
        "Material UI theme configuration",
        "Playwright test file generation",
        "Storybook story file generation",
        "Unit test file generation",
        "Flask application structure",
        "Package.json configuration"
      ]
    }
  ],
  "integrationPoints": [
    {
      "component": "ModelDesigner",
      "capabilities": [
        "Generate models from natural language",
        "Suggest appropriate field types",
        "Create relations between models",
        "Generate realistic field names and structures"
      ]
    },
    {
      "component": "ComponentTreeBuilder",
      "capabilities": [
        "Generate component hierarchies",
        "Suggest Material UI components",
        "Create prop configurations",
        "Build complex layouts from descriptions"
      ]
    },
    {
      "component": "StyleDesigner",
      "capabilities": [
        "Generate color palettes from descriptions",
        "Ensure WCAG accessibility compliance",
        "Create harmonious color relationships",
        "Suggest typography pairings"
      ]
    },
    {
      "component": "CodeEditor",
      "capabilities": [
        "Explain code functionality",
        "Improve code quality and performance",
        "Suggest best practices",
        "Generate inline documentation"
      ]
    },
    {
      "component": "PlaywrightDesigner",
      "capabilities": [
        "Generate E2E test scenarios",
        "Create test steps from user flows",
        "Suggest appropriate selectors",
        "Generate assertions for validations"
      ]
    },
    {
      "component": "StorybookDesigner",
      "capabilities": [
        "Generate component stories",
        "Create meaningful story variations",
        "Configure args based on prop types",
        "Organize stories by categories"
      ]
    },
    {
      "component": "UnitTestDesigner",
      "capabilities": [
        "Generate comprehensive test suites",
        "Create test cases with assertions",
        "Generate setup and teardown code",
        "Cover edge cases and error scenarios"
      ]
    },
    {
      "component": "ErrorPanel",
      "capabilities": [
        "Analyze error patterns",
        "Generate context-aware fixes",
        "Explain error causes",
        "Prevent similar errors in future"
      ]
    }
  ],
  "promptEngineering": [
    {
      "title": "Context Preservation",
      "description": "All AI prompts include relevant project context such as existing models, components, and theme configurations to ensure generated code integrates seamlessly."
    },
    {
      "title": "Format Specification",
      "description": "Prompts specify exact output formats (JSON, TypeScript, Python) with strict schemas to ensure parseable and valid responses."
    },
    {
      "title": "Best Practices Enforcement",
      "description": "Generated code follows Next.js, React, and Flask best practices through detailed prompt instructions and post-processing validation."
    },
    {
      "title": "Error Handling",
      "description": "Fallback mechanisms and retry logic ensure graceful degradation when AI services are unavailable or responses are malformed."
    }
  ],
  "futureEnhancements": [
    {
      "title": "Multi-Model Support",
      "description": "Integration with Claude, Gemini, and other LLMs for specialized tasks"
    },
    {
      "title": "Fine-Tuned Models",
      "description": "Custom models trained on specific frameworks and design patterns"
    },
    {
      "title": "Code Review Agent",
      "description": "Automated code review with security and performance analysis"
    },
    {
      "title": "Conversational Interface",
      "description": "Chat-based project building with natural language commands"
    },
    {
      "title": "Learning System",
      "description": "AI that learns from user corrections and preferences over time"
    }
  ]
}