Reference documentation for the medical residency program administration domain. These documents capture domain knowledge essential for product development, serving as shared context for both humans and LLMs when writing specs, designing features, and making implementation decisions.
| Document | Description |
|---|---|
| call-scheduling-reference.md | Comprehensive guide to call scheduling - terminology, ACGME duty hour rules, scheduling concepts, user workflows, and common edge cases |
| jeopardy-systems.md | Deep dive into jeopardy (backup coverage) systems - activation workflows, common models, eligibility rules, ACGME constraints, best practices, and specialty variations |
These references help answer domain questions like: - What roles exist in a residency program? - What does “Q3 call” mean? - What are the ACGME duty hour limits? - How does jeopardy activation work in practice? - What workflows do coordinators and chief residents follow?
Update these documents as we learn new domain knowledge from: - User research and interviews - Competitive analysis - Industry documentation - Implementation discoveries
Keep documents factual and descriptive rather than prescriptive about our product. These describe the domain, not our solution.