@hippo-digital/hippocampus 1.0.0-rc.1

package/skills/triage-research-corpus.skill.md

@@ -0,0 +1,51 @@
+---
+id: triage-research-corpus
+title: Triage research corpus
+purpose: Rank a large research folder into ingestion contenders before any artefact is imported.
+owners:
+  - ingestion-curator
+  - workflow-orchestrator
+composes:
+  - ingest-research-round
+reads:
+  - node_modules/@hippo-digital/hippocampus/docs/repeatable-research-round-ingestion.md
+  - node_modules/@hippo-digital/hippocampus/docs/research-source-file-conventions.md
+  - node_modules/@hippo-digital/hippocampus/docs/source-model.md
+edits:
+  - artefacts/research-triage/
+runs:
+  - npx hippocampus research triage -- --source "[folder]" --topic [topic]
+outputs:
+  - Ranked triage report in artefacts/research-triage/
+  - Tiered contender list mapped to Hippocampus record types
+guardrails:
+  - Do not copy artefacts into hippocampus/inbox/ during triage.
+  - Do not edit hippocampus/source/ or promote anything.
+  - Report the format coverage gap rather than silently ignoring unsupported files.
+acceptance:
+  - Every file in the source folder appears in the report or in the needs-handling list.
+  - Contenders are tiered and mapped to the records they would become.
+  - Files the pipeline cannot read today are named explicitly.
+---
+
+# Triage research corpus
+
+## Use when
+- A shared drive or SharePoint export holds far more research material than one round's worth.
+- You need to decide what is worth ingesting before spending review effort on drafts.
+
+## Workflow
+1. Run `npx hippocampus research triage -- --source "[folder]" --topic [topic]` against the folder. It reads only; nothing is copied or imported.
+2. Read the coverage-gap table first. It shows how much of the corpus the ingestion pipeline can currently read.
+3. Work down the tiers. Tier 1 files are the ones to move into `hippocampus/inbox/research/` first.
+4. For each Tier 1 file, check the "Becomes" column against `app/lib/hippocampus/schema.js` and confirm the mapping is real, not just keyword noise.
+5. Sequence ingestion so records land in dependency order: users, then needs, then evidence, then scenarios, journeys, screens, decisions.
+6. Feed the chosen files into `ingest-research-round` one round at a time.
+
+## Guardrails
+- Triage ranks candidates; it does not judge whether the content is true. A high score means "worth a human read", not "ready to promote".
+- Do not copy artefacts into the inbox during triage.
+- Do not edit `hippocampus/source/` or promote anything.
+
+## Finish
+- Report the triage file path, the number of Tier 1 contenders, the format coverage gap, and the recommended ingestion order.

package/skills/write-delivery-summary.skill.md

@@ -0,0 +1,51 @@
+---
+id: write-delivery-summary
+title: Write delivery summary
+purpose: Capture a durable handover note for multi-step Hippocampus work.
+owners:
+  - workflow-orchestrator
+composes:
+  - audit-knowledge-source
+reads:
+  - node_modules/@hippo-digital/hippocampus/docs/agent-workflow.md
+  - node_modules/@hippo-digital/hippocampus/docs/agent-workflow.md
+  - artefacts/delivery-summaries/
+edits:
+  - artefacts/delivery-summaries/[yyyy-mm-dd-topic].md
+runs:
+  - git --no-pager status --short
+outputs:
+  - Dated summary under artefacts/delivery-summaries/
+  - Reviewable record of commands, outcomes, and follow-up
+guardrails:
+  - Do not treat the summary as source of truth.
+  - Do not omit failed checks or unresolved risks.
+  - Do not claim promotion happened unless the promotion command really ran.
+acceptance:
+  - The summary includes what changed, what ran, and unresolved risks.
+  - Failed checks or unrun steps are stated explicitly.
+  - The summary path is reported.
+---
+
+# Write delivery summary
+
+## Use when
+- A multi-step change needs a durable review note for handover, design review, or later promotion.
+- Orchestrated work has touched source data, prototype views, import drafts, or generated artefacts.
+
+## Workflow
+1. Capture the request or outcome being delivered in one sentence.
+2. List the records, routes, views, drafts, or docs changed.
+3. Record the commands actually run and their results, especially `npx hippocampus validate`, `npx hippocampus doctor`, and any dry-run promotion checks.
+4. Record assumptions added, warnings left in drafts, blockers, and the smallest sensible next step.
+5. Write the summary to `artefacts/delivery-summaries/<YYYY-MM-DD>-<topic>.md`.
+
+## Guardrails
+- Do not treat the summary as source of truth.
+- Do not omit failed checks or unresolved risks.
+- Do not claim promotion happened unless the promotion command really ran.
+
+## Finish
+- Run `git --no-pager status --short`.
+- Report the summary path and any remaining follow-up items.
+

package/skills/write-route-review-summary.skill.md

@@ -0,0 +1,55 @@
+---
+id: write-route-review-summary
+title: Write route review summary
+purpose: Combine smoke, screenshot, and accessibility evidence into one route-review handover note.
+owners:
+  - workflow-orchestrator
+  - screenshot-runner
+  - accessibility-tester
+composes:
+  - capture-route-review-pack
+  - record-accessibility-review
+  - write-delivery-summary
+reads:
+  - node_modules/@hippo-digital/hippocampus/docs/agent-workflow.md
+  - artefacts/screenshots/README.md
+  - artefacts/accessibility/README.md
+  - artefacts/delivery-summaries/README.md
+edits:
+  - artefacts/delivery-summaries/[yyyy-mm-dd-topic]-route-review.md
+runs:
+  - git --no-pager status --short
+outputs:
+  - Dated route-review summary under artefacts/delivery-summaries/
+  - Linked references to screenshot and accessibility artefacts
+guardrails:
+  - Do not claim a screenshot pack or accessibility pass exists unless the artefact file exists.
+  - Keep the summary review-focused rather than restating all code changes.
+  - Keep failed checks and unresolved issues visible.
+acceptance:
+  - The summary distinguishes screenshots, notes-only evidence, and code-based review.
+  - Missing artefacts or unresolved blockers stay visible.
+  - The summary path is reported.
+---
+
+# Write route review summary
+
+## Use when
+- A route or view change has screenshot notes, accessibility findings, or smoke-test results that need one handover summary.
+- You want a durable review note rather than scattered comments across artefact folders.
+
+## Workflow
+1. Collect the smoke-test result, screenshot manifest, accessibility note, and any relevant route or template changes.
+2. Write `artefacts/delivery-summaries/<YYYY-MM-DD>-<topic>-route-review.md` with the review scope, routes checked, evidence created, blockers, follow-up improvements, and the smallest next action.
+3. Link back to screenshot and accessibility artefacts rather than duplicating their full content.
+4. State clearly if the review used screenshots, route notes, code inspection, or a mixture.
+
+## Guardrails
+- Do not claim a screenshot pack or accessibility pass exists unless the artefact file exists.
+- Keep the summary review-focused rather than restating all code changes.
+- Keep failed checks and unresolved issues visible.
+
+## Finish
+- Run `git --no-pager status --short`.
+- Report the summary path and any blockers that still need implementation work.
+

package/views/hippocampus/_layout.html

@@ -0,0 +1,45 @@
+{#
+  The layout every Hippocampus view extends.
+
+  It extends the Prototype Kit's own template rather than the host's
+  layout.html, because a host may not have one, may not expose a head block,
+  and should not have to know this library needs either. Its stylesheet and
+  client JS come from the viewer's own router, so installing Hippocampus adds
+  no sass entry point and no stylesheet link to the host project.
+#}
+{% extends "prototype-kit-template.njk" %}
+
+{% block head %}
+  <link href="/nhsuk-frontend/nhsuk-frontend.min.css" rel="stylesheet">
+  <link href="{{ hippocampusAssets }}/hippocampus.css" rel="stylesheet">
+{% endblock %}
+
+{% block header %}
+  {{ header({
+    service: {
+      text: serviceName or knowledge.project.name or "Knowledge base",
+      href: basePath
+    }
+  }) }}
+{% endblock %}
+
+{% block footer %}
+  {{ footer({
+    meta: {
+      items: [
+        {
+          href: basePath,
+          text: "Knowledge base"
+        },
+        {
+          href: "/prototype-admin/reset?returnPage=" + (currentPage | urlencode),
+          text: "Reset data"
+        }
+      ]
+    }
+  }) }}
+{% endblock %}
+
+{% block bodyEnd %}
+  {{ super() }}
+{% endblock %}

package/views/hippocampus/blueprint-classic.html

@@ -0,0 +1,39 @@
+{% extends "hippocampus/_layout.html" %}
+{% from "hippocampus/components/_blueprint-cell.njk" import renderCell %}
+
+{% block pageTitle %}{{ blueprint.meta.journeyTitle }} matrix{% endblock %}
+
+{% block content %}
+  <a class="nhsuk-back-link" href="{{ basePath }}/journeys/{{ blueprint.journey.id }}/blueprint">Back to stacked blueprint</a>
+  <span class="nhsuk-caption-l">Classic service blueprint</span>
+  <h1>{{ blueprint.meta.journeyTitle }}</h1>
+
+  <div class="knowledge-matrix-wrap">
+    <table class="knowledge-matrix">
+      <thead>
+        <tr>
+          <th scope="col">Swimlane</th>
+          {% for step in blueprint.steps %}
+            <th scope="col">{{ step.label }}</th>
+          {% endfor %}
+        </tr>
+      </thead>
+      <tbody>
+        {% for lane in blueprint.lanes %}
+          <tr>
+            <th scope="row">{{ lane.label }}</th>
+            {% for step in blueprint.steps %}
+              <td>{{ renderCell(step, lane.key) }}</td>
+            {% endfor %}
+          </tr>
+          {% if lane.boundaryAfter %}
+            <tr class="knowledge-matrix__boundary">
+              <td colspan="{{ blueprint.steps.length + 1 }}">{{ lane.boundaryAfter }}</td>
+            </tr>
+          {% endif %}
+        {% endfor %}
+      </tbody>
+    </table>
+  </div>
+{% endblock %}
+

package/views/hippocampus/blueprint.html

@@ -0,0 +1,52 @@
+{% extends "hippocampus/_layout.html" %}
+{% from "hippocampus/components/_blueprint-cell.njk" import renderCell %}
+{% from "hippocampus/components/_blueprint-controls.njk" import renderBlueprintControls %}
+{% from "hippocampus/components/_blueprint-minimap.njk" import renderBlueprintMinimap %}
+
+{% block pageTitle %}{{ blueprint.meta.journeyTitle }} blueprint{% endblock %}
+
+{% block content %}
+  <a class="nhsuk-back-link" href="{{ basePath }}/journeys/{{ blueprint.journey.id }}">Back to journey</a>
+  <span class="nhsuk-caption-l">Stacked service blueprint</span>
+  <h1>{{ blueprint.meta.journeyTitle }}</h1>
+  <p class="nhsuk-lede-text">{{ blueprint.meta.scenarioTitle }}</p>
+
+  <p><a href="{{ basePath }}/journeys/{{ blueprint.journey.id }}/blueprint/classic">View classic matrix blueprint</a></p>
+
+  {{ renderBlueprintControls(blueprint.lanes) }}
+
+  <div class="knowledge-blueprint-layout">
+    {{ renderBlueprintMinimap(blueprint.steps) }}
+
+    <div class="knowledge-blueprint-steps">
+      {% for step in blueprint.steps %}
+        <section class="knowledge-blueprint-step" id="step-{{ step.id }}" data-step-id="{{ step.id }}">
+          <div class="knowledge-blueprint-step__header">
+            <h2 class="nhsuk-heading-m">{{ step.label }}</h2>
+            <span class="nhsuk-tag">{{ step.channel }}</span>
+          </div>
+
+          {% for lane in blueprint.lanes %}
+            <div class="knowledge-lane" data-lane="{{ lane.key }}" data-lenses="{{ lane.lenses | join(' ') }}">
+              <div class="knowledge-lane__label">
+                <h3>{{ lane.label }}</h3>
+              </div>
+              <div class="knowledge-lane__content">
+                {{ renderCell(step, lane.key) }}
+              </div>
+            </div>
+            {% if lane.boundaryAfter %}
+              <div class="knowledge-boundary">{{ lane.boundaryAfter }}</div>
+            {% endif %}
+          {% endfor %}
+        </section>
+      {% endfor %}
+    </div>
+  </div>
+{% endblock %}
+
+{% block bodyEnd %}
+  {{ super() }}
+  <script type="module" src="{{ hippocampusAssets }}/blueprint.js"></script>
+{% endblock %}
+

package/views/hippocampus/components/_blueprint-cell.njk

@@ -0,0 +1,42 @@
+{% from "hippocampus/components/_list.njk" import bulletList %}
+
+{% macro renderCell(step, laneKey) %}
+  {% if laneKey == "screens" %}
+    {% if step.screens.length %}
+      <ul class="nhsuk-list">
+        {% for screen in step.screens %}
+          <li><a href="{{ screen.route }}">{{ screen.title }}</a></li>
+        {% endfor %}
+      </ul>
+    {% else %}
+      <span class="knowledge-muted">No linked screens</span>
+    {% endif %}
+  {% elif laneKey == "userAction" %}
+    <p class="nhsuk-body-s">{{ step.userAction }}</p>
+  {% elif laneKey == "painPoints" %}
+    {% for painPoint in step.painPoints %}
+      <div class="knowledge-tagged-item knowledge-tagged-item--{{ painPoint.severity }}">
+        <strong>{{ painPoint.severity | upper }}</strong>
+        <span>{{ painPoint.label }}</span>
+      </div>
+    {% endfor %}
+  {% elif laneKey == "exceptionHandling" %}
+    {{ bulletList(step.exceptionHandling) }}
+  {% elif laneKey == "evidence" %}
+    {% if step.evidence.length or step.decisions.length %}
+      <ul class="nhsuk-list">
+        {% for evidence in step.evidence %}
+          <li><strong>Evidence:</strong> {{ evidence.title }}</li>
+        {% endfor %}
+        {% for decision in step.decisions %}
+          <li><strong>Decision:</strong> {{ decision.title }}</li>
+        {% endfor %}
+      </ul>
+    {% else %}
+      <span class="knowledge-muted">None linked</span>
+    {% endif %}
+  {% else %}
+    {% set items = step[laneKey] %}
+    {{ bulletList(items, "Not defined") }}
+  {% endif %}
+{% endmacro %}

package/views/hippocampus/components/_blueprint-controls.njk

@@ -0,0 +1,20 @@
+{% macro renderBlueprintControls(lanes) %}
+  <div class="knowledge-blueprint-controls" data-blueprint-controls>
+    <div class="knowledge-blueprint-controls__lenses" role="group" aria-label="Blueprint lens presets">
+      <button type="button" class="knowledge-lens-btn" data-lens="all" aria-pressed="true">All</button>
+      <button type="button" class="knowledge-lens-btn" data-lens="executive" aria-pressed="false">Executive</button>
+      <button type="button" class="knowledge-lens-btn" data-lens="technical" aria-pressed="false">Technical</button>
+      <button type="button" class="knowledge-lens-btn" data-lens="risk" aria-pressed="false">Risk</button>
+    </div>
+
+    <fieldset class="knowledge-blueprint-controls__lanes">
+      <legend>Show or hide lanes</legend>
+      {% for lane in lanes %}
+        <span class="knowledge-lane-toggle">
+          <input type="checkbox" id="lane-toggle-{{ lane.key }}" data-lane-toggle="{{ lane.key }}" checked>
+          <label for="lane-toggle-{{ lane.key }}">{{ lane.label }}</label>
+        </span>
+      {% endfor %}
+    </fieldset>
+  </div>
+{% endmacro %}

package/views/hippocampus/components/_blueprint-minimap.njk

@@ -0,0 +1,14 @@
+{% macro renderBlueprintMinimap(steps) %}
+  <nav class="knowledge-blueprint-minimap" aria-label="Jump to step" data-blueprint-minimap>
+    <ul>
+      {% for step in steps %}
+        <li>
+          <a href="#step-{{ step.id }}" data-minimap-step="{{ step.id }}">
+            <span class="knowledge-blueprint-minimap__marker" aria-hidden="true">{{ loop.index }}</span>
+            <span class="nhsuk-u-visually-hidden">{{ step.label }}</span>
+          </a>
+        </li>
+      {% endfor %}
+    </ul>
+  </nav>
+{% endmacro %}

package/views/hippocampus/components/_empty-state.njk

@@ -0,0 +1,12 @@
+{#
+  One macro rather than 17 rewritten views. A freshly initialised knowledge base
+  renders every route; each page that has nothing to show says what belongs
+  there and how to put it there, instead of an empty container or a crash.
+#}
+{% macro emptyState(title, explanation, hint) %}
+  <div class="knowledge-empty-state">
+    <h2 class="nhsuk-heading-m">{{ title }}</h2>
+    <p>{{ explanation }}</p>
+    {% if hint %}<p class="knowledge-muted">{{ hint }}</p>{% endif %}
+  </div>
+{% endmacro %}

package/views/hippocampus/components/_journey-step.njk

@@ -0,0 +1,21 @@
+{% macro journeyStep(step, knowledge) %}
+  <li class="knowledge-timeline__item">
+    <h2 class="nhsuk-heading-m">{{ step.label }}</h2>
+    <p>{{ step.userAction }}</p>
+
+    <h3 class="nhsuk-heading-s">Linked screens</h3>
+    <ul class="nhsuk-list">
+      {% for screenId in step.screenIds %}
+        {% set screen = knowledge.index.screens[screenId] %}
+        <li><a href="{{ screen.route }}">{{ screen.title }}</a></li>
+      {% endfor %}
+    </ul>
+
+    <h3 class="nhsuk-heading-s">User needs</h3>
+    <ul class="nhsuk-list nhsuk-list--bullet">
+      {% for needId in step.needIds %}
+        <li>{{ knowledge.index.needs[needId].statement }}</li>
+      {% endfor %}
+    </ul>
+  </li>
+{% endmacro %}

package/views/hippocampus/components/_list.njk

@@ -0,0 +1,23 @@
+{% macro bulletList(items, emptyText) %}
+  {% if items and items.length %}
+    <ul class="nhsuk-list nhsuk-list--bullet">
+      {% for item in items %}
+        <li>{{ item }}</li>
+      {% endfor %}
+    </ul>
+  {% else %}
+    <span class="knowledge-muted">{{ emptyText or "Not defined" }}</span>
+  {% endif %}
+{% endmacro %}
+
+{% macro plainList(items, emptyText) %}
+  {% if items and items.length %}
+    <ul class="nhsuk-list">
+      {% for item in items %}
+        <li>{{ item }}</li>
+      {% endfor %}
+    </ul>
+  {% else %}
+    <span class="knowledge-muted">{{ emptyText or "None linked" }}</span>
+  {% endif %}
+{% endmacro %}

package/views/hippocampus/components/_summary-card.njk

@@ -0,0 +1,15 @@
+{% macro summaryCard(title, body, href, meta) %}
+  <div class="knowledge-card">
+    {% if meta %}
+      <p class="knowledge-card__meta">{{ meta }}</p>
+    {% endif %}
+    <h2 class="nhsuk-heading-s nhsuk-u-margin-bottom-2">
+      {% if href %}
+        <a href="{{ href }}">{{ title }}</a>
+      {% else %}
+        {{ title }}
+      {% endif %}
+    </h2>
+    <p class="nhsuk-body-s nhsuk-u-margin-bottom-0">{{ body }}</p>
+  </div>
+{% endmacro %}

package/views/hippocampus/doc.html

@@ -0,0 +1,11 @@
+{% extends "hippocampus/_layout.html" %}
+
+{% block pageTitle %}{{ doc.title }}{% endblock %}
+
+{% block content %}
+  <a class="nhsuk-back-link" href="{{ basePath }}/docs">Back to documentation</a>
+  <article class="knowledge-doc">
+    {{ doc.html | safe }}
+  </article>
+  <p class="knowledge-muted">@hippo-digital/hippocampus {{ packageVersion }}</p>
+{% endblock %}

package/views/hippocampus/docs.html

@@ -0,0 +1,19 @@
+{% extends "hippocampus/_layout.html" %}
+
+{% block pageTitle %}Documentation{% endblock %}
+
+{% block content %}
+  <a class="nhsuk-back-link" href="{{ basePath }}">Back to knowledge base</a>
+  <h1>Documentation</h1>
+  <p class="nhsuk-lede-text">These guides ship with the package, so they always describe the version you have installed.</p>
+  <p class="knowledge-muted">@hippo-digital/hippocampus {{ packageVersion }}</p>
+
+  <div class="knowledge-grid">
+    {% for doc in docs %}
+      <div class="knowledge-card">
+        <h2 class="nhsuk-heading-s"><a href="{{ basePath }}/docs/{{ doc.slug }}">{{ doc.title }}</a></h2>
+        {% if doc.summary %}<p>{{ doc.summary }}</p>{% endif %}
+      </div>
+    {% endfor %}
+  </div>
+{% endblock %}

package/views/hippocampus/evidence-impact.html

@@ -0,0 +1,53 @@
+{% extends "hippocampus/_layout.html" %}
+
+{% block pageTitle %}Evidence impact - {{ impact.evidence.title }}{% endblock %}
+
+{% block content %}
+  <a class="nhsuk-back-link" href="{{ basePath }}/graph">Back to relationship graph</a>
+
+  <span class="nhsuk-caption-l">Evidence impact</span>
+  <h1>{{ impact.evidence.title }}</h1>
+  <p class="nhsuk-lede-text">{{ impact.evidence.summary }}</p>
+
+  <div class="knowledge-graph-summary">
+    <div><strong>{{ impact.directRelationships.length }}</strong><span>Direct links</span></div>
+    <div><strong>{{ impact.impactedEntities.length }}</strong><span>Impacted entities</span></div>
+    <div><strong>{{ impact.evidence.confidence }}</strong><span>Confidence</span></div>
+  </div>
+
+  {% if impact.evidence.quotes %}
+    <section class="knowledge-section">
+      <h2>Quoted signals</h2>
+      <ul class="nhsuk-list nhsuk-list--bullet">
+        {% for quote in impact.evidence.quotes %}
+          <li>&ldquo;{{ quote }}&rdquo;</li>
+        {% endfor %}
+      </ul>
+    </section>
+  {% endif %}
+
+  <section class="knowledge-section">
+    <h2>Impacted entities</h2>
+    <div class="knowledge-graph">
+      {% for entity in impact.impactedEntities %}
+        <article class="knowledge-graph__node knowledge-graph__node--{{ entity.type | lower }}">
+          <strong>{{ entity.type }}</strong>
+          <span>{{ entity.label }}</span>
+        </article>
+      {% endfor %}
+    </div>
+  </section>
+
+  <section class="knowledge-section">
+    <h2>Impact path</h2>
+    <ul class="nhsuk-list knowledge-edge-list">
+      {% for relationship in impact.relationships %}
+        <li>
+          <strong>{{ relationship.fromLabel }}</strong>
+          <span>{{ relationship.label }}</span>
+          <strong>{{ relationship.toLabel }}</strong>
+        </li>
+      {% endfor %}
+    </ul>
+  </section>
+{% endblock %}

package/views/hippocampus/graph.html

@@ -0,0 +1,48 @@
+{% extends "hippocampus/_layout.html" %}
+
+{% block pageTitle %}Relationship graph{% endblock %}
+
+{% block content %}
+  <a class="nhsuk-back-link" href="{{ basePath }}">Back to knowledge base</a>
+
+  <span class="nhsuk-caption-l">Knowledge graph</span>
+  <h1>Relationship graph</h1>
+  <p class="nhsuk-lede-text">Explicit relationships from the knowledge source, shown as entities and typed links.</p>
+
+  <div class="knowledge-graph-summary">
+    <div><strong>{{ graph.nodes.length }}</strong><span>Linked entities</span></div>
+    <div><strong>{{ graph.relationships.length }}</strong><span>Relationships</span></div>
+    <div><strong>{{ graph.relationshipTypes.length }}</strong><span>Relationship types</span></div>
+  </div>
+
+  <section class="knowledge-section">
+    <h2>Entities</h2>
+    <div class="knowledge-graph">
+      {% for node in graph.nodes %}
+        <article class="knowledge-graph__node knowledge-graph__node--{{ node.type | lower }}">
+          <strong>{{ node.type }}</strong>
+          <span>{{ node.label }}</span>
+        </article>
+      {% endfor %}
+    </div>
+  </section>
+
+  <section class="knowledge-section">
+    <h2>Relationships</h2>
+    <ul class="nhsuk-list knowledge-edge-list">
+      {% for relationship in graph.relationships %}
+        <li>
+          <strong>{{ relationship.fromLabel }}</strong>
+          <span>{{ relationship.label }}</span>
+          <strong>
+            {% if relationship.toType == "Evidence" %}
+              <a href="{{ basePath }}/evidence/{{ relationship.to }}/impact">{{ relationship.toLabel }}</a>
+            {% else %}
+              {{ relationship.toLabel }}
+            {% endif %}
+          </strong>
+        </li>
+      {% endfor %}
+    </ul>
+  </section>
+{% endblock %}

package/views/hippocampus/handover-empty.html

@@ -0,0 +1,12 @@
+{% extends "hippocampus/_layout.html" %}
+{% from "hippocampus/components/_empty-state.njk" import emptyState %}
+
+{% block pageTitle %}Handover{% endblock %}
+
+{% block content %}
+  <a class="nhsuk-back-link" href="{{ basePath }}">Back to knowledge base</a>
+  <h1>Handover</h1>
+  {{ emptyState("Nothing to hand over yet",
+    "Handover documentation is generated from a journey - its steps, the screens they touch and the needs and evidence behind them. There are no journeys in this knowledge base.",
+    "Add a scenario, then turn it into a journey with the create-journey-from-scenario skill.") }}
+{% endblock %}

package/views/hippocampus/handover.html

@@ -0,0 +1,56 @@
+{% extends "hippocampus/_layout.html" %}
+
+{% block pageTitle %}Handover - {{ blueprint.meta.journeyTitle }}{% endblock %}
+
+{% block content %}
+  <a class="nhsuk-back-link" href="{{ basePath }}">Back to knowledge base</a>
+  <span class="nhsuk-caption-l">Generated documentation</span>
+  <h1>Handover summary</h1>
+  <p class="knowledge-card__meta">{{ blueprint.meta.journeyTitle }}</p>
+  <p class="nhsuk-lede-text">This page is rendered from the same structured source as the prototype screens, journey and blueprint.</p>
+
+  <h2>Artefacts</h2>
+  <ul class="nhsuk-list nhsuk-list--bullet">
+    <li><a href="{{ basePath }}/journeys/{{ blueprint.journey.id }}">Journey map</a></li>
+    <li><a href="{{ basePath }}/journeys/{{ blueprint.journey.id }}/blueprint">Stacked blueprint</a></li>
+    <li><a href="{{ basePath }}/journeys/{{ blueprint.journey.id }}/blueprint/classic">Classic matrix blueprint</a></li>
+    {% for screen in screens %}
+      <li><a href="{{ screen.route }}">Prototype screen: {{ screen.title }}</a></li>
+    {% endfor %}
+  </ul>
+
+  <h2>Scenario</h2>
+  <div class="knowledge-card">
+    <p class="knowledge-card__meta">{{ blueprint.scenario.riskLevel }} risk</p>
+    <h3 class="nhsuk-heading-s">{{ blueprint.scenario.title }}</h3>
+    <p>{{ blueprint.scenario.context }}</p>
+    <p><strong>Trigger:</strong> {{ blueprint.scenario.trigger }}</p>
+  </div>
+
+  <h2>Journey steps</h2>
+  <ol class="nhsuk-list nhsuk-list--number">
+    {% for step in blueprint.steps %}
+      <li>
+        <strong>{{ step.label }}</strong><br>
+        {{ step.userAction }}
+      </li>
+    {% endfor %}
+  </ol>
+
+  <h2>Decisions</h2>
+  {% for decision in knowledge.decisions %}
+    <div class="knowledge-card">
+      <p class="knowledge-card__meta">{{ decision.status }}</p>
+      <h3 class="nhsuk-heading-s">{{ decision.title }}</h3>
+      <p>{{ decision.decision }}</p>
+      <p><strong>Consequence:</strong> {{ decision.consequence }}</p>
+    </div>
+  {% endfor %}
+
+  <h2>Assumptions</h2>
+  <ul class="nhsuk-list nhsuk-list--bullet">
+    {% for assumption in knowledge.assumptions %}
+      <li><strong>{{ assumption.risk }} risk:</strong> {{ assumption.statement }}</li>
+    {% endfor %}
+  </ul>
+{% endblock %}