Example Company Research File
Each research subagent writes one markdown file per company to {OUTPUT_DIR}/{company-slug}.md, where {OUTPUT_DIR} is the per-run Desktop directory set up by the main agent in Step 0 (e.g., ~/Desktop/acme_research_2026-04-23/). The YAML frontmatter contains structured fields for report + CSV compilation. The body contains human-readable research.
Template
---
company_name: Acme Inc
website: https://acme.com
product_description: AI-powered inventory management for e-commerce brands
industry: E-commerce / SaaS
target_audience: Mid-market e-commerce brands
key_features: demand forecasting | automated reordering | multi-warehouse sync
icp_fit_score: 8
icp_fit_reasoning: Series A e-commerce SaaS, uses Selenium for scraping, expanding to EU — strong fit
employee_estimate: 50-100
funding_info: Series A, $12M
headquarters: San Francisco, CA
---
## Product
AI-powered inventory management for e-commerce brands. Helps DTC brands
automate reordering and sync across multiple warehouses.
## Research Findings
- **[high]** Checkout optimization for Shopify stores, serving mid-market DTC brands with $5M-$50M revenue (source: acme.com/about)
- **[high]** Series A, $12M raised in Q3 2025 from Sequoia (source: TechCrunch)
- **[medium]** Recently hired 3 data engineers, expanding platform team (source: LinkedIn job posts)
- **[medium]** Uses Selenium for web scraping in their data pipeline (source: careers page)Field Rules
- YAML frontmatter: All structured fields go here. These are extracted for CSV compilation.
key_features: Pipe-separated (|) list in YAML, not a JSON array.icp_fit_score: Integer 1-10.icp_fit_reasoning: One line, references specific findings.- Body sections:
## Product,## Research Findings. - Findings format:
- **[confidence]** fact (source: url or description) - Filename:
{OUTPUT_DIR}/{company-slug}.mdwhere slug is lowercase, hyphenated (e.g.,acme-inc.md). - Deduplication: One file per company. If a subagent encounters a company that already has a file, overwrite with richer data.
Writing via Bash Heredoc
Subagents write these files using bash heredoc to avoid security prompts. Use the full literal {OUTPUT_DIR} path — no ~ or $HOME:
cat << 'COMPANY_MD' > {OUTPUT_DIR}/acme-inc.md
---
company_name: Acme Inc
website: https://acme.com
...
---
## Product
...
## Research Findings
...
COMPANY_MDUse 'COMPANY_MD' (quoted) as the delimiter to prevent shell variable expansion.
IMPORTANT: Write ALL company files in a SINGLE Bash call using chained heredocs to minimize permission prompts.