Repo conventions template

Copy into consuming repos when retrofitting apply-work-tracking. Replace {{…}} placeholders.

AGENTS.md section

## Plans and Notion product board

WIP plans, ADRs, and epics with high-level tracking live on the WU
**[HoEN Product Board](https://app.notion.com/p/wue/263e0376fa44807dbd4bc9c61619c52b)**
in Notion (`Component type` = **{{COMPONENT_TYPE}}** for this repo). {{PRODUCT_NOTE}}
Repo truth stays in `docs/planning/`, `docs/wip/`, and optional `*.effort.json`
sidecars; the board is for priorities, phase summaries, and team discussion.

**When you update a plan or record progress in the repo**, check whether a linked
Notion card exists and refresh it in the same session:

| Repo change | Notion fields to review |
| --- | --- |
| `*.effort.json` step/group status | **Pct complete**, **Progress headline**, effort/step/phase numbers, **Current plan phase**, **Status** |
| ADR decision status (accepted / open / superseded) | **Status**, **Progress headline**, **Plan doc** |
| Plan promoted, archived, or renamed | **Plan doc**, **Plan ID**, **Ship note** |

Lookup: **Plan ID** matches the plan slug or ADR id (e.g.
`{{PLAN_ID_EXAMPLE}}`). Linked plans and ADRs should say so in a
**Product board (Notion)** section near the top of the doc.

Effort totals come from the HoEN library **`plan-effort-estimate`** skill
(`validate-effort.mjs` / `summarize-effort.mjs`) — do not hand-calculate numbers
 pasted onto the board.

Placeholder notes

Placeholder	Example
{{COMPONENT_TYPE}}	WUE Website · ImpactStack · HoEN Library
{{PRODUCT_NOTE}}	For ImpactStack repos: “Use Product on the board for ImpactStack modules (Workshop, Coordinated Assessment, Self Service SaaS) when relevant.” For others: omit or shorten.
{{PLAN_ID_EXAMPLE}}	articles-migration-from-wix, adr-001-article-rendering-and-ssr

README.md paragraph

Plan and ADR progress for this repo is mirrored on the WU
**[HoEN Product Board](https://app.notion.com/p/wue/263e0376fa44807dbd4bc9c61619c52b)**
(`Component type` = **{{COMPONENT_TYPE}}**). When you update plan progress or ADR
status in git, refresh the linked Notion card in the same session — see
[AGENTS.md § Plans and Notion product board](AGENTS.md#plans-and-notion-product-board).

CONVENTIONS.md pointer

### Plans and Notion product board

When plan progress or ADR status changes in git, update the corresponding Notion
card on the [HoEN Product Board](https://app.notion.com/p/wue/263e0376fa44807dbd4bc9c61619c52b).
See [AGENTS.md § Plans and Notion product board](AGENTS.md#plans-and-notion-product-board).

Plan / ADR doc block

## Product board (Notion)

High-level tracking for this {{WORK_KIND}} lives on the WU
**[HoEN Product Board](https://app.notion.com/p/wue/263e0376fa44807dbd4bc9c61619c52b)**{{EFFORT_NOTE}}.

| Field | Value |
| --- | --- |
| **Notion card** | [{{CARD_TITLE}}]({{CARD_URL}}) |
| **Plan ID** | `{{PLAN_ID}}` |
| **Component type** | {{COMPONENT_TYPE}} |
| **Work type** | {{WORK_TYPE}} |

When {{SYNC_TRIGGER}}, update the Notion card (**Status**, **Progress headline**{{EXTRA_FIELDS}}) in the same session. See [AGENTS.md § Plans and Notion product board]({{AGENTS_REL_PATH}}).

Placeholder	Epic with effort	ADR
{{EFFORT_NOTE}}	omit	— not in-repo effort JSON
{{EXTRA_FIELDS}}	, effort rollups	, **Plan doc** link
{{SYNC_TRIGGER}}	effort or phase status changes	accepted/open decisions change