Review Resume

Engineering Reasoning Graph Visibility

이력서의 모든 기술 서술은 면접에서 대화를 시작시켜야 한다. 대화를 종료시키면 실패다.

CTO가 이력서를 읽고 "그래서?" 하는 순간, 그 불렛은 죽는다. CTO가 "어떻게?", "왜?", "만약에?"를 물으면 — 그때 불렛이 산다.

이 차이를 만드는 것은 엔지니어링 사고 그래프가 보이는가이다:

세 가지가 모두 보이면 CTO는 사고 과정을 재구성할 수 있고, 재구성할 수 있으면 더 깊은 질문을 하고, 더 깊은 질문이 이어지면 채용으로 간다.

Constraint Cascade

"A를 해결하니 B가 드러났고, B를 해결하면서 C도 함께 풀었다" — 이 연쇄 구조가 보이는 서술이 강력하다.

구체적 평가 기준은 references/experience-mining.md § Cascade Extraction에 정의되어 있다.

Impact Breadth

단일 차원 성과는 한 문장으로 끝난다. 다차원 성과(기술+비즈니스+운영)는 각 차원이 별도 면접 질문을 유발한다.

P.A.R. Terminology Glossary

Resume section headers used in writing templates and evaluation. All references across documents MUST use these exact English terms. Korean equivalents are provided for user-facing output.

Persistent Note System

Resume reviews are not one-off events. Across conversations, user experiences, preferences, and expression choices accumulate. To swap candidates for a JD, you need a candidate pool beyond "the 4 currently in the resume." This note system provides cross-session persistence.

Directory: $OMT_DIR/review-resume/ — subdirs: self-introduction/, career/, problem-solving/, study/, preferences.md, sources/.

Maintain 2-3x more candidates in the pool than what's actually used in the resume. This enables JD-specific combination swaps.

Reference: Read references/note-system.md for full file format (frontmatter schema), auto-seeding logic, and accumulation rules.

Evaluation Protocol

Every resume review follows this sequence. No step is optional.

flowchart TB
    NOTE["섹션별 리뷰에서도 Phase 1, 2, 9, 10은 필수"]
    style NOTE fill:#fff3cd,stroke:#856404,color:#856404
    NOTE -.-> P_ID
    P_ID[Phase 1: Identity Confirmation\nRead owner from preferences.md] --> ID_CHK{owner\nconfirmed?}
    ID_CHK -->|"YES: interview-possible"| P0[Phase 2: 사전 준비\nNote Load + Pre-Evaluation Research]
    ID_CHK -->|"NO: interview-impossible"| P0
    P0 --> P1[Phase 3: 자기소개 평가\nper-type + global + Type C sub-step]
    P1 --> P2[Phase 4: 개발자 역량 평가\nC1-C5 Competency]
    P2 --> P3[Phase 5: 섹션별 평가\nCareer + Problem-Solving 6 criteria\n+ Pushback Simulation]
    P3 --> P4[Phase 6: First-Page + JD 매칭\nFirst-Page Primacy + JD Keyword Matching]
    P4 --> P5CHK[Phase 7a: Mandatory Checklist\nverbose split · retrospective · portfolio diversity · 5줄 minimum]
    P5CHK --> P5[Phase 7b: P.A.R. + T1-T3 + Constraint Cascade]
    P5 --> P6[Phase 8: AI 톤 감사\nSkill humanizer audit mode]
    P6 --> P7DISPATCH[Phase 9: Content Quality Gate\nexaminer dispatch]
    P7DISPATCH --> P7VERDICT{All APPROVE\nor user opt-out?}
    P7VERDICT -->|"NO: REQUEST_CHANGES"| P7INTERVIEW[Per-item feedback\nexplain FAIL axes → interview\n→ regenerate alternatives]
    P7INTERVIEW --> P7DISPATCH
    P7VERDICT -->|YES| P7OPT[Strategic Options\n2-3 with trade-offs]
    P7OPT --> P8[Phase 10: 결과 전달\nHTML Report + Note Accumulate]

    P1 -->|"Interview trigger\n[interview-possible only]"| IG1[Read references/experience-mining.md\n§ Self-Introduction]
    P2 -->|"Interview trigger\n[interview-possible only]"| IG2[Read references/experience-mining.md\n§ C1-C5 Competency]
    P3 -->|"Interview trigger\n[interview-possible only]"| IG3[Read references/experience-mining.md\n§ Section-Specific Evaluation]
    P4 -->|"Interview trigger\n[interview-possible only]"| IG4[Read references/experience-mining.md\n§ JD Keyword Matching]
    P5 -->|"Interview trigger\n[interview-possible only]"| IG5[Read references/experience-mining.md\n§ Problem-Solving]

Interview triggers: Read references/experience-mining.md for the full 4-stage bypass protocol and Discovered Candidates Working Set management.

Workflow Progress Tracking

The Evaluation Protocol defines 10 phases. Resume reviews involve extensive back-and-forth. Without explicit tracking, later phases are routinely skipped.

Phase Map

Recognized Opt-Out Keywords

The following keywords are recognized as opt-out signals across all Phases. Use this canonical set everywhere:

When any of these is detected, end the current interview/loop and proceed to the next phase or fallback guidance.

Interview-Impossible Mode

When Phase 1 sets mode to interview-impossible (user is not the resume owner), interview loops are suppressed for the entire session. Evaluation and examiner dispatch proceed unchanged. The table below specifies exact behavior per phase.

Mode is locked for the session. It cannot be changed after Phase 1 completes.

Tracking Rules

0. Execute ALL 10 phases sequentially without skipping. No exceptions.
1. After completing each phase, internally record phase completion. Phase completion markers ([Phase N/10: OOO ✓]) are shown to the user as minimal progress indicators. Detailed analysis (criteria evaluation, pushback simulation, alternative generation, examiner exchange) is processed internally and not output to the terminal.
2. Before starting a new phase, verify the previous phase was completed internally. If a phase was skipped, complete it first.
3. When user interaction interrupts the flow (e.g., extended discussion during Phase 3), resume from the next incomplete phase after the interaction concludes. Re-read this Phase Map to locate your position.
4. Phase 9 (Per-Bullet Content Quality Gate) loops per section unit until tech-claim-examiner APPROVE or user opt-out.
5. Phase 10 generates an HTML report file and opens it in the browser. After the user reviews the report, they may approve or request revisions. Note Accumulate proceeds ONLY after approval.
6. Note Accumulate proceeds only after the user has reviewed and approved the HTML report. Do not prompt for note saving before approval.

Output Visibility

Not all processing output belongs in the terminal. The following categories define what is shown to the user and what is handled internally.

Shown to user:

• Phase completion markers ([Phase N/10: OOO ✓])
• Interview questions (AskUserQuestion interactions)
• User-choice prompts (strategic options, alternative selection, approval gates)
• Feedback summaries that require a user response

Processed internally (not output to terminal):

• Criteria evaluation breakdown (6-criteria analysis per career/problem-solving line)
• Pushback simulation details (L1/L2/L3 reasoning)
• Alternative generation process (draft alternatives before dispatch)
• Examiner dispatch and response details (E1-E6 axis scoring, Constraint Cascade Score sub-dimensions)
• Competency assessment reasoning (C1-C5 axis rating evidence)

When generating user-facing output (HTML report), translate all evaluation criteria and examiner axis labels to the user's language. Do not use bare English criteria names or internal codes in user-facing output.

Mandatory: Phase Task Creation

Before starting Phase 1, you MUST create all 10 phases as individual tasks. Mark each task as in_progress when starting and completed when done. This prevents phase skipping.

Phase 1: Identity Confirmation

Determine whether the user is the resume owner. This result locks the session mode for all subsequent phases.

Step 1 — Check preferences.md for owner field:

Read ONLY the owner field from $OMT_DIR/review-resume/preferences.md. Do NOT perform a full Note Load here (that is Phase 2). If preferences.md does not exist or does not contain an owner field, treat as unknown.

Step 2 — Three-case logic:

Step 3 — Lock session mode based on user response:

• If the user confirms they can answer in-depth questions about the resume's experiences and decisions → set mode: interview-possible. All interview loops are active.
• If the user confirms they cannot answer such questions → set mode: interview-impossible. All interview loops are suppressed for this session. Announce to user:

  [Identity Confirmed: interview-impossible mode]
  이력서 소유자가 아닌 것으로 확인되었습니다. 인터뷰 루프는 생략되며, 평가 및 대안 생성은 이력서 내용만으로 진행됩니다.
  

[Phase 1/10: Identity Confirmation ✓]

Phase 2: 사전 준비

Load persistent note, then perform pre-evaluation research before any evaluation begins.

Note Load:

1. Check if $OMT_DIR/review-resume/ exists
2. If empty or missing → execute Auto-Seeding (parse current resume into initial candidate files)
3. If exists → scan file lists from all candidate directories, load preferences.md, check sources/ cache

Report note status to user:

[Note Loaded]
- Self-introduction candidates: N
- Career candidates: N
- Problem-solving candidates: N
- User preferences: loaded / not found
- Research cache: {company} found / none

Pre-Evaluation Research:

• If JD is provided as a URL → fetch page content via WebFetch or Playwright MCP before analysis
• JD Analysis: extract team, keywords, implicit problems, and what is NOT in the JD
• Company Research: core values, tech blog, product/service, career page, recent news

Research results feed into ALL paragraph type selections (A, B, C, D). Check sources/ cache before doing fresh research.

References: Read references/note-system.md for auto-seeding procedure and file format. Read references/pre-evaluation-research.md for full research protocol.

[Phase 2/10: 사전 준비 ✓]

Phase 3: 자기소개 평가

The self-introduction answers: "What kind of engineer is this person?" Each paragraph must reveal a different facet of this answer.

Evaluate each paragraph against type-specific criteria, then perform global evaluation (count, independence, first sentence, original framing). When more than half of paragraphs FAIL, trigger writing guidance.

Type C sub-step: If the user hasn't stated the target position/company, ASK and HALT (Absolute Rule 1). After receiving the target: run Type C conditional evaluation, then recheck writing guidance trigger.

Experience Mining Interview: Any type FAIL → Read references/experience-mining.md § Self-Introduction and conduct the interview.

Reference: Read references/self-introduction.md for full type-specific PASS/FAIL examples, composition guide, writing validation checklist, post-evaluation action patterns, and Type C conditional logic.

[Phase 3/10: 자기소개 평가 ✓]

Phase 4: 개발자 역량 평가 (C1-C5)

Holistically assess the ENTIRE resume against 5 core competency axes. This answers: not "is this well-written?" but "does this resume demonstrate a competent developer?"

Rate each axis as STRONG / PRESENT / WEAK / ABSENT with evidence citations. All axes are always evaluated — no N/A exceptions based on career level.

Experience Mining Interview: Any axis WEAK or ABSENT → Read references/experience-mining.md § C1-C5 Competency and conduct the interview.

Reference: Read references/competency-assessment.md for full checklists, evidence examples, and career-level expectations (Junior/Senior 2-tier).

[Phase 4/10: 개발자 역량 평가 ✓]

Phase 5: 섹션별 평가

Career and problem-solving sections answer fundamentally different questions:

• Career: "What did this person achieve?" — direction and impact. Career bullets are interview hooks.
• Problem-Solving: "How does this person approach problems?" — thought process and depth. Entries are engineering thinking proof.

Career Dimensions

Problem-Solving Dimensions

After 6-criteria evaluation, run Pushback Simulation on EVERY line including PASS lines:

If the user cannot answer all 3 levels, that line will hurt more than help.

Experience Mining Interview: Career or Problem-Solving any criterion FAIL → Read references/experience-mining.md § Section-Specific Evaluation and conduct the interview.

Reference: Read references/section-evaluation.md for full PASS/FAIL examples, output format, section fitness rules, 3-Level Pushback Simulation protocol, and writing guidance triggers.

[Phase 5/10: 섹션별 평가 ✓]

Phase 6: First-Page Primacy + JD 매칭

Check that the strongest content is on page 1 (the 7.4-second scan zone). If a JD is provided, perform keyword matching with ATS pass-rate estimation.

Experience Mining Interview: JD provided AND 3+ keywords missing AND no note candidates for those keywords → Read references/experience-mining.md § JD Keyword Matching and conduct the interview.

Reference: Read references/section-evaluation.md § "Section Fitness Rules" for first-page primacy rules and JD keyword matching output format.

[Phase 6/10: First-Page Primacy + JD 매칭 ✓]

Phase 7: 문제해결 심화평가

All problem-solving entries (5+ lines) are evaluated under a unified framework combining P.A.R. narrative evaluation, T1-T3 Technical Substance Verification, and Cascade Extraction. Dimension applicability (which P-dimensions apply per entry type and career level) is defined in references/problem-solving.md §4.

P.A.R. Evaluation: Base dimensions (P1-P2, P4) apply to all 5+ line entries. P3 is kick-only. P5-P7 apply to Senior entries only. T1-T3 verify technical coherence, choice rationality, and problem fidelity for all 5+ line entries.

Cascade Extraction: When problem-solving description is FLAT (concerns are independent or lack causal links), run the 4-question chain to extract the cascade structure the user experienced but didn't describe. For the full protocol: Read references/experience-mining.md § Cascade Extraction.

Note candidate pool: If $OMT_DIR/review-resume/problem-solving/ has candidates, suggest JD-optimal combinations from the full pool.

Experience Mining Interview: P.A.R. any dimension FAIL or structure absent → Read references/experience-mining.md § Problem-Solving and conduct the interview.

Reference: Read references/problem-solving.md — 먼저 Mandatory Evaluation Checklist를 실행, 그 다음 P.A.R. dimensions, T1-T3 verification, Before/After examples 순서로 평가.

[Phase 7/10: 문제해결 심화평가 ✓]

Phase 8: AI 톤 감사

MUST invoke the humanizer skill via the Skill tool. The humanizer has a catalog of 35+ specific patterns (K1-K16, E1-E17, C1-C6) with severity classification that manual scanning cannot replicate. Reading the text yourself and judging "this sounds fine" is NOT a substitute.

Invoke exactly: Skill(humanizer) — request audit mode on every text element:

• Self-Introduction (about_content)
• Career section bullet lines per company
• Problem-Solving section description per entry
• Tech/Study/Other sections

If AI tone patterns are detected: Include affected lines and suggested revision direction in the evaluation results. If no AI tone patterns are detected: Skip this section in the output.

[Phase 8/10: AI 톤 감사 ✓]

Phase 9: Per-Bullet Content Quality Gate

While the Evaluation Phase diagnosed "what the problems are," Phase 9 verifies "have the problems been sufficiently resolved." Each resume section is broken into individual units, and the fix-interview-evaluate loop repeats until the tech-claim-examiner sub-agent issues APPROVE.

Core Contract

• Loop until APPROVE per item. The only exit is user opt-out.
• Dispatch format: Read references/content-quality-gate.md for full protocol.

REQUEST_CHANGES Handling Protocol

interview-possible mode:

1. Explain each FAIL axis and its rationale to the user, item by item
2. Convert Interview Hints into specific questions → conduct interview via AskUserQuestion
   • One question per message
   • Apply 4-Stage Bypass Protocol (references/experience-mining.md)
3. Source confirmed → regenerate 2-3 alternatives → re-dispatch to examiner
4. Source unconfirmed (all 4 Stages exhausted) → generate best revision with current sources → confirm user opt-out
5. Repeat until APPROVE or user opt-out

interview-impossible mode:

1. Explain each FAIL axis and its rationale to the user, item by item
2. Skip Interview Hints → question conversion entirely. Do NOT conduct interview.
3. Generate 2-3 alternatives using only the existing resume content and evaluation findings
4. Re-dispatch alternatives to examiner
5. If examiner returns APPROVE → proceed
6. If examiner returns REQUEST_CHANGES again → generate best revision with current content → opt-out with note: "소유자 인터뷰 필요 — 추가 정보 없이 개선 한계에 도달했습니다"
7. Repeat until APPROVE or opt-out

NEVER enter Phase 10 while ANY item remains in REQUEST_CHANGES status. Phase 10 entry is permitted ONLY when ALL Verdict Tracker items are APPROVE or opt-out. </critical>

Examiner Eligibility

Items containing a technical claim or problem-solving process → eligible. No exceptions.

Dispatch Format

When sending to tech-claim-examiner, use exactly:

# Technical Evaluation Request

## Candidate Profile
- Experience: {years} years
- Position: {position}
- Target Company/Role: {company} / {role}

## Bullet Under Review
- Section: {Career > Company A | Problem-Solving > Entry Title | Self-Introduction Type C}
- Original: "{original text that was the subject of Evaluation Phase findings}"

## Technical Context
- Technologies/approaches mentioned in this bullet: {identified directly from bullet text}
- JD-related keywords: {relevant JD keywords obtained in Phase 2}
- Evaluation Phase findings: {verbatim P0/P1/P2 findings for this bullet}

## Target Company Context (if available)
- Company: {company name}
- Scale indicators: {TPS, DAU, data volume, etc.}
- Engineering team size: {if identified}
- Core values / engineering principles: {researched in Phase 2}
- Key technical challenges: {from JD analysis and tech blog}
- If unavailable: "No specific target — evaluate against big tech standards"

## Proposed Alternatives (2-3)
{alternatives generated per content-quality-gate.md §3 protocol}

Reference: Read references/content-quality-gate.md for full Quality Gate loop, Pre-Examiner Interview Protocol, Mandatory Verdict Tracker, alternative suggestion format, and whole-resume feedback loop.

Phase 9 Red Flags — STOP When You Think This

[Phase 9/10: Per-Bullet Content Quality Gate ✓]

Strategic Options

Before generating the HTML report, present 2-3 strategic improvement options to the user. Each option should describe:

• Direction (e.g., "JD 키워드 최적화", "depth 강화", "theme 다각화")
• Trade-off (time investment vs impact)
• Which findings it addresses

This is NOT optional — every review must end with actionable strategic options before the final report.

Discovered Candidates Working Set

Experiences discovered during interviews are added to the Working Set immediately. The Working Set is a session-scoped temporary store and is permanently saved to the note system in Phase 10.

For Working Set templates, lifecycle, and consumption rules, refer to references/experience-mining.md § "Discovered Candidates Working Set".

Phase 10: 결과 전달

HTML Report Generation

Compile all Evaluation Phase results and write a self-contained HTML file. This is the only phase that produces the final comprehensive evaluation report. Generate the file, open it, and wait for user approval.

Template: Read references/html-template.html for the HTML skeleton template.

File Path:

HTML_FILE="${OMT_DIR:-$HOME/.omt/global}/reports/review-YYYYMMDD-HHmmss.html"

• Run mkdir -p "$(dirname "$HTML_FILE")" before writing.
• After writing, run open "$HTML_FILE" via Bash tool.
• Terminal output: print file path only.

HTML Escaping: Before inserting resume text: & → &, < → <, > → >, " → ".

Priority Level Definitions:

Strength Comment: Per career bullet or problem-solving entry, only items that PASS all 6 section evaluation criteria get .comment-strength.

Approval Gate

After opening the report, use AskUserQuestion to collect feedback. Ambiguous responses → re-ask. Section-specific feedback → re-enter Phase 9 for that section. Apply feedback → regenerate HTML → loop until explicit "no feedback."

Note Accumulate

After user approval, accumulate insights into persistent note. Show accumulation summary (+ new, ~ updated, for all categories) and wait for y/n confirmation before writing files.

Accumulate: new candidates from interviews, updated expressions, tone/judgment preferences, company research cache.

Reference: Read references/note-system.md § "Note Accumulate" for full accumulation rules.

[Phase 10/10: 결과 전달 ✓]

Completion Checklist (Internal)

Before delivering Phase 10 output, verify every phase was completed or has a valid skip reason:

[Review Completion Checklist — INTERNAL]
- [ ] Phase 1: Identity Confirmation (session mode locked: interview-possible / interview-impossible)
- [ ] Phase 2: 사전 준비 (Note Load + Pre-Evaluation Research)
- [ ] Phase 3: 자기소개 평가 (per-type + global + Type C sub-step)
- [ ] Phase 3: Experience Mining Interview (DONE/SKIPPED-interview-impossible/N/A)
- [ ] Phase 4: 개발자 역량 평가 (C1-C5)
- [ ] Phase 4: Experience Mining Interview (DONE/SKIPPED-interview-impossible/N/A)
- [ ] Phase 5: 섹션별 평가 (Career + Problem-Solving 6 criteria + Pushback)
- [ ] Phase 5: Experience Mining Interview (DONE/SKIPPED-interview-impossible/N/A)
- [ ] Phase 6: First-Page Primacy + JD 매칭
- [ ] Phase 6: Experience Mining Interview (DONE/SKIPPED-interview-impossible/N/A)
- [ ] Phase 7: 문제해결 심화평가 (P.A.R. + T1-T3 + Constraint Cascade)
- [ ] Phase 7: Experience Mining Interview (DONE/SKIPPED-interview-impossible/N/A)
- [ ] Phase 8: AI 톤 감사 (MUST invoke Skill(humanizer) — manual scan ≠ DONE)
- [ ] Phase 9: Per-Bullet Content Quality Gate (tech-claim-examiner APPROVE or user opt-out per unit)
- [ ] Phase 10: HTML Report + User Approval Gate (infinite loop until feedback reaches 0)
- [ ] Phase 10: Note Accumulate (user confirmation required)

A phase is SKIPPED only when its precondition is not met. Phases 1, 2, 8, 9, 10 have NO precondition — always required. Note Accumulate has a strict precondition: User Approval in Phase 10 HTML gate. Note Accumulate counts as DONE even if the user declines to save.