# aliwu-14/cv-helper architecture

> Architecture diagram of the GitHub repository aliwu-14/cv-helper, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-29). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/aliwu-14/cv-helper
- Repository: https://github.com/aliwu-14/cv-helper

## Overview

cv-helper is an Agent skill for conversational, tailored Chinese resume creation, not a standalone resume generator. The user initiates a six-stage intake; the Agent gathers candidate details, job direction, target role and JD, desired highlights, and career history, then researches the target company, drafts a six-module resume, validates it for ATS/readability, and iterates with the user. The README establishes this workflow and the reference tree indicates supporting guidance for intake, layouts, templates, methodology, and interview preparation. Source excerpts show separate Chinese and English summary and section validators; implementation wiring beyond those excerpts is not assumed.

Main entry points: [`references/templates.md`](https://github.com/aliwu-14/cv-helper/blob/main/references/templates.md) (Six-Module Resume), [`SKILL.md`](https://github.com/aliwu-14/cv-helper/blob/main/SKILL.md) (Skill Protocol), [`references/intake_flow.md`](https://github.com/aliwu-14/cv-helper/blob/main/references/intake_flow.md) (Basic Profile), [`references`](https://github.com/aliwu-14/cv-helper/tree/main/references) (Company Research)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_conversation["Guided Intake"]
  node_skill["Skill Protocol<br/>[SKILL.md]"]
  node_profile["Basic Profile<br/>[intake_flow.md]"]
  node_direction["Job Direction<br/>[intake_flow.md]"]
  node_target["Company and JD<br/>[intake_flow.md]"]
  node_highlights["Key Highlights<br/>[intake_flow.md]"]
  node_history["Career History<br/>[intake_flow.md]"]
end

subgraph group_authoring["Resume Authoring"]
  node_company_research["Company Research"]
  node_resume["Six-Module Resume<br/>[templates.md]"]
end

subgraph group_validation["ATS Validation"]
  node_summary_cn["Chinese Summary Check<br/>[validate_output.py]"]
  node_sections_cn["Chinese Section Check"]
  node_summary_en["English Summary Check"]
  node_sections_en["English Section Check"]
end

subgraph group_guidance["Skill Guidance"]
  node_ats_guidance["ATS Layout Guidance<br/>[ats_layout.md]"]
  node_interview_prep["Interview Preparation<br/>[interview_prep.md]"]
  node_methodology["Resume Methodology<br/>[methodology.md]"]
end

node_user(("Job Seeker"))
node_agent(("Agent Client"))

node_user -->|"requests resume"| node_agent
node_agent -->|"follows protocol"| node_skill
node_skill -->|"guides intake"| node_agent
node_agent -->|"asks for"| node_profile
node_agent -->|"asks for"| node_direction
node_agent -->|"asks for"| node_target
node_agent -->|"asks for"| node_highlights
node_agent -->|"asks for"| node_history
node_agent -->|"researches target"| node_company_research
node_agent -->|"drafts modules"| node_resume
node_agent -->|"validates summary"| node_summary_cn
node_agent -->|"validates sections"| node_sections_cn
node_agent -.->|"validates summary"| node_summary_en
node_agent -.->|"validates sections"| node_sections_en
node_resume -->|"follows layout"| node_ats_guidance
node_resume -->|"uses guidance"| node_methodology
node_agent -.->|"offers preparation"| node_interview_prep
node_agent -->|"shares and iterates"| node_user

click node_skill "https://github.com/aliwu-14/cv-helper/blob/main/SKILL.md"
click node_profile "https://github.com/aliwu-14/cv-helper/blob/main/references/intake_flow.md"
click node_direction "https://github.com/aliwu-14/cv-helper/blob/main/references/intake_flow.md"
click node_target "https://github.com/aliwu-14/cv-helper/blob/main/references/intake_flow.md"
click node_highlights "https://github.com/aliwu-14/cv-helper/blob/main/references/intake_flow.md"
click node_history "https://github.com/aliwu-14/cv-helper/blob/main/references/intake_flow.md"
click node_company_research "https://github.com/aliwu-14/cv-helper/tree/main/references"
click node_resume "https://github.com/aliwu-14/cv-helper/blob/main/references/templates.md"
click node_summary_cn "https://github.com/aliwu-14/cv-helper/blob/main/scripts/validate_output.py"
click node_sections_cn "https://github.com/aliwu-14/cv-helper/blob/main/scripts/validate_section.py"
click node_summary_en "https://github.com/aliwu-14/cv-helper/blob/main/scripts/validate_output_en.py"
click node_sections_en "https://github.com/aliwu-14/cv-helper/blob/main/scripts/validate_section_en.py"
click node_ats_guidance "https://github.com/aliwu-14/cv-helper/blob/main/references/ats_layout.md"
click node_interview_prep "https://github.com/aliwu-14/cv-helper/blob/main/references/interview_prep.md"
click node_methodology "https://github.com/aliwu-14/cv-helper/blob/main/references/methodology.md"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_skill,node_profile,node_direction,node_target,node_highlights,node_history,node_agent toneBlue
class node_company_research,node_resume toneAmber
class node_summary_cn,node_sections_cn,node_summary_en,node_sections_en toneMint
class node_ats_guidance,node_interview_prep,node_methodology toneRose
class node_user toneIndigo
```

## Components

### Guided Intake

- [Skill Protocol](https://github.com/aliwu-14/cv-helper/blob/main/SKILL.md): `SKILL.md`
- [Basic Profile](https://github.com/aliwu-14/cv-helper/blob/main/references/intake_flow.md): `references/intake_flow.md`
- [Job Direction](https://github.com/aliwu-14/cv-helper/blob/main/references/intake_flow.md): `references/intake_flow.md`
- [Company and JD](https://github.com/aliwu-14/cv-helper/blob/main/references/intake_flow.md): `references/intake_flow.md`
- [Key Highlights](https://github.com/aliwu-14/cv-helper/blob/main/references/intake_flow.md): `references/intake_flow.md`
- [Career History](https://github.com/aliwu-14/cv-helper/blob/main/references/intake_flow.md): `references/intake_flow.md`

### Resume Authoring

- [Company Research](https://github.com/aliwu-14/cv-helper/tree/main/references): `references`
- [Six-Module Resume](https://github.com/aliwu-14/cv-helper/blob/main/references/templates.md): `references/templates.md`

### ATS Validation

- [Chinese Summary Check](https://github.com/aliwu-14/cv-helper/blob/main/scripts/validate_output.py): `scripts/validate_output.py`
- [Chinese Section Check](https://github.com/aliwu-14/cv-helper/blob/main/scripts/validate_section.py): `scripts/validate_section.py`
- [English Summary Check](https://github.com/aliwu-14/cv-helper/blob/main/scripts/validate_output_en.py): `scripts/validate_output_en.py`
- [English Section Check](https://github.com/aliwu-14/cv-helper/blob/main/scripts/validate_section_en.py): `scripts/validate_section_en.py`

### Skill Guidance

- [ATS Layout Guidance](https://github.com/aliwu-14/cv-helper/blob/main/references/ats_layout.md): `references/ats_layout.md`
- [Interview Preparation](https://github.com/aliwu-14/cv-helper/blob/main/references/interview_prep.md): `references/interview_prep.md`
- [Resume Methodology](https://github.com/aliwu-14/cv-helper/blob/main/references/methodology.md): `references/methodology.md`

### Other components

- **Job Seeker**
- **Agent Client**

## Connections

- Job Seeker → Agent Client: requests resume
- Agent Client → Skill Protocol: follows protocol
- Skill Protocol → Agent Client: guides intake
- Agent Client → Basic Profile: asks for
- Agent Client → Job Direction: asks for
- Agent Client → Company and JD: asks for
- Agent Client → Key Highlights: asks for
- Agent Client → Career History: asks for
- Agent Client → Company Research: researches target
- Agent Client → Six-Module Resume: drafts modules
- Agent Client → Chinese Summary Check: validates summary
- Agent Client → Chinese Section Check: validates sections
- Agent Client → English Summary Check: validates summary
- Agent Client → English Section Check: validates sections
- Six-Module Resume → ATS Layout Guidance: follows layout
- Six-Module Resume → Resume Methodology: uses guidance
- Agent Client → Interview Preparation: offers preparation
- Agent Client → Job Seeker: shares and iterates