company-research

Overview

Evaluate whether a company and role are worth the user's time. The research covers the job posting, company direction, work model, reviews, team signals, and red flags that would affect whether to apply or what to ask in interviews.

Remote/hybrid fit is an important section, not the whole workflow. Use it when relevant, especially for roles advertised as remote, hybrid, distributed, flexible, or location-independent.

Workflow

State layer: reads applications.md for dedup, writes a numbered research report, and upserts the tracker with status: saved on a positive verdict. See state-layer contract.

0. Dedup check

Read my-documents/applications.md (first-run scaffold if missing - see state-layer §2). If a row already exists for this company, also scan my-documents/reports/ for the most recent {company-slug}-research-*.md or {company-slug}-vetting-*.md file. Warn the user:

You researched {Company} on {date} - report {###}. Re-run, or open that?

If they choose "open that," read the report and stop. If they choose "re-run," continue.

1. Inputs