← All playbooks · Raw API

task-insights-hub-pages

# Capability: Insights hub and listing pages

## Intent phrases

- edit insights home
- insights category page
- blog index
- tag landing under insights
- insights listing

## Requires capabilities

`articles`

## Prerequisites

- Read `cms-edit://customer/insights-hub-pages` (full playbook)
- Fetch live `{path}.md` and read `contentType` before open
- `cms_edit ["index", "sync"]` when templates or articles may be stale

## Steps

1. Confirm the URL is hub (`articleType`) or tag listing (`articleTypeTag`) — not `/insights/{articleSlug}/`
2. `list --type articleType` or `list --type tag`; `open --id` — never `--page-slug insights`
3. `snapshot`
4. Update **Blog index hero** / **Blog category hero**, newsletter embed (once), related-articles heading
5. `preview urls` on staging
6. `diff` → `save` → `task-publish-handoff`