# selfxplanatorium/cvcannon architecture

> Architecture diagram of the GitHub repository selfxplanatorium/cvcannon, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/selfxplanatorium/cvcannon
- Repository: https://github.com/selfxplanatorium/cvcannon

## Overview

cvcannon is a provider-agnostic, agent-assisted workflow for turning multiple job listings and a reusable candidate profile into tailored application packs. The agent interprets listings, selects evidence, and writes role-specific documents; the repository provides scaffolding, templates, rendering, and technical checks. The map follows the documented workflow and sampled CLI/rendering code; unsampled subsystems are represented only where README statements support them.

Main entry points: [`scripts/cv.py`](https://github.com/selfxplanatorium/cvcannon/blob/main/scripts/cv.py) (Pack builder), [`APPLICATIONS`](https://github.com/selfxplanatorium/cvcannon/tree/main/APPLICATIONS) (Tailored CV), [`BASE/TEMPLATES`](https://github.com/selfxplanatorium/cvcannon/tree/main/BASE/TEMPLATES) (Template pairs), [`PROFILE`](https://github.com/selfxplanatorium/cvcannon/tree/main/PROFILE) (Career material)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_inputs["Candidate inputs"]
  node_listings["Job listings"]
  node_career["Career material"]
  node_master["Master CV"]
end

subgraph group_tailoring["Role tailoring"]
  node_appfolder["Application folder"]
  node_description["Job description"]
  node_analysis["Job analysis"]
  node_evidence["Evidence map"]
  node_notes["Application notes"]
  node_tailoredcv["Tailored CV"]
  node_letter["Cover letter"]
end

subgraph group_production["Document production"]
  node_templates["Template pairs"]
  node_builder["Pack builder<br/>[cv.py]"]
  node_chromium["Chromium renderer"]
end

subgraph group_review["Output review"]
  node_pdfs["Verified PDFs"]
  node_quality["PDF quality checks<br/>[cv.py]"]
  node_previews["PNG previews"]
  node_poppler["Poppler tools"]
end

node_candidate(("Candidate"))
node_agent["Agent harness"]

node_candidate -->|"provides material"| node_agent
node_candidate -->|"provides listings"| node_agent
node_agent -->|"reads source"| node_career
node_agent -->|"creates authoritative CV"| node_master
node_career -->|"informs"| node_master
node_agent -->|"records listing"| node_description
node_listings -->|"supplies text"| node_description
node_agent -->|"analyzes role"| node_analysis
node_description -->|"informs"| node_analysis
node_agent -->|"maps requirements"| node_evidence
node_master -->|"supplies evidence"| node_evidence
node_agent -->|"organizes application"| node_appfolder
node_master -->|"tailors copy"| node_tailoredcv
node_analysis -->|"guides tailoring"| node_tailoredcv
node_evidence -->|"guides selection"| node_tailoredcv
node_agent -->|"writes letter"| node_letter
node_analysis -->|"guides writing"| node_letter
node_agent -->|"records decisions"| node_notes
node_templates -->|"provides design"| node_tailoredcv
node_templates -->|"provides design"| node_letter
node_builder -->|"scaffolds and builds"| node_appfolder
node_builder -->|"renders document"| node_tailoredcv
node_builder -->|"renders document"| node_letter
node_builder -->|"invokes renderer"| node_chromium
node_chromium -->|"produces PDFs"| node_pdfs
node_builder -->|"runs checks"| node_quality
node_quality -->|"verifies output"| node_pdfs
node_quality -->|"checks PDF metadata"| node_poppler
node_builder -->|"renders previews"| node_previews
node_candidate -->|"reviews"| node_pdfs
node_candidate -->|"inspects"| node_previews

click node_career "https://github.com/selfxplanatorium/cvcannon/tree/main/PROFILE"
click node_appfolder "https://github.com/selfxplanatorium/cvcannon/tree/main/APPLICATIONS"
click node_description "https://github.com/selfxplanatorium/cvcannon/tree/main/APPLICATIONS"
click node_analysis "https://github.com/selfxplanatorium/cvcannon/tree/main/APPLICATIONS"
click node_evidence "https://github.com/selfxplanatorium/cvcannon/tree/main/APPLICATIONS"
click node_notes "https://github.com/selfxplanatorium/cvcannon/tree/main/APPLICATIONS"
click node_tailoredcv "https://github.com/selfxplanatorium/cvcannon/tree/main/APPLICATIONS"
click node_letter "https://github.com/selfxplanatorium/cvcannon/tree/main/APPLICATIONS"
click node_templates "https://github.com/selfxplanatorium/cvcannon/tree/main/BASE/TEMPLATES"
click node_builder "https://github.com/selfxplanatorium/cvcannon/blob/main/scripts/cv.py"
click node_pdfs "https://github.com/selfxplanatorium/cvcannon/tree/main/APPLICATIONS"
click node_quality "https://github.com/selfxplanatorium/cvcannon/blob/main/scripts/cv.py"
click node_previews "https://github.com/selfxplanatorium/cvcannon/tree/main/APPLICATIONS"

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_listings,node_career,node_master toneBlue
class node_appfolder,node_description,node_analysis,node_evidence,node_notes,node_tailoredcv,node_letter toneAmber
class node_templates,node_builder,node_chromium toneMint
class node_pdfs,node_quality,node_previews,node_poppler toneRose
class node_candidate,node_agent toneIndigo
```

## Components

### Candidate inputs

- **Job listings**
- [Career material](https://github.com/selfxplanatorium/cvcannon/tree/main/PROFILE): `PROFILE`
- **Master CV**

### Role tailoring

- [Application folder](https://github.com/selfxplanatorium/cvcannon/tree/main/APPLICATIONS): `APPLICATIONS`
- [Job description](https://github.com/selfxplanatorium/cvcannon/tree/main/APPLICATIONS): `APPLICATIONS`
- [Job analysis](https://github.com/selfxplanatorium/cvcannon/tree/main/APPLICATIONS): `APPLICATIONS`
- [Evidence map](https://github.com/selfxplanatorium/cvcannon/tree/main/APPLICATIONS): `APPLICATIONS`
- [Application notes](https://github.com/selfxplanatorium/cvcannon/tree/main/APPLICATIONS): `APPLICATIONS`
- [Tailored CV](https://github.com/selfxplanatorium/cvcannon/tree/main/APPLICATIONS): `APPLICATIONS`
- [Cover letter](https://github.com/selfxplanatorium/cvcannon/tree/main/APPLICATIONS): `APPLICATIONS`

### Document production

- [Template pairs](https://github.com/selfxplanatorium/cvcannon/tree/main/BASE/TEMPLATES): `BASE/TEMPLATES`
- [Pack builder](https://github.com/selfxplanatorium/cvcannon/blob/main/scripts/cv.py): `scripts/cv.py`
- **Chromium renderer**

### Output review

- [Verified PDFs](https://github.com/selfxplanatorium/cvcannon/tree/main/APPLICATIONS): `APPLICATIONS`
- [PDF quality checks](https://github.com/selfxplanatorium/cvcannon/blob/main/scripts/cv.py): `scripts/cv.py`
- [PNG previews](https://github.com/selfxplanatorium/cvcannon/tree/main/APPLICATIONS): `APPLICATIONS`
- **Poppler tools**

### Other components

- **Candidate**
- **Agent harness**

## Connections

- Candidate → Agent harness: provides material (evidence: `README.md`)
- Candidate → Agent harness: provides listings (evidence: `README.md`)
- Agent harness → Career material: reads source (evidence: `README.md`)
- Agent harness → Master CV: creates authoritative CV (evidence: `README.md`)
- Career material → Master CV: informs (evidence: `README.md`)
- Agent harness → Job description: records listing (evidence: `README.md`)
- Job listings → Job description: supplies text (evidence: `README.md`)
- Agent harness → Job analysis: analyzes role (evidence: `README.md`)
- Job description → Job analysis: informs (evidence: `README.md`)
- Agent harness → Evidence map: maps requirements (evidence: `README.md`)
- Master CV → Evidence map: supplies evidence (evidence: `README.md`)
- Agent harness → Application folder: organizes application (evidence: `README.md`)
- Master CV → Tailored CV: tailors copy (evidence: `README.md`)
- Job analysis → Tailored CV: guides tailoring (evidence: `README.md`)
- Evidence map → Tailored CV: guides selection (evidence: `README.md`)
- Agent harness → Cover letter: writes letter (evidence: `README.md`)
- Job analysis → Cover letter: guides writing (evidence: `README.md`)
- Agent harness → Application notes: records decisions (evidence: `README.md`)
- Template pairs → Tailored CV: provides design (evidence: `README.md`)
- Template pairs → Cover letter: provides design (evidence: `README.md`)
- Pack builder → Application folder: scaffolds and builds (evidence: `scripts/cv.py`)
- Pack builder → Tailored CV: renders document (evidence: `README.md`)
- Pack builder → Cover letter: renders document (evidence: `README.md`)
- Pack builder → Chromium renderer: invokes renderer (evidence: `scripts/cv.py`)
- Chromium renderer → Verified PDFs: produces PDFs (evidence: `README.md`)
- Pack builder → PDF quality checks: runs checks (evidence: `scripts/cv.py`)
- PDF quality checks → Verified PDFs: verifies output (evidence: `README.md`)
- PDF quality checks → Poppler tools: checks PDF metadata (evidence: `scripts/cv.py`)
- Pack builder → PNG previews: renders previews (evidence: `README.md`)
- Candidate → Verified PDFs: reviews (evidence: `README.md`)
- Candidate → PNG previews: inspects (evidence: `README.md`)
