# Resume as Code - Epic Breakdown

## Table of Contents

- [Resume as Code - Epic Breakdown](#table-of-contents)
  - [Overview](./overview.md)
  - [Requirements Inventory](./requirements-inventory.md)
    - [Functional Requirements](./requirements-inventory.md#functional-requirements)
    - [NonFunctional Requirements](./requirements-inventory.md#nonfunctional-requirements)
    - [Additional Requirements](./requirements-inventory.md#additional-requirements)
    - [FR Coverage Map](./requirements-inventory.md#fr-coverage-map)
  - [Epic List](./epic-list.md)
    - [Epic 1: Project Foundation & Developer Experience](./epic-list.md#epic-1-project-foundation-developer-experience)
    - [Epic 2: Work Unit Creation & Capture](./epic-list.md#epic-2-work-unit-creation-capture)
    - [Epic 3: Work Unit Validation & Discovery](./epic-list.md#epic-3-work-unit-validation-discovery)
    - [Epic 4: Resume Planning & Explainability](./epic-list.md#epic-4-resume-planning-explainability)
    - [Epic 5: Resume Generation & Output](./epic-list.md#epic-5-resume-generation-output)
  - [Epic 1: Project Foundation & Developer Experience](./epic-1-project-foundation-developer-experience.md)
    - [Story 1.1: Project Scaffolding & CLI Skeleton](./epic-1-project-foundation-developer-experience.md#story-11-project-scaffolding-cli-skeleton)
    - [Story 1.2: Rich Console & Output Formatting](./epic-1-project-foundation-developer-experience.md#story-12-rich-console-output-formatting)
    - [Story 1.3: Configuration Hierarchy](./epic-1-project-foundation-developer-experience.md#story-13-configuration-hierarchy)
    - [Story 1.4: Error Handling & Exit Codes](./epic-1-project-foundation-developer-experience.md#story-14-error-handling-exit-codes)
    - [Story 1.5: AI Agent Context Documentation (CLAUDE.md)](./epic-1-project-foundation-developer-experience.md#story-15-ai-agent-context-documentation-claudemd)
  - [Epic 2: Work Unit Creation & Capture](./epic-2-work-unit-creation-capture.md)
    - [Story 2.1: Work Unit Schema & Pydantic Model (Enabling Story)](./epic-2-work-unit-creation-capture.md#story-21-work-unit-schema-pydantic-model-enabling-story)
    - [Story 2.2: Archetype Templates](./epic-2-work-unit-creation-capture.md#story-22-archetype-templates)
    - [Story 2.3: Create Work Unit Command](./epic-2-work-unit-creation-capture.md#story-23-create-work-unit-command)
    - [Story 2.4: Quick Capture Mode](./epic-2-work-unit-creation-capture.md#story-24-quick-capture-mode)
    - [Story 2.5: Work Unit Metadata & Evidence](./epic-2-work-unit-creation-capture.md#story-25-work-unit-metadata-evidence)
  - [Epic 3: Work Unit Validation & Discovery](./epic-3-work-unit-validation-discovery.md)
    - [Story 3.1: Validate Command & Schema Validation](./epic-3-work-unit-validation-discovery.md#story-31-validate-command-schema-validation)
    - [Story 3.2: Actionable Validation Feedback](./epic-3-work-unit-validation-discovery.md#story-32-actionable-validation-feedback)
    - [Story 3.3: List Command & Filtering](./epic-3-work-unit-validation-discovery.md#story-33-list-command-filtering)
  - [Epic 4: Resume Planning & Explainability](./epic-4-resume-planning-explainability.md)
    - [Story 4.1: Job Description Parser](./epic-4-resume-planning-explainability.md#story-41-job-description-parser)
    - [Story 4.1.5: Embedding Service & Cache (Enabling Story) (Research-Validated 2026-01-10)](./epic-4-resume-planning-explainability.md#story-415-embedding-service-cache-enabling-story-research-validated-2026-01-10)
    - [Story 4.2: BM25 Ranking Engine](./epic-4-resume-planning-explainability.md#story-42-bm25-ranking-engine)
    - [Story 4.3: Plan Command & Selection Display](./epic-4-resume-planning-explainability.md#story-43-plan-command-selection-display)
    - [Story 4.4: Exclusion Reasoning](./epic-4-resume-planning-explainability.md#story-44-exclusion-reasoning)
    - [Story 4.5: Skill Coverage & Gap Analysis](./epic-4-resume-planning-explainability.md#story-45-skill-coverage-gap-analysis)
    - [Story 4.6: Plan Persistence](./epic-4-resume-planning-explainability.md#story-46-plan-persistence)
  - [Epic 5: Resume Generation & Output](./epic-5-resume-generation-output.md)
    - [Story 5.1: Resume Data Model & Template System](./epic-5-resume-generation-output.md#story-51-resume-data-model-template-system)
    - [Story 5.2: PDF Provider (WeasyPrint)](./epic-5-resume-generation-output.md#story-52-pdf-provider-weasyprint)
    - [Story 5.3: DOCX Provider (python-docx)](./epic-5-resume-generation-output.md#story-53-docx-provider-python-docx)
    - [Story 5.4: Build Command](./epic-5-resume-generation-output.md#story-54-build-command)
    - [Story 5.5: Manifest & Provenance](./epic-5-resume-generation-output.md#story-55-manifest-provenance)
    - [Story 5.6: Output Configuration](./epic-5-resume-generation-output.md#story-56-output-configuration)
  - [Epic 6: Executive Resume Template & Profile System](./epic-6-executive-resume-template-profile-system.md)
    - [Story 6.1: Profile Configuration & Contact Info Loading](./epic-6-executive-resume-template-profile-system.md#story-61-profile-configuration-contact-info-loading)
    - [Story 6.2: Certifications Model & Storage](./epic-6-executive-resume-template-profile-system.md#story-62-certifications-model-storage)
    - [Story 6.3: Skills Curation Service](./epic-6-executive-resume-template-profile-system.md#story-63-skills-curation-service)
    - [Story 6.4: Executive Resume Template](./epic-6-executive-resume-template-profile-system.md#story-64-executive-resume-template)
    - [Story 6.5: Template Certifications Section](./epic-6-executive-resume-template-profile-system.md#story-65-template-certifications-section)
    - [Story 6.6: Education Model & Rendering](./epic-6-executive-resume-template-profile-system.md#story-66-education-model-rendering)
    - [Story 6.7: Positions Data Model & Employment History (Normalized Architecture)](./epic-6-executive-resume-template-profile-system.md#story-67-positions-data-model-employment-history-normalized-architecture)
    - [Story 6.8: Position Management Commands (Human-Friendly UX)](./epic-6-executive-resume-template-profile-system.md#story-68-position-management-commands-human-friendly-ux)
    - [Story 6.9: Inline Position Creation (LLM-Optimized UX)](./epic-6-executive-resume-template-profile-system.md#story-69-inline-position-creation-llm-optimized-ux)
    - [Story 6.10: CLAUDE.md System Documentation Update](./epic-6-executive-resume-template-profile-system.md#story-610-claudemd-system-documentation-update)
    - [Checking Existing Positions](./epic-6-executive-resume-template-profile-system.md#checking-existing-positions)
    - [Creating Work Unit for Existing Position](./epic-6-executive-resume-template-profile-system.md#creating-work-unit-for-existing-position)
    - [Story 6.12: Education Management Commands](./epic-6-executive-resume-template-profile-system.md#story-612-education-management-commands)
  - [FR Coverage Map Update](./fr-coverage-map-update.md)
    - [Story 6.13: Career Highlights Section (CTO/Hybrid Format)](./fr-coverage-map-update.md#story-613-career-highlights-section-ctohybrid-format)
    - [Story 6.14: Board & Advisory Roles Section](./fr-coverage-map-update.md#story-614-board-advisory-roles-section)
    - [Story 6.15: Publications & Speaking Engagements](./fr-coverage-map-update.md#story-615-publications-speaking-engagements)
    - [Story 6.16: Enhanced Scope Indicators (P&L, Revenue, Geography)](./fr-coverage-map-update.md#story-616-enhanced-scope-indicators-pl-revenue-geography)
    - [Story 6.17: CTO Resume Template Variant](./fr-coverage-map-update.md#story-617-cto-resume-template-variant)
    - [Story 6.18: Enhanced Plan Command with Full Data Model Preview](./fr-coverage-map-update.md#story-618-enhanced-plan-command-with-full-data-model-preview)
  - [Epic 6 Dependencies Updated](./epic-6-dependencies-updated.md)
    - [Story 6.19: Resume as Code Philosophy Documentation](./epic-6-dependencies-updated.md#story-619-resume-as-code-philosophy-documentation)
    - [Story 6.20: Comprehensive README Update](./epic-6-dependencies-updated.md#story-620-comprehensive-readme-update)
    - [Story 6.21: GitHub Pages Marketing Site (Docusaurus)](./epic-6-dependencies-updated.md#story-621-github-pages-marketing-site-docusaurus)
  - [Epic 7: Schema & Data Model Refactoring](./epic-7-schema-data-model-refactoring.md)
    - [Story 7.1: JSON Schema Auto-Generation](./epic-7-schema-data-model-refactoring.md#story-71-json-schema-auto-generation)
    - [Story 7.2: Unified Scope Model](./epic-7-schema-data-model-refactoring.md#story-72-unified-scope-model)
    - [Story 7.3: Standardized Date Types](./epic-7-schema-data-model-refactoring.md#story-73-standardized-date-types)
    - [Story 7.4: Skills Registry & Normalization](./epic-7-schema-data-model-refactoring.md#story-74-skills-registry-normalization)
    - [Story 7.5: O*NET API Integration](./epic-7-schema-data-model-refactoring.md#story-75-onet-api-integration)
    - [Story 7.6: Position Reference Integrity](./epic-7-schema-data-model-refactoring.md#story-76-position-reference-integrity)
    - [Story 7.7: Evidence Model Enhancement](./epic-7-schema-data-model-refactoring.md#story-77-evidence-model-enhancement)
    - [Story 7.8: Field-Weighted BM25 Scoring](./epic-7-schema-data-model-refactoring.md#story-78-field-weighted-bm25-scoring)
    - [Story 7.9: Recency Decay for Work Units](./epic-7-schema-data-model-refactoring.md#story-79-recency-decay-for-work-units)
    - [Story 7.10: Improved BM25 Tokenization](./epic-7-schema-data-model-refactoring.md#story-710-improved-bm25-tokenization)
    - [Story 7.11: Section-Level Semantic Embeddings](./epic-7-schema-data-model-refactoring.md#story-711-section-level-semantic-embeddings)
    - [Story 7.12: Seniority Level Matching](./epic-7-schema-data-model-refactoring.md#story-712-seniority-level-matching)
    - [Story 7.13: Impact Category Classification](./epic-7-schema-data-model-refactoring.md#story-713-impact-category-classification)
    - [Story 7.14: JD-Relevant Content Curation](./epic-7-schema-data-model-refactoring.md#story-714-jd-relevant-content-curation)
    - [Story 7.15: Comprehensive Algorithm Documentation](./epic-7-schema-data-model-refactoring.md#story-715-comprehensive-algorithm-documentation)
      - [Semantic Score](./epic-7-schema-data-model-refactoring.md#semantic-score)
    - [Step 4: RRF Fusion](./epic-7-schema-data-model-refactoring.md#step-4-rrf-fusion)
    - [Step 5: Score Modifiers](./epic-7-schema-data-model-refactoring.md#step-5-score-modifiers)
      - [Recency Decay (Story 7.9)](./epic-7-schema-data-model-refactoring.md#recency-decay-story-79)
      - [Quantified Achievement Boost (Story 7.14)](./epic-7-schema-data-model-refactoring.md#quantified-achievement-boost-story-714)
      - [Seniority Alignment (Story 7.12)](./epic-7-schema-data-model-refactoring.md#seniority-alignment-story-712)
    - [Step 6: Content Curation (Story 7.14)](./epic-7-schema-data-model-refactoring.md#step-6-content-curation-story-714)
  - [3. Configuration Reference](#3-configuration-reference)
  - [4. Tuning Guide](#4-tuning-guide)
  - [5. Troubleshooting](#5-troubleshooting)
  - [6. Changelog](#6-changelog)
  - [Epic 7 Summary](./epic-7-summary.md)
