| name | validate-application |
| description | After step 6 in Apply to a job, validate the README and resume against all rules. On failure, Strategist diagnoses fix and Documentor applies; repeat until pass. Trigger: "validate", "validation", /validate-application. |
Validate Application
Run after step 6. Check README against all applicable rules (learn, document-findings, resume-alignment). PASS or FAIL with validation-report.md; on FAIL, Strategist diagnoses fix and Documentor applies, then re-validate until PASS.
Inputs
- Project path –
work/{company}/{job}/ from work/config.md.
- README –
work/{company}/{job}/README.md (cover letter at very top, then ---, then resume, then ---, then TOC and sections).
Output
- PASS – All checks below pass. Report "Validation passed."
- FAIL – One or more checks failed. Write
work/{company}/{job}/validation-report.md with failed check numbers and short description. Do not modify README. Coordinator runs Strategist → Documentor → re-validate.
Checks (every rule)
Run these in order. If a check fails, add it to the failure list and continue.
Years of experience and resume cutoff
- Years documented: README has a section ⏱ Years of experience required (or equivalent) with one clear line stating the job's experience requirement (e.g. "Total: 12+ years. Leadership: 5+ years." or "Not specified."). If missing or empty, fail.
- Resume experience cutoff: The resume (the block between the first
--- and the second ---, or before the first --- if no cover letter) does not show significantly more years of experience than the job asks for. Compute the earliest start year that should appear (e.g. if job asks 12+ years, roles should start no earlier than ~12–15 years ago). If the resume lists roles starting more than that window back, fail.
Document-findings rules
- No absolute paths: No link in the README uses an absolute filesystem path; all links are relative or external URLs.
- No invented data: No placeholder, TBD, example names/dates, or made-up content in any section (Deliverables, tables, etc.). Only real data from source material.
- Sources preserved: README has a 🔗 Sources section with a table; each URL is a markdown link
[title](url).
- Link tree preserved: README has a 🌐 Link tree section; each item is a markdown link
[title](url).
- TOC complete: After the second
--- (the one that follows the resume), the table of contents links to every H2 and H3 in the document. No section is missing from the TOC.
- Emoji in headings: Every H2 and H3 below the second
--- has an emoji in the heading text.
- Job post in README: README has 📄 Job post (full copy) section with the full job listing content.
- Structure: README starts with cover letter (if present), then first
---, then resume, then second ---, then H1 title and TOC and sections.
Resume-alignment rules (resume and cover letter at top)
- Keywords: Resume Skills and Experience reflect recurring nouns/skills from the job post where accurate. Cover letter (if present) references role and company and key fit.
- Reverse chronology: Experience is listed most recent first (by date).
- Action verbs: Resume bullets start with action verbs (e.g. led, designed, shipped, increased).
- Quantifiable results: At least some resume bullets include numbers or measurable impact where the source material supports it.
- Experience cutoff: Resume includes only roles within the job's years-of-experience window (see check 2).
Learn rules (as reflected in README)
- Clickable links: Every URL in Sources and Link tree is written as
[title](url). No bare URLs or title-only lines in those sections.
On failure
Write validation-report.md (failed check numbers and what is wrong). Report FAIL. Coordinator runs Strategist → Documentor → re-validate until PASS (see Output and Process).
Process
- Read config for project path; read README.
- Run each check; collect failures.
- No failures → report PASS. Any failures → write validation-report.md, report FAIL.