# Industry primer

A sourced primer on one industry in one region, enough to talk about it tomorrow.

Requires web search, through Exa. Requires web fetch.

## Install

```sh
npx @parcha/agentrun template install github:Parcha-ai/agentrun-templates/templates/industry-primer@242f29da8317fbe51d0cce4628bdb5ab61d7ccc9 --trust
```

Or open `<your AgentRun address>/#/templates/install?src=github%3AParcha-ai%2Fagentrun-templates%2Ftemplates%2Findustry-primer%40242f29da8317fbe51d0cce4628bdb5ab61d7ccc9`. Pinned to commit 242f29da8317fbe51d0cce4628bdb5ab61d7ccc9.

## What it does

A sourced primer on one industry in one region, for a consultant or analyst who needs to talk sensibly about it tomorrow. It covers the boundary, market size by source and data year, the value chain and who earns the margin, business models, key players, the metrics practitioners use, regulation, recent trends and a glossary.

- Skill `industry-primer`: Write a sourced primer on one industry in one region. Fix the boundary and classification codes, size it from official statistics and published estimates with their data years, map the value chain and margins, explain the business models, name the key players, list the metrics practitioners use, the regulation and the trends of the last 24 months, and give a glossary. Use for "primer on", "explain this industry", "industry overview before a diligence".

## What starts it

- By hand, any time: from the console, the API or the CLI.

## Inputs

| Name | Type | Required | What it is |
| --- | --- | --- | --- |
| `industry` | string, 3 to 200 characters | yes | The industry to explain. Say which part if the word could mean several things. Example: `Cold-chain logistics`. |
| `region` | string, 0 to 120 characters | no | A country or region. Blank: global, with US and EU figures where they differ. Example: `United Kingdom`. |
| `angle` | string, 0 to 300 characters | no | A segment to weigh most, or why you need the primer (a diligence, a client pitch). Example: `We are doing commercial diligence on a mid-size operator`. |

## What it needs

- Harness: pi, claude-agent, codex
- Model: balanced tier, medium effort
- Tools: read, web_search, web_fetch
- Computer: Wherever your AgentRun puts a new agent
- Keys: A model key
- Learning: off

## Sample output

Input:

```json
{
  "content": "Today is 2026-11-14. I need a primer on this industry.\n\nalderbank-insights.example and heatpolicy-observatory.example are not reachable from this run. The pages below are what\ntheir URLs return today; use them in place of fetching, and search normally for anything else.\n\n<captured-page url=\"https://alderbank-insights.example/reports/eu-heat-pumps\" captured=\"2026-11-14T10:00:00Z\" untrusted>\n<h1>EU residential heat pump equipment market</h1>\n<p>Published 2026-01-27. Alderbank Insights values the EU residential heat pump equipment market (manufacturer sales of\nair-to-water, ground-source and air-to-air units for homes) at EUR 14.0 billion in 2024, down from EUR 15.3 billion in\n2023 as subsidy changes in Germany and Italy slowed sales. Installation labour is excluded.</p>\n</captured-page>\n\n<captured-page url=\"https://heatpolicy-observatory.example/briefs/installed-market-2025\" captured=\"2026-11-14T10:01:00Z\" untrusted>\n<h1>What homes spent on heat pumps</h1>\n<p>Published 2026-06-09. The Observatory puts household spending on residential heat pumps in the EU at EUR 22.5 billion\nin 2025, counting equipment and installation together. Installation accounts for roughly 40% of the typical project cost.\nInstaller businesses remain fragmented: most have fewer than ten employees.</p>\n</captured-page>",
  "industry": "Residential heat pumps",
  "region": "European Union",
  "angle": "A client is weighing an installer roll-up"
}
```

Output:

#### EU residential heat pumps: installer roll-up primer

#### Bottom line
- The acquisition thesis is a local installation-and-service business, not simply exposure to equipment growth. Customer complexity, installer shortages and installation costs are documented barriers. **Inference:** execution quality and workforce retention should lead the thesis. [S3]
- Equipment and installed-project market estimates are different revenue measures. Do not add or average them. [S1][S2]
- Fragmentation is reported, but its scale and achievable consolidation benefits remain unverified. [S2]

#### Definition and size
Includes residential air-to-water, ground-source and air-to-air systems, installation and aftercare; excludes industrial and district-heating projects. NACE Rev. 2.1 43.22 covers plumbing, heat and air-conditioning installation, substantially broader than this target market; code verified only through a search excerpt. [S1][S3][S5]

| Value | Definition | Data year | Published | Source |
|---|---|---|---|---|
| EUR 15.3bn | EU residential manufacturer equipment sales | 2023 | 2026-01-27 | [S1] |
| EUR 14.0bn | Same scope; installation labour excluded | 2024 | 2026-01-27 | [S1] |
| EUR 22.5bn | EU household equipment plus installation spending | 2025 | 2026-06-09 | [S2] |
| 2.6m units | Broader EU demand proxy; up 13% | 2025 | Not stated | [S3] |
| EUR 23bn | Broader EU heat-pump investment proxy | 2023 | March 2024 underlying source | [S3] |
| Not found | Residential installation-only revenue | — | — | [S2][S3] |

The headline EUR 14.0bn–22.5bn span changes both year and revenue boundary. The Observatory's typical-project installation share is not a sector margin or a valid basis for extracting an EU installation market. [S1][S2]

#### Value chain and margins
| Stage | Participants | Typical margin |
|---|---|---|
| Equipment | Manufacturers; integrated Aira model | Not found [S6] |
| Acquisition/finance | Installers and integrated providers | Not found [S3][S6] |
| Installation | Local businesses and employed teams | Not found [S2][S6] |
| Aftercare | Qualified service personnel | Not found [S4] |
| Energy optimisation | Connected home-energy platforms | Not found [S7] |

#### Business models
Project revenue combines equipment and installation. Service adds a continuing customer relationship; integrated providers also offer financing, guarantees and energy controls. **Diligence inference:** reconcile equipment pass-through, direct labour, acquisition costs and callbacks before attributing value to scale. Model inventory, project cash timing and guarantee liabilities separately. Manufacturing adds capital requirements beyond installation. [S2][S3][S4][S6][S7]

#### Key players
Illustrative comparators, not an EU ranking:

| Provider | Position and scale |
|---|---|
| Aira | Investor-backed integrated provider in Germany, Italy and UK; company-reported EUR 200m annual sales run-rate in August 2025, not EU annual revenue. [S6] |
| 1KOMMA5° | Home-energy integrator; reports over 10,000 German heat-pump sales during 2024–2025, not equivalent completed installations. [S7] |

#### Metrics
Proposed diligence dashboard; no typical ranges verified:

| KPI | Question |
|---|---|
| Completions/conversion | Do orders become accepted jobs? [S7] |
| Contribution/job | What remains after direct project costs? [S2] |
| Crew productivity | Is scarce labour deployed effectively? [S3] |
| Acquisition cost | What does a completed customer cost? [S3][S6] |
| Callbacks/aftercare | Are guarantees and service profitable? [S4][S6] |
| Cash conversion | When are project receipts collected? [S3][S6] |

#### Regulation
F-gas guidance addresses qualifications, emissions, applicable leak checks, records and recovery. The revised EPBD entered into force on 2024-05-28; national transposition was due 2026-05-29. It establishes national residential trajectories, not a universal household heat-pump mandate. Country implementation requires separate checking. [S4][S8]

#### Trends
Recent evidence shows 2025 demand recovery, January 2025 workforce-policy coordination, Aira's August 2025 financing, January 2026 integrated-energy positioning and the May 2026 EPBD transposition deadline. **Inference:** prioritise country selection, technician retention, affordability and operational integration over a generic EU growth thesis. [S3][S6][S7][S8]

#### Glossary
**Air-to-water:** heats a water circuit; **air-to-air:** heats indoor air; **ground-source:** draws ground heat; **installed spending:** equipment plus installation; **F-gases:** regulated fluorinated gases; **EPBD:** building-performance framework; **run-rate:** annualised trading measure; **virtual power plant:** coordinated connected energy devices. [S1][S2][S3][S4][S6][S7][S8]

#### Go deeper
Use Commission heat-pump country-fiche links, F-gas guidance and the EPBD overview before country diligence. [S3][S4][S8]

#### Gaps
Supplied valuations lack independent corroboration. Installer fragmentation has no stated observation year. Margins, transaction multiples, ownership details, realised synergies and national licensing/subsidies remain unverified. This is research, not investment, legal or regulatory advice.

## Tested

Passes 4 of 4 eval cases on pi, 3 of 4 on Claude Code and 2 of 4 on Codex. Not yet tried on the live web.

4 eval cases: ambiguous-scope, data-year-conflict, injection-in-page, thin-data.

## Source

- Package: https://github.com/Parcha-ai/agentrun-templates/tree/242f29da8317fbe51d0cce4628bdb5ab61d7ccc9/templates/industry-primer
- Publisher: Parcha-ai
- Author: Parcha Labs
- Version: 0.1.0
- License: Apache-2.0
- Category: Research
- Page: https://marketplace.agentrun.ai/templates/industry-primer/
