Student Profile Product System ยท Companion Document 13

AI Prompt Orchestration and System Architecture Guide

The multi-step prompt architecture and system design for generating reliable, evidence-grounded student profiles.
Document TypeCompanion Guide
Version1.0
DateMay 2026

Architecture Goal

The system should not rely on a single prompt that reads raw answers and writes a profile. It should use staged orchestration: intake normalization, signal extraction, evidence validation, contradiction review, and final profile generation.

Pipeline Overview

StepFunctionOutput
1. Intake ParserConvert raw intake into structured facts.Student context object.
2. Signal ExtractorIdentify candidate signals across domains.Signal map.
3. Evidence ClassifierClassify support strength for each signal.Evidence map.
4. Contradiction DetectorFind tensions, missing context, and overreach risk.Contradiction map.
5. Career Direction MapperMap supported signals to role/environment hypotheses.Career signal set.
6. Profile GeneratorWrite final student-facing profile.Full profile draft.
7. QA ValidatorCheck completeness, tone, evidence, and unsupported claims.Validation report.
8. Export FormatterGenerate HTML, PDF-ready, and Markdown outputs.Deliverables.

Prompt Roles

Prompt RoleInstruction Focus
ExtractorDo not write polished prose. Extract signals only.
ValidatorChallenge unsupported claims and separate evidence from inference.
Profile WriterWrite student-facing language using only approved claims.
Career TranslatorConvert profile insights into interviews, LinkedIn, and applications.
Safety ReviewerDetect sensitive disclosures and unsafe framing.
FormatterConvert content into target format without condensation.

System Rules

  • Never condense source content during format conversion unless explicitly instructed.
  • Every major claim requires support or inference labeling.
  • Do not diagnose.
  • Do not present career recommendations as certainty.
  • Preserve contradictions and unknowns.
  • Use consistent section schema across profiles.
  • Version prompts and outputs for reproducibility.

Example Orchestration Prompt

You are the Signal Extractor. Your task is not to write the final profile. Extract only evidence-grounded signals from the student interview. For each signal provide: signal name, evidence summary, evidence type, confidence, possible contradiction, and risk of overinterpretation. If evidence is missing, write Not shown.

Failure Modes

FailurePrevention
Generic profileRequire evidence-backed signals before writing.
Overconfident career claimsUse confidence labels and directional language.
Lossy HTML conversionUse format-only conversion rules and source-length checks.
Therapy-like languageUse professional/career framing only.
Output driftUse schema, validation, and versioned prompts.