How abdulla6h77/ed-agent works
Ed Agent is a Next.js education app for lesson planning, question generation, Socratic tutoring, and a separate homework-grading demo. In the main workflow, a teacher or student uses the web UI to submit a request; an API route optionally looks up curriculum material, calls the AI gateway, and returns a result. The grading slice is a separate TrueForge workflow using rubric retrieval, sandbox checks, and human-approved grade recording. Grading execution links are based on README documentation; the browser grading page is explicitly static.
Main entry points: index.js Learning interface · agent.json TrueForge grading agent · claude.js Provider selection and JSON parsing · lesson-plan.js Lesson planner
Components 18
Learning Tools
- Learning interface
pages/index.js - Lesson planner
pages/api/lesson-plan.js - Question generator
pages/api/questions.js - Socratic tutor
pages/api/tutor.js
Curriculum Grounding
- Curriculum lookup
lib/curriculum.js - Curriculum data
data/curriculum.json
AI Gateway
- Provider selection and JSON parsing
lib/claude.js
Homework Grading
- Grading overview page
pages/grading-agent.js - TrueForge grading agent
grading-agent/agent.json - Rubric MCP server
grading-agent/mcp-server.mjs - Rubric data
grading-agent/rubrics.json - Finalized grade records
grading-agent/mcp-server.mjs
Other components
- Teacher or student
- Anthropic API
- Google Gemini API
- Code sandbox
- Human approval
- TrueForge harness
Connections 20
- Teacher or student → Learning interface: uses
README.md - Learning interface → Lesson planner: submits lesson request
README.md - Learning interface → Question generator: submits question request
README.md - Learning interface → Socratic tutor: sends messages
pages/index.js - Lesson planner → Curriculum lookup: looks up topic
pages/api/lesson-plan.js - Question generator → Curriculum lookup: looks up topic
pages/api/questions.js - Curriculum lookup → Curriculum data: reads
lib/curriculum.js - Lesson planner → Provider selection and JSON parsing: requests lesson plan
pages/api/lesson-plan.js - Question generator → Provider selection and JSON parsing: requests questions
pages/api/questions.js - Socratic tutor → Provider selection and JSON parsing: requests tutor reply
pages/api/tutor.js - Provider selection and JSON parsing → Anthropic API: calls when configured
lib/claude.js - Provider selection and JSON parsing → Google Gemini API: fallback call
lib/claude.js - Learning interface → Grading overview page: links to
pages/index.js - Teacher or student → TrueForge grading agent: provides answer
README.md - TrueForge grading agent → TrueForge harness: runs under
README.md - TrueForge grading agent → Rubric MCP server: calls rubric tools
README.md - TrueForge grading agent → Code sandbox: checks calculations
README.md - Rubric MCP server → Rubric data: reads rubric data
grading-agent/mcp-server.mjs - TrueForge grading agent → Human approval: requests grade approval
README.md - Rubric MCP server → Finalized grade records: appends approved grade
grading-agent/mcp-server.mjs