project_config.json

{
  "slug": "code-tutor-api",
  "name": "Code Tutor Api",
  "domain": "Education / Coding",
  "target_user": "Domain operator, business owner, analyst, or team member who needs this workflow executed reliably.",
  "core_job": "Student code → explanation, diagnosis, next exercise",
  "deep_features": [
    "mistake pattern detection",
    "hint ladder",
    "concept map",
    "adaptive exercises",
    "mastery score",
    "LMS export",
    "anti-cheat guidance"
  ],
  "input_schema": [
    {
      "key": "student_code",
      "label": "Student code",
      "type": "text",
      "required": true,
      "help": "Affects input: Student code.",
      "affects": [
        "prompt",
        "workflow"
      ],
      "default": ""
    },
    {
      "key": "work_brief",
      "label": "Work brief / source text / URL / instructions",
      "type": "textarea",
      "required": true,
      "default": "",
      "help": "Paste the material, URL, description, or instruction needed for this project.",
      "affects": [
        "prompt",
        "workflow"
      ]
    }
  ],
  "customization_schema": [
    {
      "key": "execution_mode",
      "label": "Execution mode",
      "type": "select",
      "required": false,
      "options": [
        "Draft",
        "Production",
        "Audit / strict review",
        "JSON/API output"
      ],
      "default": "Production",
      "help": "Controls strictness, depth, and output format for this project workflow.",
      "affects": [
        "workflow",
        "validation",
        "export"
      ]
    },
    {
      "key": "programming_language",
      "label": "programming language",
      "type": "select",
      "required": false,
      "help": "Affects customization: programming language.",
      "affects": [
        "prompt",
        "validation",
        "workflow",
        "export"
      ],
      "options": [
        "English",
        "Arabic",
        "Egyptian Arabic",
        "French",
        "German",
        "Spanish"
      ],
      "default": "English"
    },
    {
      "key": "learner_level",
      "label": "learner level",
      "type": "select",
      "required": false,
      "help": "Affects customization: learner level.",
      "affects": [
        "prompt",
        "validation",
        "workflow",
        "export"
      ],
      "default": ""
    },
    {
      "key": "curriculum",
      "label": "curriculum",
      "type": "text",
      "required": false,
      "help": "Affects customization: curriculum.",
      "affects": [
        "prompt",
        "validation",
        "workflow",
        "export"
      ],
      "default": ""
    },
    {
      "key": "hint_style",
      "label": "hint style",
      "type": "select",
      "required": false,
      "help": "Affects customization: hint style.",
      "affects": [
        "prompt",
        "validation",
        "workflow",
        "export"
      ],
      "default": ""
    },
    {
      "key": "rubric",
      "label": "rubric",
      "type": "text",
      "required": false,
      "help": "Affects customization: rubric.",
      "affects": [
        "prompt",
        "validation",
        "workflow",
        "export"
      ],
      "default": ""
    },
    {
      "key": "explanation_depth",
      "label": "explanation depth",
      "type": "text",
      "required": false,
      "help": "Affects customization: explanation depth.",
      "affects": [
        "prompt",
        "validation",
        "workflow",
        "export"
      ],
      "default": ""
    },
    {
      "key": "exercise_difficulty",
      "label": "exercise difficulty",
      "type": "text",
      "required": false,
      "help": "Affects customization: exercise difficulty.",
      "affects": [
        "prompt",
        "validation",
        "workflow",
        "export"
      ],
      "default": ""
    },
    {
      "key": "output_format",
      "label": "output format",
      "type": "select",
      "required": false,
      "help": "Affects customization: output format.",
      "affects": [
        "prompt",
        "validation",
        "workflow",
        "export"
      ],
      "options": [
        "Markdown",
        "JSON",
        "CSV",
        "PDF",
        "DOCX",
        "XLSX"
      ],
      "default": "Markdown"
    },
    {
      "key": "language",
      "label": "language",
      "type": "select",
      "required": false,
      "help": "Affects customization: language.",
      "affects": [
        "prompt",
        "validation",
        "workflow",
        "export"
      ],
      "options": [
        "English",
        "Arabic",
        "Egyptian Arabic",
        "French",
        "German",
        "Spanish"
      ],
      "default": "English"
    },
    {
      "key": "privacy_mode",
      "label": "privacy mode",
      "type": "select",
      "required": false,
      "help": "Affects customization: privacy mode.",
      "affects": [
        "prompt",
        "validation",
        "workflow",
        "export"
      ],
      "options": [
        "cloud allowed",
        "local only",
        "redact sensitive data"
      ],
      "default": "cloud allowed"
    },
    {
      "key": "confidence_threshold",
      "label": "Confidence threshold",
      "type": "slider",
      "required": false,
      "min": 0,
      "max": 100,
      "default": 75,
      "help": "Items below this confidence are escalated to the human review queue.",
      "affects": [
        "validation",
        "workflow",
        "export"
      ]
    }
  ],
  "workflow_steps": [
    "Student code",
    "explanation, diagnosis, next exercise"
  ],
  "ui_panels": [
    "code editor",
    "hints panel",
    "concept map",
    "exercise generator",
    "progress dashboard"
  ],
  "output_formats": [
    "feedback JSON",
    "exercises",
    "LMS report",
    "student summary"
  ],
  "integrations": [
    "File upload",
    "REST API",
    "Export download",
    "Job history"
  ],
  "guardrails": [
    "Show uncertainty and confidence",
    "Cite evidence from input when possible",
    "Human review required for legal, medical, financial, hiring, or security decisions",
    "Do not invent facts absent from input"
  ],
  "recommended_models": {
    "drafting": "fast cloud or local instruct model",
    "reasoning": "strong reasoning model",
    "private_documents": "local model via Ollama/LM Studio/vLLM",
    "vision_or_pdf": "vision-capable model when image pages are used"
  },
  "suite": "Developer Productivity Suite",
  "implementation_status": "real_local_engine_registered",
  "analysis_modules": [
    "code_inventory",
    "learning_diagnosis",
    "exercise_builder"
  ],
  "output_sections": [
    "Explanation",
    "Mistake diagnosis",
    "Next exercises",
    "Rubric"
  ],
  "field_validations": [
    {
      "field": "programming_language",
      "rule": "Preserve requested language in final deliverable unless source text requires bilingual output."
    },
    {
      "field": "language",
      "rule": "Preserve requested language in final deliverable unless source text requires bilingual output."
    }
  ],
  "scorecards": [
    "Correctness",
    "Security risk",
    "Maintainability",
    "Test coverage",
    "Deployment readiness"
  ],
  "automation_hooks": [
    {
      "name": "save_job_snapshot",
      "type": "internal",
      "description": "Persist inputs, customization, uploads, output, and usage for audit/history."
    },
    {
      "name": "export_pack",
      "type": "internal",
      "description": "Export Markdown, JSON, PDF, and DOCX from the completed job."
    },
    {
      "name": "human_review_queue",
      "type": "manual",
      "description": "Flag low-confidence, legal/medical/finance/security/compliance-sensitive items for human review."
    }
  ],
  "ux_profile": {
    "name": "Developer Workbench",
    "accent": "#60a5fa",
    "layout": "Code/schema/log intake → analysis → diff/tests/docs → implementation checklist",
    "hero": "Engineering-grade UX with code-aware intake, API/schema panels, test results, diffs, and implementation outputs.",
    "components": [
      "Code/source panel",
      "File tree summary",
      "Diff and patch viewer",
      "Test/result board",
      "API/schema preview"
    ],
    "metrics": [
      "Coverage readiness",
      "Risk/bug count",
      "Implementation clarity",
      "Docs completeness"
    ],
    "quick_actions": [
      "Analyze source",
      "Generate patch/checklist",
      "Create tests",
      "Build docs/schema output"
    ],
    "review_lanes": [
      "Inspect",
      "Analyze",
      "Patch",
      "Test",
      "Ship"
    ],
    "empty_state": "Paste code, schema, logs, or upload source files. Real repository actions require Git/CI connectors.",
    "icon": "</>",
    "project_slug": "code-tutor-api",
    "domain": "Education / Coding"
  },
  "final_gui_status": {
    "standalone_folder_gui": true,
    "domain_specific_ux_profile": true,
    "elegant_component_system": true,
    "no_fake_live_data_policy": true,
    "requires_real_connectors_for_external_actions": true
  }
}