← All playbooks · Raw API

pages

# Pages — Headwater Science

General playbook for **marketing pages** (not news or publication articles). Use specialized playbooks when the page type is known:

| Page type | Playbook |
|-----------|----------|
| Technology, services, evidence, solutions | `cms-edit://customer/service-pages` |
| Resources & tag listing indexes | `cms-edit://customer/resources-hub-pages` |
| News article | `cms-edit://customer/news-pages` |
| Publication article | `cms-edit://customer/publications-pages` |
| Any article (routing, tags) | `cms-edit://customer/articles` |
| Team / author person entry | `cms-edit://customer/people` |
| Legal / policy | `cms-edit://customer/legal-policy-pages` |

## When to use

- New or updated pages under `/`, `/about/`, `/technology/`, service/evidence paths, `/contact-us/`, `/careers/`
- Cloning structure from an existing page before tailoring copy

Read `cms-edit://customer/routing` and `cms-edit://customer/production-site`. Fetch live markdown with `.md` appended (e.g. `https://www.headwaterscience.com/about.md`).

**Homepage:** CMS slug **`index`** (public `/`). Open with `cms-edit open /` or `--page-slug /index`.

**Slug check:** Production URLs may differ from draft CMS slugs (e.g. `/advisory-services/` vs `/scientific-services/`). Run `cms-edit list --type page` or `peek --page-slug` before editing.

## Templates

```bash
cms-edit list --type template
```

Use the **general page template** for marketing pages. Inspect with `cms-edit peek --page-slug /about`.

## Reference pages (clone sources)

| Public path | Category | Notes |
|-------------|----------|-------|
| `/` | Home | Image hero + full-screen slides (Methods, Technology, Consulting) |
| `/about/` | About | Split hero, feature split, leadership grid, action cards |
| `/technology/` | Product | Image hero, feature splits (causalStudio™, causalPHR™), benefits, action cards |
| `/scientific-services/` or `/advisory-services/` | Services | Image hero + benefits collections (study design, governance) |
| `/evidence/` or `/evidence-partnerships/` | Evidence | Image hero + study-type benefits cards |
| `/solutions/` | Solutions hub | If present — verify slug in CMS |
| `/contact-us/` | Contact | Pardot form external |
| `/careers/` | Careers | Application CTA with background visual |
| `/privacy-policy/` | Legal | Split hero + legal rich text |

Use `cms-edit://customer/task-clone-page` when mirroring layout.

Page-by-page field maps: `apps/headwater-website/docs/cms-guide.md`.

## Document section → component mapping

| Brief section | Component / collection |
|---------------|------------------------|
| Hero with image | **Image hero** or **Split hero** |
| Split image + copy | **Feature split** / **Feature split reverse** |
| Product pillars | **Full screen slides** + **Generic** slide items |
| Capability cards | **Benefits** (sticky intro + stacked cards) |
| Engagement / pearl cards | **Action cards** |
| Leadership | **Leadership** collection → **Person** entries |
| Careers CTA | **Application CTA** |
| Contact form | **Pardot form** external |
| Legal body | **Legal rich text** |
| Fallback | **Generic** |

## Creating pages

1. Read `cms-edit://customer/tasks-index` → `task-create-page` or `task-create-from-document`
2. `cms-edit index sync` if catalog may be stale
3. Pick general template; set `slug`, `title`, `description`, `featuredImage`
4. Build content stack; `create from-json --dry-run --strict` before save
5. Set `heading` then `cmsLabel` after each `add`
6. `diff` → `save` (draft only)

## Out of scope

- Article detail pages — `news-pages` / `publications-pages`
- Person profiles — `people.md`
- Tag listing URLs — `resources-hub-pages`
- `/search/` — utility page

## Publish handoff

`save` creates drafts only — publish in Contentful UI when approved.