# kj-rollin/apply-smart architecture

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

- Interactive diagram: https://gitdiagram.com/kj-rollin/apply-smart
- Repository: https://github.com/kj-rollin/apply-smart

## Overview

This repository is a Claude skill for vetting job postings before a user shares sensitive information or applies. Its documented workflow researches employer and platform legitimacy, checks privacy and terms for specific risks, reports findings under a zero-tolerance rule, and supports application preparation only after a clean result. The checklist supplies the red-flag criteria. The tree and README document these responsibilities, but no source excerpts were provided, so internal call wiring is not inferred.

Main entry points: [`SKILL.md`](https://github.com/kj-rollin/apply-smart/blob/master/SKILL.md) (Skill instructions), [`references/due_diligence_checklist.md`](https://github.com/kj-rollin/apply-smart/blob/master/references/due_diligence_checklist.md) (Red-flag checklist)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Vetting workflow"]
  node_skill["Skill instructions<br/>[SKILL.md]"]
  node_posting["Job posting"]
  node_company_platform["Company and platform checks<br/>[SKILL.md]"]
  node_reputation["Reputation signals<br/>[SKILL.md]"]
  node_terms_privacy["Terms and privacy review<br/>[SKILL.md]"]
end

subgraph group_guidance["Risk guidance"]
  node_checklist["Red-flag checklist"]
end

subgraph group_outcomes["User outcomes"]
  node_risk_report["Findings report<br/>[SKILL.md]"]
  node_application_prep["Application preparation<br/>[SKILL.md]"]
end

node_user(("Job seeker"))
node_public_sources["Public reputation sources"]
node_posting_terms["Employer/platform terms"]
node_resume["User resume"]

node_user -->|"invokes with posting"| node_skill
node_skill -->|"directs checks"| node_company_platform
node_skill -->|"directs research"| node_reputation
node_skill -->|"directs review"| node_terms_privacy
node_skill -->|"requires reporting"| node_risk_report
node_skill -->|"allows after clearance"| node_application_prep
node_posting -->|"identifies employer"| node_company_platform
node_posting -->|"identifies terms"| node_terms_privacy
node_company_platform -->|"checks reputation"| node_public_sources
node_reputation -->|"consults signals"| node_public_sources
node_terms_privacy -->|"reviews terms"| node_posting_terms
node_terms_privacy -->|"checks red flags"| node_checklist
node_company_platform -->|"checks red flags"| node_checklist
node_risk_report -->|"presents findings"| node_user
node_application_prep -->|"uses materials"| node_resume
node_application_prep -->|"returns draft"| node_user

click node_skill "https://github.com/kj-rollin/apply-smart/blob/master/SKILL.md"
click node_company_platform "https://github.com/kj-rollin/apply-smart/blob/master/SKILL.md"
click node_reputation "https://github.com/kj-rollin/apply-smart/blob/master/SKILL.md"
click node_terms_privacy "https://github.com/kj-rollin/apply-smart/blob/master/SKILL.md"
click node_checklist "https://github.com/kj-rollin/apply-smart/blob/master/references/due_diligence_checklist.md"
click node_risk_report "https://github.com/kj-rollin/apply-smart/blob/master/SKILL.md"
click node_application_prep "https://github.com/kj-rollin/apply-smart/blob/master/SKILL.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_posting,node_company_platform,node_reputation,node_terms_privacy,node_resume toneBlue
class node_checklist toneAmber
class node_risk_report,node_application_prep toneMint
class node_user,node_public_sources,node_posting_terms toneIndigo
```

## Components

### Vetting workflow

- [Skill instructions](https://github.com/kj-rollin/apply-smart/blob/master/SKILL.md): `SKILL.md`
- **Job posting**
- [Company and platform checks](https://github.com/kj-rollin/apply-smart/blob/master/SKILL.md): `SKILL.md`
- [Reputation signals](https://github.com/kj-rollin/apply-smart/blob/master/SKILL.md): `SKILL.md`
- [Terms and privacy review](https://github.com/kj-rollin/apply-smart/blob/master/SKILL.md): `SKILL.md`

### Risk guidance

- [Red-flag checklist](https://github.com/kj-rollin/apply-smart/blob/master/references/due_diligence_checklist.md): `references/due_diligence_checklist.md`

### User outcomes

- [Findings report](https://github.com/kj-rollin/apply-smart/blob/master/SKILL.md): `SKILL.md`
- [Application preparation](https://github.com/kj-rollin/apply-smart/blob/master/SKILL.md): `SKILL.md`

### Other components

- **Job seeker**
- **Public reputation sources**
- **Employer/platform terms**
- **User resume**

## Connections

- Job seeker → Skill instructions: invokes with posting
- Skill instructions → Company and platform checks: directs checks
- Skill instructions → Reputation signals: directs research
- Skill instructions → Terms and privacy review: directs review
- Skill instructions → Findings report: requires reporting
- Skill instructions → Application preparation: allows after clearance
- Job posting → Company and platform checks: identifies employer
- Job posting → Terms and privacy review: identifies terms
- Company and platform checks → Public reputation sources: checks reputation
- Reputation signals → Public reputation sources: consults signals
- Terms and privacy review → Employer/platform terms: reviews terms
- Terms and privacy review → Red-flag checklist: checks red flags
- Company and platform checks → Red-flag checklist: checks red flags
- Findings report → Job seeker: presents findings
- Application preparation → User resume: uses materials
- Application preparation → Job seeker: returns draft