skills/medical-blueprint-builder/references/blueprint-patterns.md

# Blueprint Patterns

Choose one primary pattern. Add another only when it materially improves the user's task.

## 1. Disease / topic blueprint
Best for a named disease or condition.

Recommended flow:
- learner and context
- core clinical questions
- recognition / presentation
- mechanism that changes interpretation or management
- diagnostic reasoning and prioritized differential
- decisive investigations
- severity / risk stratification
- management decisions
- complications and treatment failure
- reassessment and escalation
- must-not-miss competencies
- teaching and assessment alignment when requested

## 2. Syndrome / presentation blueprint
Best for symptoms or presentations such as GI bleeding, jaundice, abdominal pain, shock, or prolonged diarrhea.

Recommended flow:
- stable vs unstable
- problem representation
- dangerous alternatives first
- high-yield discriminating features
- prioritized differential
- investigation strategy by clinical question
- initial decision / disposition
- treatment and escalation
- reassessment

## 3. Course / curriculum blueprint
Best for a module, course, longitudinal curriculum, or set of lectures.

Recommended flow:
- learner and needs
- overall goal
- 3–6 integrated CLOs when appropriate
- domain map
- priority map
- competency / LO matrix
- learning sequence
- teaching-learning methods
- assessment strategy
- feedback and reassessment
- constructive alignment check
- feasibility check

## 4. Rotation blueprint
Best for clinical placements.

Build around:
- common presentations
- high-risk emergencies
- core decisions
- interpretation skills
- procedures
- communication tasks
- follow-up / reassessment
- expected participation or supervision level
- workplace assessment

Do not require mastery of a rare procedure when the rotation cannot reliably provide exposure.

## 5. Exam blueprint / Table of Specifications
Best for MCQ, SBA, OSCE, residency, board, or course examinations.

Use `assessment-and-tos.md`.

Core structure:
- exam purpose and learner level
- assessed outcomes
- content domains
- clinical-task distribution
- cognitive distribution
- proposed weighting
- item / station formats
- Table of Specifications
- must-not-miss safety content
- quality checks

## 6. Competency blueprint
Best when the user wants an observable professional capability.

Use:
**Learner should be able to + observable action + clinical context + expected standard or safety condition.**

Map:
- required knowledge
- interpretation / reasoning
- decision
- performance
- communication / teamwork if relevant
- evidence of competence
- feedback / remediation / reassessment

## 7. Document-derived blueprint
Best for an uploaded guideline, lecture, textbook chapter, syllabus, protocol, or article.

Start with:
- source scope
- intended learner
- source-derived priorities
- clinical decisions supported by the source
- competencies and assessment implications
- limitations / gaps

Never imply the source contains information that is actually external.

## 8. High-yield blueprint
Best for rapid teaching, revision, or a one-page framework.

Keep only:
- core recognition
- must-not-miss
- decisive investigations
- high-impact management decisions
- reassessment / failure / escalation

## 9. Deep / advanced blueprint
Best for senior trainees, subspecialists, or faculty.

Add selectively:
- uncertainty and atypical cases
- edge cases
- competing recommendations
- management trade-offs
- cognitive biases
- evidence limitations
- treatment failure and escalation
- controversies that change decisions

Do not increase complexity merely to appear advanced.