Generate or update documentation for the AI Hero API by reading the source code at ~/repos/ai/course-builder. Use when user wants to document, update docs for, or understand the AI Hero API endpoints.
The English summary is being prepared. Showing the original description.
See how to installReview the instructions the agent will receive before you install.
Generate/update API documentation by reading the AI Hero source code.
Before reading the AI Hero source, update .claude/settings.local.json to include read permission for the course-builder repo. Add this entry to the permissions.allow array if not already present:
"Read(/home/mattpocock/repos/ai/course-builder/**)"
Read the AI Hero API source at ~/repos/ai/course-builder/apps/ai-hero/src/. Focus on:
src/app/api/ — each folder is a route segment. Read every route.ts file.src/trpc/api/routers/ — each file is a typed RPC router.src/db/schema.ts — table definitions and relationships.src/app/api/auth/ and any middleware files for auth patterns.Check how endpoints are consumed in this codebase:
app/services/ai-hero-auth-service.ts — OAuth device flowapp/services/ai-hero-upload-service.ts — Upload & post creationapp/features/upload-manager/ — SSE client for progressFlag any endpoints used here that have changed in the source.
Output to docs/ai-hero-api.md in this repo. Follow the structure in TEMPLATE.md.
After updating, print a short summary of:
No reviews yet. Tell others what you thought.
No login needed. Share how it worked for you, ask a question, or note where it did not run.
No comments yet. Be the first to write one.
Ship a Drizzle schema change end to end — generate the migration, merge, hand Matt the migrate command, redeploy apps/remote, confirm it is green. Use whenever a change adds or edits a file under packages/core/db/migrations/ or changes packages/core/db/schema.ts, or when an apps/remote deploy failed with "production has not applied".
The English summary is being prepared. Showing the original description.
End-to-end implementation workflow. Use when user wants to implement a feature, fix a bug, or make changes and have everything validated and committed.
The English summary is being prepared. Showing the original description.
Survey the codebase, pick ONE high-leverage deepening opportunity (filtering out anything already proposed), and publish it as a PRD-shaped GitHub issue via /to-prd-project. Designed to run unattended in the daily architecture-review workflow.
The English summary is being prepared. Showing the original description.
Install @effect/* packages safely. Use whenever adding a new Effect ecosystem dependency.
The English summary is being prepared. Showing the original description.
Optimize slow React Router loaders by eliminating redundant DB queries, creating slim query variants, and parallelizing independent fetches. Use proactively when writing or reviewing loader code that calls domain operations services (e.g. CourseOperationsService, VideoOperationsService), or when triaging a slow page load.
The English summary is being prepared. Showing the original description.
Break a PRD into native GitHub sub-issues attached to the parent PRD. Project-local variant of /to-issues, adapted for this repo's PRD-as-parent + native sub-issues + agent:implement multi-session workflow. Argument is the parent PRD issue number.
The English summary is being prepared. Showing the original description.