Brief — Company Overview

Top-level company read. The first brief most users want. Other briefs (financials, recruitment, remote, glassdoor, cultural-fit) cover specific angles; this one is the executive summary.

Inputs

$ARGUMENTS:

• Required: <company_name> — first positional.
• Optional: --lens=<employer|client|partner> (default employer).
• Optional: --slug=<slug> (default: kebab-case of company name).
• Optional: --url=<homepage> — short-circuits domain discovery.

Procedure

1. Resolve config + paths

Read ${CAREER_DATA_DIR}/config.json for WORKING_FOLDER. Compute slug (provided or derived). Output path: ${WORKING_FOLDER}/research/companies/${slug}/company-overview.md.

If the file already exists, ask: overwrite, append, or open existing.