Company Manifest Queue

Modes

Single-company intake

Use when the user names one company or ticker.

Collect or confirm:

• company name and ticker
• slug
• region, index, sector, industry
• CompaniesMarketCap URL
• short company description
• relevant technology wave IDs
• optional IPO metadata
• optional seed product names
• optional seed source URLs
• notes that explain why this company is entering the queue

Batch intake

Use when the user wants a set of companies from an index, sector, region, theme, or arbitrary grouping.

Workflow:

1. If the user provided only raw names, tickers, or a group phrase, start with bun run company:intake --mode=prepare.
2. Confirm or narrow the list with the user if the grouping is ambiguous and they want manual control.
3. Draft one manifest per confirmed company.
4. Stage them with a consistent --batch-id and --group-label.

Do not queue ambiguous candidates without confirmation.

Queueing Rules

• Check content/manifests/companies/ and content/manifests/queue/ first.
• If a slug is already canonical or already queued, stop and tell the user unless they explicitly asked to replace it.
• Write plain CompanyManifest draft JSON first.
• Stage drafts with bun run company:queue --manifest=....
• For raw intake requests, let company:intake create content/manifests/unverified/<request-id>.json, resolve candidates, and queue only the manifests that validate cleanly.
• When the raw intake overlaps companies that already have published research, ask whether the user wants to skip them or refresh them. Pass that choice with --already-researched=skip|refresh.
• In batch mode, include --batch-id, --group-label, and --request-notes when useful.
• If the user wants the whole intake flow handled end-to-end, prefer bun run company:pipeline --manifest=... --provider=auto instead of stopping after queueing.
• If the user wants the raw-intake flow handled end-to-end, prefer bun run company:intake --raw=... --mode=dry-run --provider=auto or --mode=publish when they explicitly asked for publication.
• Otherwise end by telling the user the next command: bun run company:init --queued=<slug>.
• Mention the follow-up Ralph step after promotion: bun run sync:company --company=<slug> --mode=dry-run.

After a company:intake --mode=prepare run, the normal inline follow-up is:

• already researched: skip or refresh
• queue/prepared only
• research dry-run
• publish website

If the user already requested dry-run or publish in the original prompt, skip the later workflow prompt and honor the requested end state directly. If they did not specify what to do with already researched companies, ask that first.

Guardrails

• Never write directly to content/manifests/companies/ from this skill.
• Prefer factual notes over narrative prose.
• Keep seedProductNames and seedSourceUrls as hints, not exhaustive research.
• If the taxonomy is missing the needed sector, industry, index, region, or wave, stop and surface the exact missing IDs instead of creating ad hoc values.