// 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.
| name | document-ai-hero-api |
| description | 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. |
| disable-model-invocation | true |
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:
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 DBFunctionsService, or when triaging a slow page load.
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.
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.
Turn the current conversation context into a PRD and publish it as a GitHub issue that is ready to receive sub-issues from /to-issues-project. Project-local variant of /to-prd, adapted for this repo's PRD-as-parent-issue + sub-issues + agent:implement workflow.
Install @effect/* packages safely. Use whenever adding a new Effect ecosystem dependency.
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.