PMDC NRE-I System Pipeline

This document maps how the system components connect as a closed-loop exam preparation machine. Read this alongside AGENTS.md (behavioral instructions) and SYSTEM_MAP.md (folder inventory).

Core Architecture: Three Coupled Engines

┌─────────────────────────────────────────────────────────────────┐
│                   1. KNOWLEDGE PIPELINE                          │
│  Syllabus ──► Exam Intel ──► Content (MedCORE / Cheatsheets)    │
└───────────────────────────┬─────────────────────────────────────┘
                            │ feeds
                            ▼
┌─────────────────────────────────────────────────────────────────┐
│                   2. PRACTICE ENGINE                              │
│  QBank / NRE50 ──► MCQ Drills ──► Error Log                     │
└───────────────────────────┬─────────────────────────────────────┘
                            │ drives
                            ▼
┌─────────────────────────────────────────────────────────────────┐
│                   3. PLANNING LOOP                                │
│  Weak Areas ──► Study Plan ──► Daily Execution ──► Back to 1    │
└─────────────────────────────────────────────────────────────────┘

Pipeline: Data Flow by Layer

L0 — Raw Input (Source of Truth)

Component	Path	Role
Official Syllabus	Syllabus/	Topic boundaries, weightage, scope
Past Papers	Past Papers/	Real recalled exams (Tier-1 evidence)
Exam Intel	Exam Intel/	Intelligence reports, predictions, NRE50 methodology

L1 — Interpretation Layer

Component	Path	Role
Intelligence Reports	Exam Intel/Intelligence Reports/	Confirmed topic patterns from recalls
NRE50 System	Exam Intel/NRE50 System/	Rotation map, manifesto, methodology
Predictions	Exam Intel/Predictions/	Predicted high-yield topics

L2 — Content Generation

Component	Path	Role
MedCORE Systems (canonical)	MedCORE Systems/	Subject-wise distilled notes (source)
MedCORE Production (outputs)	MedCORE Production/	Source JSON (lessons, MCQ sets, premium), rendered DOCX, compilations, master HTML, QA audit, scripts
Cheatsheets	Cheatsheets/	Compact high-yield subject review sheets
NRE Essentials	NRE Essentials/	Last-day compression, one-liners
Quick References	Quick References/	HTML/PDF visual references

L3 — Practice & Assessment

Component	Path	Role
QBank / Mocks	QBank/	PMDC mocks, NRE50 quizzes, separated subject banks, USMLE support
Case Ladder Add-On	Case Ladder MCQ Add On/	Visual case-ladder MCQs (separate tool, not core pipeline)
NRE50 Rotation	Exam Intel/NRE50 System/	4-quiz cycle = 200 MCQs, proportional weightage

L4 — Error & Feedback Layer

Component	Path	Role
Error Log	Error Log/	Every wrong/guessed question → discriminator + trap + alert
MCQ Breakdown Protocol	System/Protocols/MCQ Breakdown Protocol.docx	Standard analysis template

L5 — Planning & Execution

Component	Path	Role
Planner	Planner/	Study plans (HTML), daily DOCX references
OpenCode Days	OpenCode/Days/	Generated daily DOCX sheets
Planner Scripts	Planner/Scripts/	Day DOCX generators (JS, Python)

L6 — Tooling & Templates

Component	Path	Role
Templates	System/Templates/	MedCORE_Template.docx (protected)
SOPs	System/SOPs/	Hybrid SOP for teaching output structure
Protocols	System/Protocols/	MCQ breakdown protocol, teaching philosophy
Scripts	Scripts/	Booklet imposer, MedCORE prompt generator

Operational Cycles

Daily Cycle (execution)

Plan → Topic study → MCQ drill (NRE50 or focused) → Error log → Next day

Weekly Cycle (review)

Review error log → Identify weak topics → Targeted MCQ → Mock/review session

NRE50 Cycle (4 sessions = 200 MCQs)

Q1 (53 MCQs) → Review errors → Q2 (47 MCQs) → Review errors →
Q3 (53 MCQs) → Review errors → Q4 (47 MCQs) → Review errors →
Full cycle performance summary → Update study priorities

Component Dependency Graph

Syllabus/
  ├──► Exam Intel/         (what the exam actually tests)
  │     ├──► QBank/        (MCQ creation aligned to real patterns)
  │     ├──► MedCORE Systems/  (notes aligned to patterns)
  │     └──► Planner/      (plans prioritize high-yield/weak areas)
  │
  ├──► Past Papers/        (Tier-1 evidence, overrides generic banks)
  │     └──► Error Log/    (capture missed patterns from recalls)
  │
  ├──► QBank/              (MCQ practice → Error Log)
  │     └──► Error Log/    (wrong answers → revise → Planner)
  │
  ├──► Error Log/          (drives Planner updates)
  │     └──► Planner/      (next cycle adapts to weak areas)
  │
  └──► MedCORE/ + Cheatsheets/ (reference during revision)

File Modification Rules

Action	Permission
Read/sample any file	Always allowed
Create new derivative files (maps, indexes, summaries, logs)	Allowed without permission
Create new logs in Error Log/	Allowed (confirm destination if none exists)
Modify AGENTS.md, SYSTEM_MAP.md, SYSTEM_PIPELINE.md	Allowed (system documentation)
Modify Syllabus/, Past Papers/, Exam Intel/, QBank/	NOT allowed without explicit permission
Modify System/SOPs/, System/Protocols/, System/Templates/	NOT allowed without permission
Modify Scripts/ generators	NOT allowed without permission
Overwrite existing Planner/References/*.docx	NOT allowed without permission
Overwrite existing MedCORE/**/*.docx, *.pdf, .pages	NOT allowed without permission
Generate new DOCX sheets	Only when explicitly requested
Move/delete/rename any existing study file	NOT allowed (Prime Directive)

Quick Reference: What to Consult for Common Tasks

If asked to…	Read first
Teach a topic	Syllabus + Exam Intel + Past Papers (if available)
Generate MCQs	QBank (existing style) + Syllabus (topic scope) + Exam Intel (pattern)
Make a study plan	Planner/Plan/ + Error Log + NRE50 performance
Create a MedCORE sheet	MedCORE_Template.docx + SOP + relevant subject in MedCORE Systems/
Review a wrong answer	MCQ Breakdown Protocol + Error Log template
Do NRE50 practice	Rotation Master Map + NRE50 methodology
Generate DOCX	Scripts/ + Planner/Scripts/ + existing template