diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml index 611b0b4..2275483 100644 --- a/.github/workflows/tests.yml +++ b/.github/workflows/tests.yml @@ -94,6 +94,8 @@ jobs: - run: npm run build + - run: node --experimental-strip-types --test src/data/navigation.test.mjs + - run: npm run check:presentations - run: node --experimental-strip-types --test src/data/mind-nervous-system-body-slides.test.mjs diff --git a/CHANGELOG.md b/CHANGELOG.md index c5281f9..beeece1 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -5,6 +5,24 @@ All notable changes to this project will be documented in this file. Format follows [Keep a Changelog](https://keepachangelog.com/). This project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). +## [0.19.0] - 2026-07-26 + +### Added + +- Reusable Astro design-system foundations: named layout and typography roles plus shared section-intro, destination-card, structured-card, closing-band, and terminal patterns. +- A guided three-session Devague capture story with accessible transcript evidence, human-gate previews, and a reshaped pipeline reference. +- Focused regression coverage for navigation and presentations, with Devague story anchors validated when the site builds. + +### Changed + +- Unified the site header, primary navigation, grouped footer, agent directory, and library destinations, including a sticky header and clearer internal and external link treatments. +- Migrated the four agent profiles and current library, article, and presentation surfaces onto reusable patterns while preserving their bespoke compositions. +- Consolidated the UX review into current spec, plan, and delivery records; removed generated review snapshots and superseded decision material; automatic future-page adoption remains deferred. + +### Fixed + +- Improved diagram spacing, agent-page code and terminal treatments, destination clarity, and presentation contract coverage across responsive layouts. + ## [0.18.2] - 2026-07-22 ### Changed diff --git a/README.md b/README.md index 6404455..ced0014 100644 --- a/README.md +++ b/README.md @@ -56,6 +56,13 @@ provisioned Cloudflare state and the DNS cutover procedure are recorded in [`docs/deploy-runbook.md`](docs/deploy-runbook.md). DNS for AgentCulture.org is operator-owned, so cutover is coordinated, not self-serve. +The adopted navigation, design-system, agent-page, and Devague decisions are +summarized in the +[`site-ux-review` delivery record](docs/deliveries/2026-07-21-site-ux-review.md). +Use that record and the implementation as the current source of truth; the +Astro build plus focused navigation and presentation tests provide regression +coverage. + Two things worth knowing if you're extending it: the sibling repos' `publish.yml` are all **PyPI** workflows, not deploy templates — this repo's deploy workflow was written fresh, in the filename slot the removed diff --git a/docs/deliveries/2026-07-21-site-ux-review.md b/docs/deliveries/2026-07-21-site-ux-review.md new file mode 100644 index 0000000..fe9978c --- /dev/null +++ b/docs/deliveries/2026-07-21-site-ux-review.md @@ -0,0 +1,69 @@ +# Delivery Summary — site-ux-review + +plan: `site-ux-review` · run: `complete` · date: `2026-07-26` · draft PR: +[#30](https://github.com/agentculture/org/pull/30) + +## Intent + +Turn a measured review of the original site into reusable foundations +for the current twelve-route Astro build. Preserve the site's visual identity +and bespoke page compositions while making navigation, wayfinding, destination +cues, long-form openings, information cards, terminal treatments, and Devague +evidence easier to understand and maintain. + +## Actual Delivery + +| Plan task | Status | What landed | +|---|---|---| +| `t1` shared system | delivered | Named type, leading, tracking, rail, measure, diagram-spacing, and sticky-header roles with explicit container ownership. | +| `t2` navigation and destinations | delivered | Typed grouped header, grouped sitemap footer, stable agent groups, capped Library features, external Learn product, whole-card destinations, and safe external cues. | +| `t3` agent-page patterns | delivered | Shared `SectionIntro`, `StructuredCard`, `DestinationCard`, `ClosingBand`, and inline-code treatments; aligned terminal and diagram rules; bespoke compositions retained. | +| `t4` Devague | delivered | Three guided sessions, fourteen source-anchored excerpts, accessible full transcripts, read-only gate previews, repaired flow sequence, and a ruled seven-stage pipeline reference. | +| `t5` reconciliation | delivered | Breadcrumbs/local navigation experiments removed, focused navigation and presentation coverage retained, version advanced to `0.19.0`, and review artifacts consolidated into this record set. | + +## Final Decisions + +| Direction | Final status | Reason | +|---|---|---| +| Typed grouped navigation and sitemap footer | adopted | Keeps route ownership, current states, featured coverage, and Learn's external ownership explicit. | +| Whole-card destination links with visible kind | adopted | Resolves the directory's target-size and destination-ambiguity findings together. | +| Shared semantic components | adopted | Reduces repeated presentation decisions without forcing unrelated content into one visual primitive. | +| Guided Devague sessions and transcript modal | adopted | Teaches the evidence while preserving complete, verbatim captures. | +| Ruled pipeline reference list | adopted | Keeps the animated flow primary and makes the stage detail quieter lookup material. | +| Directory filter and sticky jump list | superseded | Stable group fragments and grouped navigation provide the accepted wayfinding without another control surface. | +| Generic `AgentPage` and `Terminal` components | deferred | The four pages share design rules but still have meaningfully different structures and terminal contracts. | +| Breadcrumbs and local contents navigation | deferred | They were removed from this PR pending a separate information-architecture decision. | +| Automatic adoption by future pages | deferred | New pages must choose semantic components deliberately. | +| Generated review pages and static snapshots | retired | Source and these records now contain the accepted decisions. | + +## Evidence + +- Astro production build: twelve static routes +- navigation: six focused behavior tests +- delivered inventory: 28 authored section-introduction calls render 35 + openings; 12 structured-card calls render 70 cards +- Devague build input: three sessions and fourteen source-anchored excerpts +- presentations: 23 built-page checks and 20 slide-data tests +- Python test, coverage, formatting, lint, security, Markdown, local-link, and + strict repository-doctor lanes pass on the final branch + +## Source of Truth + +The implementation is authoritative for current behavior. The Astro build, +focused navigation tests, and retained presentation tests cover durable +regressions; this delivery records the final PR state. The matching +[spec](../specs/2026-07-21-site-ux-review.md) preserves accepted requirements, +and the [plan](../plans/2026-07-21-site-ux-review.md) preserves the delivery +sequence. + +Focused records cover the shared +[section introduction](2026-07-23-global-section-opener.md) and +[structured card](2026-07-23-global-structured-card.md) patterns. + +## Remaining Work + +- complete manual visual and keyboard review on the draft deploy preview +- decide breadcrumbs/local contents navigation separately +- consider broader agent-page or terminal abstraction only when another page + provides enough evidence for a stable interface +- keep Learn source and deployment in its owning project diff --git a/docs/deliveries/2026-07-23-global-section-opener.md b/docs/deliveries/2026-07-23-global-section-opener.md new file mode 100644 index 0000000..46f60a4 --- /dev/null +++ b/docs/deliveries/2026-07-23-global-section-opener.md @@ -0,0 +1,45 @@ +# Delivery Summary — global-section-opener + +plan: `global-section-opener` · run: `complete` · date: `2026-07-26` · draft +PR: [#30](https://github.com/agentculture/org/pull/30) + +## Intent + +Give long-form sections one accessible, readable opening grammar while +preserving the article's definitions and every page's bespoke downstream +composition. + +## Actual Delivery + +| Plan task | Status | What landed | +|---|---|---| +| `t1` shared component | delivered | `SectionIntro.astro` owns eyebrow, stable heading, optional post-title content, readable measures, title spacing, and reveal behavior. | +| `t2` agent profiles | delivered | Devague 6, Colleague 9, Lobes 5, and Reachy Mini CLI 7 authored calls; parent sections use matching `aria-labelledby` IDs. | +| `t3` article | delivered | One loop-authored call renders eight beat openings while definitions, lede styling, paragraph reveals, and evidence notes remain local. | +| `t4` validation | delivered | The production build and focused semantic/visual review covered ordering, measures, accessible labels, reveal behavior, and the presentation exclusion. | + +## Final Decisions + +- Agent sections use grouped introductory reveals; the article retains + paragraph-level reveals. +- The article's definitions use the named `after-title` slot rather than moving + into the shared component's data model. +- Agent headings use standard title spacing; the article keeps its relaxed + variant. +- Explicit template branches prevent absent reveal flags from becoming literal + false-valued data attributes. +- The presentation remains a separate slide pattern. + +## Evidence + +- delivery snapshot: 28 authored component calls render 35 section openings +- all five migrated routes retain stable heading IDs and labelled parent regions +- article heading → definitions → prose order is preserved in built output +- the seven-slide presentation renders no shared section-introduction markers +- the Astro production build passes + +## Boundaries + +- no copy, section order, route, breadcrumb, local-navigation, Learn, or + deployment change belongs to this component +- future pages must opt into the component deliberately diff --git a/docs/deliveries/2026-07-23-global-structured-card.md b/docs/deliveries/2026-07-23-global-structured-card.md new file mode 100644 index 0000000..c81c6d6 --- /dev/null +++ b/docs/deliveries/2026-07-23-global-structured-card.md @@ -0,0 +1,48 @@ +# Delivery Summary — global-structured-card + +plan: `global-structured-card` · run: `complete` · date: `2026-07-26` · draft +PR: [#30](https://github.com/agentculture/org/pull/30) + +## Intent + +Give matching agent-profile information cards one hierarchy and responsive grid +without turning every rectangular surface into the same component. + +## Actual Delivery + +| Plan task | Status | What landed | +|---|---|---| +| `t1` shared component | delivered | `StructuredCard.astro` owns optional metadata/footer, serif title, 16px body, featured span, reveal delay, and the responsive grid. | +| `t2` Devague | delivered | Method moves and operator skills use 2 authored calls for 14 cards; command titles retain code semantics. | +| `t3` Colleague | delivered | Five families use 5 authored calls for 25 cards; metadata and compact command footers retain their meaning. | +| `t4` Reachy and Lobes | delivered | Four Reachy families and one Lobes family use 5 authored calls for 31 cards. | +| `t5` validation | delivered | The production build and focused semantic/responsive review covered ordering, command treatment, absent copy controls, and explicit exclusions. | + +## Final Decisions + +- Shared treatment is based on the metadata/title/body/footer information model, + not visual similarity alone. +- Command titles remain selectable semantic code and do not become buttons. +- The Devague pipeline initially matched the card family, then moved to a ruled + reference list so the animated flow remained the section's visual + protagonist. Its seven rows are therefore excluded from the delivery + snapshot. +- Directory/library links, article evidence, terminals, tables, measured + statistics, gate previews, closing bands, and presentation cards stay local. + +## Evidence + +- delivery snapshot: 12 authored component calls render 70 cards across four + agent profiles +- route counts are Devague 14, Colleague 25, Reachy Mini CLI 25, and Lobes 6 +- built cards preserve metadata → title → body → footer order +- shared grids contain three-column desktop, two-column intermediate, and + one-column narrow rules +- excluded routes render no structured-card markers +- the Astro production build passes + +## Boundaries + +- no card adds clipboard behavior or a copy control +- future card families must match the semantic contract before adopting the + component diff --git a/docs/plans/2026-07-21-site-ux-review.md b/docs/plans/2026-07-21-site-ux-review.md new file mode 100644 index 0000000..15bf6c2 --- /dev/null +++ b/docs/plans/2026-07-21-site-ux-review.md @@ -0,0 +1,75 @@ +# Build Plan — site-ux-review + +slug: `site-ux-review` · status: `delivered in draft PR #30` + +> Convert the accepted UX-review findings into named shared patterns, migrate +> the current site, and leave a concise record of final decisions. + +## Tasks + +### t1 — Establish the shared system and containment rules + +- add named typography, leading, tracking, rail, measure, diagram-spacing, and + sticky-header roles to the global stylesheet +- assign every authored container an explicit rail without changing the + presentation deck's independent content width +- review token use, rail ownership, terminal legibility, diagram spacing, gate + previews, and the sticky header across representative pages +- acceptance: the production build succeeds for twelve routes and manual review + confirms the shared roles without flattening page-specific layouts + +### t2 — Unify navigation, wayfinding, and destinations + +- centralize header and footer navigation data, including grouped Agents and + Library menus and the external Learn product +- make agent-directory groups stable destinations and use whole-card links with + explicit destination labels +- apply the shared destination-card and external-link behaviors to matching + surfaces +- acceptance: focused navigation tests cover route ownership, grouped + destinations, footer derivation, and safe new-tab behavior; all links pass the + built-site link check + +### t3 — Extract proven agent-page patterns + +- add shared section-introduction, structured-card, closing-band, and inline-code + components +- migrate only the page families that match each semantic pattern +- align terminal legibility and diagram spacing while retaining the four + agent-specific terminal and diagram implementations +- acceptance: source review confirms repeated markup moved into shared + components while other card families and the presentation deck remain local + +### t4 — Complete the Devague story and pipeline + +- model three guided capture sessions and resolve every excerpt from the + immutable capture source +- add session, story-beat, transcript-modal, and read-only human-gate preview + treatments +- repair the flow sequence and replace the competing stage-card grid with a + ruled seven-row reference list +- acceptance: the Astro build resolves every story anchor, transcripts remain + complete and keyboard accessible, and the pipeline reference remains separate + from structured cards + +### t5 — Reconcile the final branch + +- remove experiments that did not survive review, including breadcrumbs and + local contents navigation +- record adopted, superseded, and deferred directions without retaining + generated review artifacts +- run Python, Markdown, Astro, focused navigation, presentation, link, and + repository-doctor validation +- acceptance: the final PR diff contains source, tests, and formal + spec/plan/delivery records only; no generated review bundle remains + +## Risks + +- navigation and footer data can drift if a surface stops deriving from the + typed model; focused tests pin the durable ownership rules +- component extraction can erase page meaning if it is based on appearance + alone; every shared component keeps explicit exclusions +- Astro scoped styles can disappear from built output; inspect representative + built pages where styling is behaviorally significant +- dated review measurements can be mistaken for current state; the delivery + record is the final reconciliation point diff --git a/docs/plans/2026-07-23-global-section-opener.md b/docs/plans/2026-07-23-global-section-opener.md new file mode 100644 index 0000000..5297b82 --- /dev/null +++ b/docs/plans/2026-07-23-global-section-opener.md @@ -0,0 +1,48 @@ +# Build Plan — global-section-opener + +slug: `global-section-opener` · status: `delivered in draft PR #30` + +> Extract the repeated long-form opening grammar without changing page-owned +> content or composition. + +## Tasks + +### t1 — Add the shared component + +- create `SectionIntro.astro` with eyebrow, stable `h2`, optional post-title + content, introduction paragraphs, title-spacing choice, and reveal choice +- use the shared heading and prose measures +- acceptance: source and built output contain the component's semantic markers, + measures, and reduced-motion-safe reveal behavior + +### t2 — Migrate the agent profiles + +- replace repeated opening markup in Devague, Colleague, Lobes, and Reachy Mini + CLI +- label each migrated parent section with its component heading +- acceptance: existing copy, section IDs, reveal timing, accessible labels, and + downstream content remain + +### t3 — Migrate the article beats + +- use one component call inside the existing eight-beat loop +- preserve optional definitions, the first-paragraph lede, paragraph-level + reveals, evidence notes, and beat layout +- acceptance: all eight rendered headings keep their stable IDs and definitions + remain between title and prose + +### t4 — Document and validate the migration + +- record the adopted surfaces, semantic requirements, article ordering, and + presentation exclusion +- build the site and review representative agent and article output +- acceptance: the production build passes; semantic order, readable measures, + reduced-motion behavior, and the presentation exclusion survive review + +## Risks + +- boolean false attributes can render as literal HTML attributes; use explicit + template branches for optional reveal markers +- Astro scoped styles can miss component-generated markup; inspect built output, + not source alone +- article definitions can move during extraction; verify their rendered order diff --git a/docs/plans/2026-07-23-global-structured-card.md b/docs/plans/2026-07-23-global-structured-card.md new file mode 100644 index 0000000..27b2c3f --- /dev/null +++ b/docs/plans/2026-07-23-global-structured-card.md @@ -0,0 +1,50 @@ +# Build Plan — global-structured-card + +slug: `global-structured-card` · status: `delivered in draft PR #30` + +> Migrate metadata-led agent-profile information cards to one semantic +> component while preserving different card families. + +## Tasks + +### t1 — Add the shared card and grid + +- create `StructuredCard.astro` with optional metadata/footer, code-title + semantics, featured span, reveal timing, and namespaced grid styles +- acceptance: metadata → title → body → footer order, 16px body copy, 52rem + three-to-two-to-one grid, and no client-side copy behavior + +### t2 — Migrate Devague + +- migrate method moves and operator skills +- keep the lead method card featured and command titles semantic +- acceptance: method and operator-skill cards preserve their content and + semantics; the pipeline remains a separate ruled reference list + +### t3 — Migrate Colleague + +- migrate paradigm, tiers, work loop, minds, and surfaces +- keep tier/mind context as metadata and command strings as compact footers +- acceptance: every migrated field retains its meaning and reading order + +### t4 — Migrate Reachy Mini CLI and Lobes + +- migrate four Reachy families and the Lobes role family +- preserve source copy, repository/model strings, and page order +- acceptance: source copy, repository/model strings, and page order remain + +### t5 — Document and validate inclusion and exclusion + +- record the adopted families, semantic order, responsive behavior, command + treatment, absent copy controls, and intentional exclusions +- build the site and review representative card families at narrow and wide + viewports +- acceptance: the production build passes and excluded families remain local + +## Risks + +- long command titles can overflow narrow columns; allow semantic code to wrap +- equal-height desktop rows can create dead space on mobile; use natural rows at + the one-column layout +- later pipeline changes can invalidate recorded counts; treat counts as a + delivery snapshot and review current source for present inventory diff --git a/docs/specs/2026-07-21-site-ux-review.md b/docs/specs/2026-07-21-site-ux-review.md new file mode 100644 index 0000000..8c80725 --- /dev/null +++ b/docs/specs/2026-07-21-site-ux-review.md @@ -0,0 +1,108 @@ +# site-ux-review + +> Turn the measured July 2026 UX review into shared site patterns +> without flattening the page-specific compositions that give AgentCulture its +> character. + +## Audience + +- visitors moving between the site shell, agent directory, agent profiles, + articles, presentations, and external ecosystem destinations +- maintainers adding routes, cards, navigation entries, terminal evidence, or + long-form sections +- agents that need one reviewable statement of the accepted UX requirements + rather than a collection of prototypes and evolving handoff notes + +## Baseline findings + +The review measured the static site at commit `d71a719`, when the build emitted +eight routes. These findings describe that dated baseline, not the current +branch: + +| # | Finding | Accepted requirement | +|---|---|---| +| 1 | Agent cards used one visual treatment for internal pages, repositories, and another hosted product. | Expose the destination kind before activation. | +| 2 | Only the agent name was clickable inside a card-sized visual target. | Make the complete destination card interactive. | +| 3 | Directory introduction copy said every entry linked to a repository. | Keep self-description aligned with the mixed destination model. | +| 4 | Six agent groups had no stable wayfinding. | Give every group a stable fragment and expose grouped navigation. | +| 5 | Learn looked internal even though this repository did not build `/learn/`. | Model Learn as an external product destination. | +| 6 | Four agent pages repeated shared presentation decisions independently. | Extract semantic patterns where the pages genuinely agree; keep bespoke compositions local. | +| 7 | External destinations had no consistent visual or assistive cue. | Apply one safe external-link behavior. | + +## Requirements + +### Navigation and destinations + +- The header uses one typed navigation model with direct links for Framework + and Engage, grouped menus for Agents and Library, and an external Learn call + to action. +- The Library menu exposes browse-all destinations plus a deliberately capped + featured selection; it does not grow automatically with every library item. +- The footer is a grouped sitemap derived from the same navigation data and + exposes correct current states. +- Agent directory groups keep stable IDs. Agent cards state whether they lead + to an agent page, a site, or a repository. +- Internal and external destination cards share one interaction model. + External destinations open in a new tab with `noopener noreferrer`, a visible + external icon, and assistive text. + +### Shared design foundations + +- Global type, leading, tracking, rail, measure, diagram-spacing, and sticky + header-offset roles live in `site-astro/src/styles/global.css`. +- Every authored `.container` receives an explicit page, shell, wide, or deck + rail role. Readable heading and prose measures remain nested inside those + outer rails. +- Shared components own repeated semantic patterns: primary navigation, + destination cards, agent-directory cards, section introductions, structured + information cards, closing bands, inline code, and external-link cues. +- Agent-specific diagrams, page order, terminal content, article beats, and + presentation slide layouts remain page-owned. +- Terminal components retain their different content shapes while sharing + legible type, spacing, overflow, and fixed dark-surface rules. + +### Devague experience + +- The real-captures section presents three named working sessions and fourteen + narrated excerpts so a non-technical reader can follow the evidence. +- Excerpts resolve from immutable capture data by exact anchors. Complete + transcripts remain accessible from a keyboard-operable modal. +- Human-gate examples are read-only previews; they do not add copy controls. +- The pipeline keeps its animated flow as the visual protagonist and presents + the seven stages as a quieter ruled reference list. +- The method and operator-skills sections use shared structured cards only + where their metadata, title, body, and footer semantics match. + +## Preserve + +- WCAG AA contrast in both themes +- one logical heading hierarchy per route +- keyboard-accessible scroll regions and dialogs +- complete no-JavaScript and reduced-motion renderings +- no page-level horizontal overflow at narrow widths +- static output with no client-side network dependency +- verbatim transcript and provenance requirements +- bespoke diagrams and presentation compositions + +## Boundaries + +- Do not add breadcrumbs or local contents navigation in this change. +- Do not create a generic `AgentPage` or `Terminal` abstraction until a later + task proves a stable shared interface. +- Do not change Learn source, deployment, or ownership. +- Do not make future pages adopt components automatically. +- Do not replace semantically distinct card families merely because they share + a rectangular surface. +- Do not retain generated review pages or static mock bundles as a second + source of truth. + +## Success signals + +- All twelve routes build with the typed navigation and explicit rail roles. +- Shared components own repeated markup while intentional exclusions remain + page-local and reviewable. +- Devague story anchors resolve from the capture source during the build, and + all full transcripts remain reachable. +- The implementation, focused tests, and + [delivery record](../deliveries/2026-07-21-site-ux-review.md) agree about + semantics, exclusions, and deferred work. diff --git a/docs/specs/2026-07-23-global-section-opener.md b/docs/specs/2026-07-23-global-section-opener.md new file mode 100644 index 0000000..232ebf4 --- /dev/null +++ b/docs/specs/2026-07-23-global-section-opener.md @@ -0,0 +1,53 @@ +# global-section-opener + +> Long-form sections share one semantic opening: an eyebrow, a stable section +> heading, optional material between the title and prose, and a readable +> introduction. + +## Audience + +- readers scanning the four long agent profiles and the long-form article +- maintainers adding or changing a long-form section +- agents deciding whether a page should use the shared opener or keep a local + presentation pattern + +## Contract + +- `SectionIntro.astro` owns the eyebrow, `h2`, heading ID, optional + `after-title` slot, prose wrapper, title spacing, and reveal behavior. +- The parent section uses `aria-labelledby` pointing at the component's heading. +- Headings use `--ac-measure-heading`; introductory prose uses + `--ac-measure-prose`. +- Agent pages can reveal the introductory group as one unit. +- The article can place definitions between its heading and prose, keep the + first paragraph as a lede, and reveal paragraphs individually. +- The shared component uses built-output-safe styling and leaves absent reveal + attributes genuinely absent. + +## Adopted Surfaces + +- six Devague sections +- nine Colleague sections +- five Lobes sections +- seven Reachy Mini CLI sections +- one article loop rendering eight beat openings + +At delivery, this was 28 authored component calls and 35 rendered openings. + +## Boundaries + +- Fast-facts sections keep their existing local structure. +- The seven-slide presentation keeps its slide-owned eyebrow pattern. +- Section order, IDs, copy, definitions, evidence notes, and downstream page + compositions remain page-owned. +- The component is selected deliberately; it is not automatic scaffolding for + every future section. + +## Success Signals + +- migrated pages contain no copied eyebrow/heading/prose opener markup +- all parent regions and component headings retain matching accessible IDs +- article definitions remain between the heading and prose +- no `data-reveal="false"` attributes appear in built output +- the Astro build succeeds and representative agent/article pages pass semantic, + visual, keyboard, and reduced-motion review diff --git a/docs/specs/2026-07-23-global-structured-card.md b/docs/specs/2026-07-23-global-structured-card.md new file mode 100644 index 0000000..cc8e081 --- /dev/null +++ b/docs/specs/2026-07-23-global-structured-card.md @@ -0,0 +1,50 @@ +# global-structured-card + +> Agent-profile information with the same metadata → title → body → footer +> meaning shares one card and grid contract; visually similar but semantically +> different surfaces remain independent. + +## Audience + +- readers comparing structured information across the four agent profiles +- maintainers adding metadata-led informational card families +- agents deciding whether a proposed card matches the shared semantic contract + +## Contract + +- `StructuredCard.astro` owns optional metadata, a serif `h3`, 16px body copy, + an optional compact footer, featured span, and reveal delay. +- Code-like titles keep semantic `` markup without becoming controls. +- The shared grid is capped at 52rem and reflows from three to two to one + columns. +- Metadata precedes the title, the body follows it, and an optional footer + closes the card. +- Cards contain no clipboard behavior or copy control. + +## Adopted Surfaces + +- Devague method moves and operator skills: 2 calls, 14 cards +- Colleague paradigm, tiers, work loop, minds, and surfaces: 5 calls, 25 cards +- Reachy Mini CLI capabilities, owner model, senses, and agent-first surfaces: + 4 calls, 25 cards +- Lobes roles: 1 call, 6 cards + +At delivery, this was 12 authored calls and 70 rendered cards. + +## Boundaries + +- The Devague pipeline is a ruled seven-row reference list, not a structured-card + family. +- Directory and library destinations use `DestinationCard`. +- Article evidence, terminals, tables, measured statistics, human-gate rows, + closing bands, and presentation cards remain semantically distinct. +- Equal visual treatment is not sufficient reason to adopt this component. + +## Success Signals + +- built cards retain metadata → title → body → footer order +- all card grids reflow without page overflow +- only Devague's command titles use code semantics +- excluded routes render no structured-card markers +- the Astro build succeeds and representative card families pass semantic, + visual, keyboard, and responsive review diff --git a/pyproject.toml b/pyproject.toml index 54f3a19..50021fc 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -1,6 +1,6 @@ [project] name = "org" -version = "0.18.2" +version = "0.19.0" description = "The AgentCulture org site — source of the web presence published to AgentCulture.org. Replaces the deleted landing-page repo. Not distributed on PyPI: the CLI stays repo-local; the deliverable is the published site." readme = "README.md" license = "Apache-2.0" diff --git a/site-astro/scripts/check-presentations.mjs b/site-astro/scripts/check-presentations.mjs index e58a408..66b3949 100644 --- a/site-astro/scripts/check-presentations.mjs +++ b/site-astro/scripts/check-presentations.mjs @@ -288,8 +288,8 @@ check("site-wide Articles + Presentations wayfinding", () => { const footer = requireRegion(html, "footer", "site-footer", path); for (const route of [articlesRoute, presentationsRoute]) { assert( - linksTo(header.outer, route).length === 1, - `${path} header must contain exactly one ${route} link`, + linksTo(header.outer, route).length === 2, + `${path} header must contain desktop and mobile ${route} links`, ); assert( linksTo(footer.outer, route).length === 1, @@ -828,53 +828,83 @@ check("current nav state per surface", () => { { label: "articles index", html: articlesIndexHtml, - activeLabel: "Articles", - activeHref: articlesRoute, + exactHref: articlesRoute, + footerLabel: "Articles", + footerHref: articlesRoute, }, { label: "article", html: articleHtml, - activeLabel: "Articles", - activeHref: articlesRoute, + exactHref: articleRoute, + footerLabel: undefined, + footerHref: undefined, }, { label: "presentations index", html: presentationsIndexHtml, - activeLabel: "Presentations", - activeHref: presentationsRoute, + exactHref: presentationsRoute, + footerLabel: "Presentations", + footerHref: presentationsRoute, }, { label: "deck", html: deckHtml, - activeLabel: "Presentations", - activeHref: presentationsRoute, + exactHref: deckRoute, + footerLabel: undefined, + footerHref: undefined, }, ]; - for (const { label, html, activeLabel, activeHref } of surfaces) { + for (const { + label, + html, + exactHref, + footerLabel, + footerHref, + } of surfaces) { const header = requireRegion(html, "header", "site-header", label); const footer = requireRegion(html, "footer", "site-footer", label); - for (const [regionLabel, region] of [ - ["Header", header], - ["Footer", footer], - ]) { - const current = anchors(region.outer).filter( - (anchor) => anchor.attrs["aria-current"] === "page", - ); - assert( - current.length === 1, - `${label} ${regionLabel} needs exactly one current link, found ${current.length}`, - ); - assert( - current[0].attrs.href === activeHref && current[0].text === activeLabel, - `${label} ${regionLabel} current link must be ${activeLabel}`, - ); - } + + const currentHeaderOwners = openings(header.outer, "li").filter( + (item) => item["data-nav-current"] === "true", + ); + assert( + currentHeaderOwners.length === 2 && + currentHeaderOwners.every( + (item) => item["data-nav-item"] === "Library", + ), + `${label} must be owned by Library in both responsive Header navs`, + ); + + const currentHeaderLinks = anchors(header.outer).filter( + (anchor) => anchor.attrs["aria-current"] === "page", + ); + assert( + currentHeaderLinks.length === 2 && + currentHeaderLinks.every( + (anchor) => anchor.attrs.href === exactHref, + ), + `${label} Header must mark ${exactHref} as the exact current destination`, + ); + + const currentFooterLinks = anchors(footer.outer).filter( + (anchor) => anchor.attrs["aria-current"] === "page", + ); + assert( + currentFooterLinks.length === (footerHref ? 1 : 0) && + (!footerHref || + (currentFooterLinks[0].attrs.href === footerHref && + currentFooterLinks[0].text === footerLabel)), + footerHref + ? `${label} Footer current link must be ${footerLabel}` + : `${label} Footer must not fall back to its Library index`, + ); + const pageCurrent = anchors(html).filter( (anchor) => anchor.attrs["aria-current"] === "page", ); assert( - pageCurrent.length === 2, - `${label} must have current state in Header and Footer only; found ${pageCurrent.length}`, + pageCurrent.length === (footerHref ? 3 : 2), + `${label} must have exact current state only where its destination is rendered; found ${pageCurrent.length}`, ); } }); diff --git a/site-astro/src/components/AgentDirectoryCard.astro b/site-astro/src/components/AgentDirectoryCard.astro new file mode 100644 index 0000000..05e185d --- /dev/null +++ b/site-astro/src/components/AgentDirectoryCard.astro @@ -0,0 +1,57 @@ +--- +import type { AgentEntry } from "../data/types"; +import DestinationCard from "./DestinationCard.astro"; + +interface Props { + agent: AgentEntry; +} + +const { agent } = Astro.props; +const destinationLabels = { + "agent-page": "Agent page", + site: "Visit site", + repository: "Repository", +} as const; +const destination = destinationLabels[agent.destinationKind]; +--- + +{ + agent.url ? ( + + ) : ( +
+

{agent.name}

+

{agent.role}

+
+ ) +} + + diff --git a/site-astro/src/components/CaptureSession.astro b/site-astro/src/components/CaptureSession.astro new file mode 100644 index 0000000..99dd1ed --- /dev/null +++ b/site-astro/src/components/CaptureSession.astro @@ -0,0 +1,64 @@ +--- +import CaptureSessionHeader from "./CaptureSessionHeader.astro"; +import CaptureStoryBeat from "./CaptureStoryBeat.astro"; +import DevagueTerminal from "./DevagueTerminal.astro"; +import { + getCapturePane, + type SessionStory, +} from "../data/devague-story"; + +interface Props { + session: SessionStory; +} + +const { session } = Astro.props; +const titleId = `capture-session-${session.n}-title`; +const beatsId = `capture-session-${session.n}-beats`; +const heroPane = getCapturePane(session.heroPaneId); +const sessionPanes = session.paneIds.map((paneId) => getCapturePane(paneId)); +--- + +
+
+ + +
+
    + {session.beats.map((beat) => )} +
+
+ +
+
+ +
+
diff --git a/site-astro/src/components/CaptureSessionHeader.astro b/site-astro/src/components/CaptureSessionHeader.astro new file mode 100644 index 0000000..4281de0 --- /dev/null +++ b/site-astro/src/components/CaptureSessionHeader.astro @@ -0,0 +1,20 @@ +--- +import type { SessionStory } from "../data/devague-story"; + +interface Props { + session: SessionStory; + titleId: string; +} + +const { session, titleId } = Astro.props; +--- + +
+

+ Session {session.n}{" · "}{session.date}{" · "}{session.version} +

+

{session.title}

+
+ {session.intro.map((paragraph) =>

{paragraph}

)} +
+
diff --git a/site-astro/src/components/CaptureStoryBeat.astro b/site-astro/src/components/CaptureStoryBeat.astro new file mode 100644 index 0000000..7438f8d --- /dev/null +++ b/site-astro/src/components/CaptureStoryBeat.astro @@ -0,0 +1,69 @@ +--- +import InlineCodeText from "./InlineCodeText.astro"; +import { + resolveStoryBeat, + type StoryBeat, +} from "../data/devague-story"; + +interface Props { + beat: StoryBeat; +} + +const { beat } = Astro.props; +const { pane, lines } = resolveStoryBeat(beat); +const leg = pane.id.split("-")[0]; +const promptColour: Record = { + frame: "#7fdcc9", + plan: "#f2b774", + scope: "#7fb3f2", + challenge: "#e6cd7a", + deviate: "#f2789a", + summary: "#b49cf2", +}; +--- + +
  • + +
    +

    {beat.headline}

    +

    {beat.narration}

    +
    + { + lines.map((line) => ( +

    + {line.kind === "cmd" && ( + + )} + {line.kind === "ellipsis" && ( + + )} + +

    + )) + } + {beat.note && ( +

    + +

    + )} +
    +
    +
    • diff --git a/site-astro/src/components/CaptureTranscriptModal.astro b/site-astro/src/components/CaptureTranscriptModal.astro new file mode 100644 index 0000000..06c2cfe --- /dev/null +++ b/site-astro/src/components/CaptureTranscriptModal.astro @@ -0,0 +1,456 @@ +--- +import DevagueTerminal from "./DevagueTerminal.astro"; +import { + getCapturePane, + sessions, +} from "../data/devague-story"; + +const paneOrder = sessions.flatMap(({ paneIds }) => paneIds); +--- + + + + + + + + diff --git a/site-astro/src/components/ClosingBand.astro b/site-astro/src/components/ClosingBand.astro new file mode 100644 index 0000000..07e1162 --- /dev/null +++ b/site-astro/src/components/ClosingBand.astro @@ -0,0 +1,112 @@ +--- +// The agent-page closing treatment approved in the Devague mock: agent name, +// thread flourish, existing closing copy, then the existing actions. This +// stays inside
    ; Footer.astro remains the page's only real footer. +interface ClosingAction { + href: string; + label: string; + treatment?: "link" | "code"; +} + +interface Props { + name: string; + paragraphs: readonly string[]; + actions: readonly ClosingAction[]; +} + +const { name, paragraphs, actions } = Astro.props; +--- + +
    +
    +
    + {name} + +
    + +
    + {paragraphs.map((paragraph) =>

    {paragraph}

    )} +

    + { + actions.map((action) => { + const opensInNewTab = /^https?:\/\//.test(action.href); + return ( + + {action.treatment === "code" ? ( + {action.label} + ) : ( + <>{action.label} → + )} + + ); + }) + } +

    +
    +
    +
    + + diff --git a/site-astro/src/components/ColleagueTerminal.astro b/site-astro/src/components/ColleagueTerminal.astro index c0824d2..f84378a 100644 --- a/site-astro/src/components/ColleagueTerminal.astro +++ b/site-astro/src/components/ColleagueTerminal.astro @@ -225,8 +225,9 @@ const rendered = pane.lines padding: 0.7rem 1.15rem; border-bottom: 1px solid rgba(233, 236, 248, 0.1); font-family: var(--font-mono); - font-size: 0.72rem; - letter-spacing: 0.03em; + font-size: var(--ac-type-meta); + line-height: var(--ac-leading-ui); + letter-spacing: var(--ac-tracking-flat); color: #a9b0cf; flex-wrap: wrap; row-gap: 0.35rem; @@ -279,9 +280,10 @@ const rendered = pane.lines border-radius: 999px; border: 1px solid currentColor; font-weight: 650; - letter-spacing: 0.06em; + line-height: var(--ac-leading-ui); + letter-spacing: var(--ac-tracking-caps); text-transform: uppercase; - font-size: 0.62rem; + font-size: var(--ac-type-micro); } .accent-identity .accent-tag { @@ -347,8 +349,8 @@ const rendered = pane.lines .muted-source { color: #8790b8; - font-size: 0.9em; - letter-spacing: 0.01em; + font-size: var(--ac-type-micro); + letter-spacing: var(--ac-tracking-flat); } pre { @@ -356,11 +358,18 @@ const rendered = pane.lines padding: 1.05rem 1.15rem 1.2rem; overflow-x: auto; font-family: var(--font-mono); - font-size: 0.78rem; - line-height: 1.7; + font-size: var(--ac-type-terminal); + line-height: var(--ac-leading-card); + letter-spacing: var(--ac-tracking-flat); color: #c7cde8; } + pre > code { + font-size: inherit; + line-height: inherit; + letter-spacing: inherit; + } + /* NOTE on :global() below: the transcript (.tl / .tl-cmd / .tl-out / .tl-ellipsis / .ch / .prompt / .cut-mark / .cut-text) arrives as a plain HTML string via set:html, not as markup this file's own @@ -407,7 +416,8 @@ const rendered = pane.lines align-items: baseline; color: #8790b8; font-style: italic; - font-size: 0.85em; + font-size: var(--ac-type-meta); + line-height: var(--ac-leading-card); } .term :global(.cut-mark) { diff --git a/site-astro/src/components/DestinationCard.astro b/site-astro/src/components/DestinationCard.astro new file mode 100644 index 0000000..a08c649 --- /dev/null +++ b/site-astro/src/components/DestinationCard.astro @@ -0,0 +1,100 @@ +--- +import ExternalLinkIcon from "./ExternalLinkIcon.astro"; + +interface Props { + href: string; + title: string; + description: string; + destinationLabel: string; + titleStyle?: "display" | "mono"; + className?: string; +} + +const { + href, + title, + description, + destinationLabel, + titleStyle = "display", + className, +} = Astro.props; +const opensInNewTab = /^https?:\/\//.test(href); +--- + + +

    {title}

    +

    {description}

    + + {destinationLabel} + { + opensInNewTab ? ( + <> + + (opens in a new tab) + + ) : ( + + ) + } + +     + + diff --git a/site-astro/src/components/DevagueFlow.astro b/site-astro/src/components/DevagueFlow.astro index c5dc83a..c9a78cd 100644 --- a/site-astro/src/components/DevagueFlow.astro +++ b/site-astro/src/components/DevagueFlow.astro @@ -29,13 +29,14 @@ // A spec opens the build; a summary closes it. // // Motion is compositor-only (transform + opacity, nothing else), on the -// site's calm easings. It plays ONCE the first time it scrolls into view -// (the LobesTerminal pattern: an IntersectionObserver toggles `.is-playing`; -// the class is the only thing JS touches — no network, no layout writes), -// then holds the assembled frame. Under prefers-reduced-motion, or with no -// JS, nothing is hidden and nothing moves: the authored DOM already IS the -// finished pipeline — every stage present, every claim confirmed, the gate -// open — so the method stays fully legible as a still. +// site's calm easings. It plays ONCE the first time each part scrolls into +// view (the LobesTerminal pattern: an IntersectionObserver toggles +// `.is-playing` on each stage and connector; the class is the only thing JS +// touches — no network, no layout writes), then holds the assembled frame. +// Under prefers-reduced-motion, or with no JS, nothing is hidden and nothing +// moves: the authored DOM already IS the finished pipeline — every stage +// present, every claim confirmed, the gate open — so the method stays fully +// legible as a still. // // Labels default to real devague vocabulary (verified against `devague // learn` on 0.19.0). The page may override any stage label via `labels`. @@ -96,7 +97,7 @@ const CLAIMS = ["audience", "after_state", "boundary"]; >
      -
    1. +
      3. -
    3. +
      5. -
    5. +
      7. - + -
    7. +
      9. - + -
    9. +
      11. - + -
    11. +
      13. - + -
    13. +
      15. - + -
    15. +
      17. - + -
    17. +
    18. {L.summary} @@ -775,14 +776,103 @@ const CLAIMS = ["audience", "after_state", "boundary"]; } } + /* When the diagram stacks, each item gets its own short local clock. + This preserves the same stage order as the desktop sequence instead of + letting later stages finish off-screen before the user reaches them. */ + @media (max-width: 66rem) and (prefers-reduced-motion: no-preference) { + .link-line, + .frame-claims, + .gate-glyph, + .spec-doc, + .challenge-glyph, + .wave-root, + .build-glyph, + .ledger-glyph, + .summary-doc { + --d: 0.15s !important; + } + + .claim:nth-child(1) { + --d: 1.25s !important; + } + + .claim:nth-child(2) { + --d: 1.85s !important; + } + + .claim:nth-child(3) { + --d: 2.45s !important; + } + + :global(html.js) .flow .gate-block { + transition-delay: 1.75s !important; + } + + :global(html.js) .flow .gate-check { + transition-delay: 2.25s !important; + } + + :global(html.js) .stage.is-playing .gate-leaf-l, + :global(html.js) .stage.is-playing .gate-leaf-r { + animation-delay: 0.65s !important; + } + + .challenge-finding { + --d: 0.85s !important; + } + + .finding-open, + .finding-solid { + --d: 1.45s !important; + } + + .challenge-lens { + --d: 0.35s !important; + } + + .wave-lane:nth-child(2) { + --d: 0.45s !important; + } + + .wave-lane:nth-child(3) { + --d: 0.75s !important; + } + + .wave-lane:nth-child(4) { + --d: 1.05s !important; + } + + .ledger-entry { + --d: 0.75s !important; + } + + .summary-tick:nth-child(4) { + --d: 0.7s !important; + } + + .summary-tick:nth-child(6) { + --d: 0.95s !important; + } + + .summary-tick:nth-child(8) { + --d: 1.2s !important; + } + + .stage-label, + .stage-kind { + --d: 0.5s !important; + } + } + /* ---------- motion ---------- Every animated property below is transform or opacity only. Hidden / pre-play states apply ONLY under html.js + no-preference (mirroring the site's reveal system and LobesTerminal); the base rules above already render the finished, composed pipeline. The `.is-playing` class — set - once by the observer when the figure scrolls into view — drives each - element from its pre-play pose to the composed pose, staggered by a - per-element `--d` delay, then holds. No loop, no reset flicker. */ + once by the observer when each stage or connector scrolls into view — + drives its elements from their pre-play poses to the composed poses, + staggered by the per-element `--d` delay, then holds. No loop, no reset + flicker. */ @media (prefers-reduced-motion: no-preference) { /* idle breathing on the seed and finished nodes — calm, infinite */ .idea-seed { @@ -830,6 +920,24 @@ const CLAIMS = ["audience", "after_state", "boundary"]; transition-delay: var(--d, 0s); } + :global(html.js) .flow .gate-glyph { + opacity: 0; + transform: translateY(0.6rem) scale(0.9); + transition: + opacity 0.7s var(--ease-out), + transform 0.7s var(--ease-out); + transition-delay: var(--d, 0s); + } + + :global(html.js) .flow .wave-root { + opacity: 0; + transform: scale(0.5); + transition: + opacity 0.5s var(--ease-out), + transform 0.5s var(--ease-gentle); + transition-delay: var(--d, 0s); + } + /* challenge: the lens starts up at the examined rules and sweeps down the page to rest over the finding — one calm, transform-only move */ :global(html.js) .flow .challenge-lens { @@ -917,7 +1025,7 @@ const CLAIMS = ["audience", "after_state", "boundary"]; :global(html.js) .flow .gate-block { opacity: 1; transition: opacity 0.4s var(--ease-out); - transition-delay: 3.7s; + transition-delay: 5.7s; } :global(html.js) .flow .gate-check { @@ -928,87 +1036,105 @@ const CLAIMS = ["audience", "after_state", "boundary"]; transition: opacity 0.5s var(--ease-out), transform 0.5s var(--ease-gentle); - transition-delay: 4.2s; + transition-delay: 6.2s; } /* --- played poses (composed) --- */ - :global(html.js) .flow.is-playing .link-line { + :global(html.js) .link.is-playing .link-line { transform: none; } - :global(html.js) .flow.is-playing .frame-claims { + :global(html.js) .stage.is-playing .frame-claims { opacity: 1; transform: none; } - :global(html.js) .flow.is-playing .claim-open { + :global(html.js) .stage.is-playing .claim-open { opacity: 0; } - :global(html.js) .flow.is-playing .claim-solid { + :global(html.js) .stage.is-playing .claim-solid { opacity: 1; transform: scale(1); } - :global(html.js) .flow.is-playing .spec-doc, - :global(html.js) .flow.is-playing .build-glyph { + :global(html.js) .stage.is-playing .spec-doc, + :global(html.js) .stage.is-playing .build-glyph, + :global(html.js) .stage.is-playing .gate-glyph { opacity: 1; transform: none; } - :global(html.js) .flow.is-playing .wave-lane { + :global(html.js) .stage.is-playing .wave-lane { opacity: 1; transform: scaleX(1); } - :global(html.js) .flow.is-playing .gate-block { + :global(html.js) .stage.is-playing .wave-root { + opacity: 1; + transform: scale(1); + } + + :global(html.js) .stage.is-playing .gate-block { opacity: 0; } - :global(html.js) .flow.is-playing .gate-check { + :global(html.js) .stage.is-playing .gate-check { opacity: 1; transform: scale(1); } - :global(html.js) .flow.is-playing .challenge-glyph, - :global(html.js) .flow.is-playing .ledger-glyph, - :global(html.js) .flow.is-playing .summary-doc { + :global(html.js) .stage.is-playing .challenge-glyph, + :global(html.js) .stage.is-playing .ledger-glyph, + :global(html.js) .stage.is-playing .summary-doc { opacity: 1; transform: none; } - :global(html.js) .flow.is-playing .challenge-lens { + :global(html.js) .stage.is-playing .challenge-lens { transform: none; } - :global(html.js) .flow.is-playing .challenge-finding { + :global(html.js) .stage.is-playing .challenge-finding { opacity: 1; } - :global(html.js) .flow.is-playing .finding-open, - :global(html.js) .flow.is-playing .entry-open { + :global(html.js) .stage.is-playing .finding-open, + :global(html.js) .stage.is-playing .entry-open { opacity: 0; } - :global(html.js) .flow.is-playing .finding-solid, - :global(html.js) .flow.is-playing .entry-solid { + :global(html.js) .stage.is-playing .finding-solid, + :global(html.js) .stage.is-playing .entry-solid { opacity: 1; transform: scale(1); } - :global(html.js) .flow.is-playing .summary-tick { + :global(html.js) .stage.is-playing .summary-tick { opacity: 1; transform: scale(1); } + :global(html.js) .flow .stage-label, + :global(html.js) .flow .stage-kind { + opacity: 0; + transition: opacity 0.5s var(--ease-out); + transition-delay: calc(var(--d, 0s) + 0.35s); + } + + :global(html.js) .stage.is-playing .stage-label, + :global(html.js) .stage.is-playing .stage-kind { + opacity: 1; + } + /* the gate's refuse-then-open beat is inherently multi-step, so it runs as a keyframe (compositor-only). `both` holds the open pose after. */ - :global(html.js) .flow.is-playing .gate-leaf-l { - animation: gate-open-l 3.6s var(--ease-gentle) 1s both; + :global(html.js) .stage.is-playing .gate-leaf-l { + animation: gate-open-l 1.8s var(--ease-gentle) 4.6s both; } - :global(html.js) .flow.is-playing .gate-leaf-r { - animation: gate-open-r 3.6s var(--ease-gentle) 1s both; + :global(html.js) .stage.is-playing .gate-leaf-r { + animation: gate-open-r 1.8s var(--ease-gentle) 4.6s both; } } @@ -1065,10 +1191,10 @@ const CLAIMS = ["audience", "after_state", "boundary"]; diff --git a/site-astro/src/components/DevagueTerminal.astro b/site-astro/src/components/DevagueTerminal.astro index d5401b2..584c85a 100644 --- a/site-astro/src/components/DevagueTerminal.astro +++ b/site-astro/src/components/DevagueTerminal.astro @@ -135,7 +135,7 @@ const rendered = pane.lines {legLabel[leg]} {pane.title} - {pane.context} + {pane.context} devague {pane.devagueVersion} · captured {pane.capturedDate} 
       code {
+    font-size: inherit;
+    line-height: inherit;
+    letter-spacing: inherit;
+  }
+
   /* NOTE on :global() below: the transcript (.tl / .tl-cmd / .tl-out /
      .tl-ellipsis / .ch / .prompt / .cut-mark / .cut-text) is injected via
      set:html as a plain string — Astro's compiler only stamps its
@@ -350,7 +359,8 @@ const rendered = pane.lines
     align-items: baseline;
     color: #8790b8;
     font-style: italic;
-    font-size: 0.85em;
+    font-size: var(--ac-type-meta);
+    line-height: var(--ac-leading-card);
   }
 
   .term :global(.cut-mark) {
diff --git a/site-astro/src/components/ExternalLinkIcon.astro b/site-astro/src/components/ExternalLinkIcon.astro
new file mode 100644
index 0000000..77ecaa8
--- /dev/null
+++ b/site-astro/src/components/ExternalLinkIcon.astro
@@ -0,0 +1,20 @@
+---
+interface Props {
+  size?: number;
+}
+
+const { size = 14 } = Astro.props;
+---
+
+
diff --git a/site-astro/src/components/Footer.astro b/site-astro/src/components/Footer.astro
index 1924df0..b57841f 100644
--- a/site-astro/src/components/Footer.astro
+++ b/site-astro/src/components/Footer.astro
@@ -1,40 +1,57 @@
 ---
 import site from "../data/site";
 import {
-  isPrimaryNavCurrent,
-  primaryNavigation,
+  footerNavigation,
+  isFooterNavCurrent,
 } from "../data/navigation";
+import ExternalLinkIcon from "./ExternalLinkIcon.astro";
 import Mark from "./Mark.astro";
 
 const year = new Date().getFullYear();
 ---
 
 
      
-  
      
-    
      
-      
-        
-        {site.hero.title}
-      
-      
+  
      
+    
      
+      
      
+        
+          
+          {site.hero.title}
+        
+        
      {site.hero.tagline}
      
+      
      
+
+      
      
+        {
+          footerNavigation.map((group) => (
+            
+          ))
+        }
+      
      
     
      
+
     
      
       This site is built and operated by the organization's agents.
       
@@ -46,70 +63,126 @@ const year = new Date().getFullYear();
 
diff --git a/site-astro/src/components/Header.astro b/site-astro/src/components/Header.astro
index 4a495cc..39af3df 100644
--- a/site-astro/src/components/Header.astro
+++ b/site-astro/src/components/Header.astro
@@ -1,122 +1,484 @@
 ---
 import site from "../data/site";
-import {
-  isPrimaryNavCurrent,
-  primaryNavigation,
-} from "../data/navigation";
 import Mark from "./Mark.astro";
+import PrimaryNavigation from "./PrimaryNavigation.astro";
 ---
 
-
      
-  
      
-    
+
      
+  
      
+    
       
       {site.hero.title}
     
-    
+
+    
      
+      
+    
      
+
+    
      
+      
+        Menu
+        Close
+        
+      
+      
+    
      
   
      
 
      
 
+
+
 
diff --git a/site-astro/src/components/InlineCodeText.astro b/site-astro/src/components/InlineCodeText.astro
new file mode 100644
index 0000000..d5bcff0
--- /dev/null
+++ b/site-astro/src/components/InlineCodeText.astro
@@ -0,0 +1,47 @@
+---
+interface Props {
+  text: string;
+}
+
+const { text } = Astro.props;
+
+type Part =
+  | { kind: "text"; value: string }
+  | { kind: "code"; value: string };
+
+// Explicit backtick spans remain whole commands. Bare long-form flags,
+// Devague operator skills, and colleague's branch-name templates are
+// promoted individually, so content authors do not have to smuggle markup
+// into the data layer just to preserve code semantics.
+const parts: Part[] = [];
+const tokenPattern =
+  /(`[^`\n]+`|--[a-z0-9][a-z0-9-]*|\/(?:scope|think|challenge|spec-to-plan|assign-to-workforce|deviate|summarize-delivery)\b|(?:colleague|sub)\/)/gi;
+let cursor = 0;
+
+for (const match of text.matchAll(tokenPattern)) {
+  const index = match.index ?? 0;
+  if (index > cursor) {
+    parts.push({ kind: "text", value: text.slice(cursor, index) });
+  }
+
+  const token = match[0];
+  const explicitCode = token.startsWith("`") && token.endsWith("`");
+  parts.push({
+    kind: "code",
+    value: explicitCode ? token.slice(1, -1) : token,
+  });
+  cursor = index + token.length;
+}
+
+if (cursor < text.length) {
+  parts.push({ kind: "text", value: text.slice(cursor) });
+}
+---
+
+{
+  parts.map((part) =>
+    part.kind === "code"
+      ? {part.value}
+      : part.value
+  )
+}
diff --git a/site-astro/src/components/LobesTerminal.astro b/site-astro/src/components/LobesTerminal.astro
index bdacde5..feaa95a 100644
--- a/site-astro/src/components/LobesTerminal.astro
+++ b/site-astro/src/components/LobesTerminal.astro
@@ -15,11 +15,12 @@ interface Props {
   session: CaptureSession;
   /** Seconds before this pane starts playing once revealed. */
   start?: number;
-  /** Soft-wrap output lines instead of scrolling (for quotable output). */
+  /** Soft-wrap output lines instead of scrolling. Defaults on so every
+   * Lobes capture remains readable within the page rail. */
   wrap?: boolean;
 }
 
-const { session, start = 0.3, wrap = false } = Astro.props;
+const { session, start = 0.3, wrap = true } = Astro.props;
 
 // Pre-compute the timeline: when each line begins, when each character of a
 // command lands. Calm pace — the prompt appears, a short beat (LEAD), then
@@ -95,8 +96,9 @@ const rendered = session.lines
     padding: 0.7rem 1.15rem;
     border-bottom: 1px solid rgba(233, 236, 248, 0.1);
     font-family: var(--font-mono);
-    font-size: 0.72rem;
-    letter-spacing: 0.04em;
+    font-size: var(--ac-type-meta);
+    line-height: var(--ac-leading-ui);
+    letter-spacing: var(--ac-tracking-flat);
     color: #a9b0cf;
     flex-wrap: wrap;
   }
@@ -125,11 +127,24 @@ const rendered = session.lines
     padding: 1.05rem 1.15rem 1.2rem;
     overflow-x: auto;
     font-family: var(--font-mono);
-    font-size: 0.78rem;
-    line-height: 1.7;
+    font-size: var(--ac-type-terminal);
+    line-height: var(--ac-leading-card);
+    letter-spacing: var(--ac-tracking-flat);
     color: #c7cde8;
   }
 
+  pre > code {
+    font-size: inherit;
+    line-height: inherit;
+    letter-spacing: inherit;
+  }
+
+  .term.wrap pre {
+    overflow-x: hidden;
+    white-space: pre-wrap;
+    overflow-wrap: anywhere;
+  }
+
   .tl {
     display: block;
     white-space: pre;
diff --git a/site-astro/src/components/PageHero.astro b/site-astro/src/components/PageHero.astro
index f372b70..bed248d 100644
--- a/site-astro/src/components/PageHero.astro
+++ b/site-astro/src/components/PageHero.astro
@@ -2,6 +2,7 @@
 // Sub-page opening: title, a short hand-drawn thread (two agents, one line —
 // the smallest possible echo of the hero mesh), then the page's own
 // introduction from the data layer.
+
 interface Props {
   title: string;
   intro: string[];
@@ -10,7 +11,7 @@ const { title, intro } = Astro.props;
 ---
 
 
      
-  
      
+  
      
     
      {title}
      
     
+  
        
+    {
+      primaryNavigation.map((item) => {
+        const current = isPrimaryNavCurrent(pathname, item);
+
+        return (
+          
      • 
+            {item.kind === "menu" ? (
+              
        
+                
+                  {item.label}
+                  {current &&  (current section)}
+                  
+                
+
+                
+              
        
+            ) : (
+              
+                {item.label}
+                {item.kind === "cta" && }
+                {item.kind === "cta" && (
+                   (opens in a new tab)
+                )}
+              
+            )}
+          
        • 
+        );
+      })
+    }
+  
      
+
+
+
diff --git a/site-astro/src/components/ReachyTerminal.astro b/site-astro/src/components/ReachyTerminal.astro
index a344033..6a92db9 100644
--- a/site-astro/src/components/ReachyTerminal.astro
+++ b/site-astro/src/components/ReachyTerminal.astro
@@ -6,7 +6,7 @@
 // at build time, an escaped-string transcript injected with set:html, every
 // animated property opacity/transform only — but it is written fresh here
 // and kept deliberately UNSHARED: it owns its own `r`-prefixed classes, its
-// own theme-token palette, its own provenance accent scheme, its own
+// own fixed terminal palette, its own provenance accent scheme, its own
 // `data-reachy-term` marker, and its own IntersectionObserver script. It
 // shares no code, no selector, no class, no state, and no script with any
 // sibling terminal, even when several ship on the same page.
@@ -23,11 +23,9 @@
 //
 // No JS or reduced motion -> the completed transcript renders immediately,
 // fully visible and still (the hidden states are gated behind html.js +
-// prefers-reduced-motion: no-preference, the site-wide convention). Colours
-// ride global.css theme tokens (var(--surface), var(--ink), var(--ink-soft),
-// var(--accent), var(--line), var(--font-mono), var(--radius), var(--shadow),
-// var(--ease-out)) so the pane is legible and correct in BOTH dawn themes —
-// no hardcoded colour that would break light or dark.
+// prefers-reduced-motion: no-preference, the site-wide convention). Like the
+// sibling replay components, the terminal keeps one fixed pre-dawn palette
+// in both site themes so captured sessions always read as the same surface.
 import type { CapturePane } from "../data/reachy-mini-cli-captures";
 
 interface Props {
@@ -145,9 +143,9 @@ const rendered = pane.lines
     
     {provLabel[provenance]}
     {pane.title}
-    {pane.context}
+    {pane.context}
     reachy-mini-cli {pane.cliVersion} · captured {pane.capturedDate}
-    {pane.source}
+    {pane.source}
   
   
       
 
diff --git a/site-astro/src/components/StructuredCard.astro b/site-astro/src/components/StructuredCard.astro
new file mode 100644
index 0000000..de74d14
--- /dev/null
+++ b/site-astro/src/components/StructuredCard.astro
@@ -0,0 +1,184 @@
+---
+import InlineCodeText from "./InlineCodeText.astro";
+
+interface Props {
+  title: string;
+  body: string;
+  meta?: string;
+  footer?: string;
+  footerItems?: readonly string[];
+  titleKind?: "text" | "code";
+  featured?: boolean;
+  revealDelay?: number;
+}
+
+const {
+  title,
+  body,
+  meta,
+  footer,
+  footerItems,
+  titleKind = "text",
+  featured = false,
+  revealDelay,
+} = Astro.props;
+---
+
+
    19. 
+  {meta && {meta}}
+
+  
      
+    {
+      titleKind === "code"
+        ? {title}
+        : 
+    }
+  
      
+
+  
      
+    
+  
      
+
+  {
+    footerItems && footerItems.length > 0 ? (
+      
        
+        {
+          footerItems.map((item) => (
+            
      • 
+              {item}
+            
        • 
+          ))
+        }
+      
      
+    ) : footer ? (
+      {footer}
+    ) : null
+  }
+
      20. 
+
+
diff --git a/site-astro/src/data/devague-story.ts b/site-astro/src/data/devague-story.ts
new file mode 100644
index 0000000..5e06953
--- /dev/null
+++ b/site-astro/src/data/devague-story.ts
@@ -0,0 +1,294 @@
+import {
+  challengeAdjudicateReexport,
+  challengeSweepRoute,
+  deviateLedgerRead,
+  frameAnnounceCapture,
+  frameGateConvergeExport,
+  frameGateLiveRefusal,
+  frameInterrogateReviewShift,
+  planTaskConvergeExport,
+  scopeSurveySeeds,
+  summarySkeletonRead,
+  type CaptureLine,
+  type CapturePane,
+} from "./devague-captures.ts";
+
+export type CapturePaneId =
+  | "frame-announce-capture"
+  | "frame-interrogate-review-shift"
+  | "frame-gate-converge-export"
+  | "plan-task-converge-export"
+  | "scope-survey-seeds"
+  | "frame-gate-live-refusal"
+  | "deviate-ledger-read"
+  | "summary-skeleton-read"
+  | "challenge-sweep-route"
+  | "challenge-adjudicate-reexport";
+
+export const capturePanes: Record = {
+  "frame-announce-capture": frameAnnounceCapture,
+  "frame-interrogate-review-shift": frameInterrogateReviewShift,
+  "frame-gate-converge-export": frameGateConvergeExport,
+  "plan-task-converge-export": planTaskConvergeExport,
+  "scope-survey-seeds": scopeSurveySeeds,
+  "frame-gate-live-refusal": frameGateLiveRefusal,
+  "deviate-ledger-read": deviateLedgerRead,
+  "summary-skeleton-read": summarySkeletonRead,
+  "challenge-sweep-route": challengeSweepRoute,
+  "challenge-adjudicate-reexport": challengeAdjudicateReexport,
+};
+
+export interface StoryBeat {
+  headline: string;
+  narration: string;
+  paneId: CapturePaneId;
+  anchor: string;
+  occurrence?: number;
+  count: number;
+  note?: string;
+}
+
+export interface SessionStory {
+  n: 1 | 2 | 3;
+  title: string;
+  date: string;
+  version: string;
+  intro: string[];
+  beats: StoryBeat[];
+  heroPaneId: CapturePaneId;
+  paneIds: CapturePaneId[];
+}
+
+const exactLineStarting = (pane: CapturePane, prefix: string): string => {
+  const line = pane.lines.find(({ text }) => text.startsWith(prefix));
+  if (!line) {
+    throw new Error(`Missing story anchor in ${pane.id}: ${prefix}`);
+  }
+  return line.text;
+};
+
+export const sessions: SessionStory[] = [
+  {
+    n: 1,
+    title: "The page specs itself",
+    date: "14 July 2026",
+    version: "devague 0.17",
+    intro: [
+      'Before this page was built, the team ran devague on the idea of the page. One sentence — "imagine this page is live: what does it contain?" — was broken into eighteen separate promises. A human approved or rejected every one. Only when each promise had an answer did the tool write the final spec — and the build plan\'s first task was to record this very session, so you can read it below.',
+    ],
+    beats: [
+      {
+        headline: "One sentence, pretended true",
+        narration:
+          "The method starts by pretending the work is finished: describe the launch you wish you could announce. The tool turns that one sentence into a frame — a container for every promise the announcement quietly makes.",
+        paneId: "frame-announce-capture",
+        anchor: exactLineStarting(
+          frameAnnounceCapture,
+          'devague new "agentculture.org/agents/devague is live',
+        ),
+        count: 2,
+      },
+      {
+        headline: 'Promises land as "proposed"',
+        narration:
+          "Each promise is captured one at a time. Watch the last word of the reply: proposed. The AI suggested it — nobody has agreed to it yet.",
+        paneId: "frame-announce-capture",
+        anchor: exactLineStarting(
+          frameAnnounceCapture,
+          "devague capture --origin llm --kind audience",
+        ),
+        count: 2,
+      },
+      {
+        headline: "Reality answers mid-session",
+        narration:
+          "Earlier the session hit a question it couldn't answer: the code was private but the package public — where should links point? While that question sat open, Ori made the repository public in real life. The session resolved its own question with something that had just actually happened.",
+        paneId: "frame-interrogate-review-shift",
+        anchor: exactLineStarting(
+          frameInterrogateReviewShift,
+          "devague question --resolve q1",
+        ),
+        count: 2,
+      },
+      {
+        headline: "Fifteen yes, six no",
+        narration:
+          "A human went through every promise. Fifteen were approved — and six were rejected outright, on the record. Rejection is a first-class outcome here, not a failure.",
+        paneId: "frame-interrogate-review-shift",
+        anchor: "devague reject c3 c9 c12 h1 h4 h7",
+        count: 7,
+      },
+      {
+        headline: '"The USER decides"',
+        narration:
+          "When asked for status, the tool listed seven promises still undecided — and look at how it phrases the next step. It will not decide for you.",
+        paneId: "frame-gate-converge-export",
+        anchor: "recommended next move (first gap):",
+        count: 2,
+      },
+      {
+        headline: "Converged — and a plan in waves",
+        narration:
+          "With every promise settled, the spec became a build plan, and the plan sorted itself into waves — what can be built in parallel, and what has to wait. The first task in wave zero: record this session.",
+        paneId: "plan-task-converge-export",
+        anchor: "devague plan waves",
+        count: 7,
+      },
+    ],
+    heroPaneId: "frame-announce-capture",
+    paneIds: [
+      "frame-announce-capture",
+      "frame-interrogate-review-shift",
+      "frame-gate-converge-export",
+      "plan-task-converge-export",
+    ],
+  },
+  {
+    n: 2,
+    title: "The tool outgrows its own page",
+    date: "15 July 2026",
+    version: "devague 0.18",
+    intro: [
+      "By the next day the tool had grown three new abilities — which made this page out of date the moment they shipped. So the page went back through its own process. This session ran before the seventh leg existed, and its transcript honestly announces the method as it then stood: one leg shorter. This time, the tool refused to finish until the missing evidence arrived.",
+    ],
+    beats: [
+      {
+        headline: "Look first, then promise",
+        narration:
+          "New in this version: before promising anything, the session reads the real files and writes down what it found — with receipts naming exactly what was read.",
+        paneId: "scope-survey-seeds",
+        anchor: exactLineStarting(
+          scopeSurveySeeds,
+          'devague scope "site-astro/src/data/devague.ts"',
+        ),
+        count: 2,
+      },
+      {
+        headline: "The gate refuses",
+        narration:
+          "Six promises still had no evidence behind them. The tool didn't warn — it refused, and listed exactly what was missing.",
+        paneId: "frame-gate-live-refusal",
+        anchor: "devague export",
+        occurrence: 1,
+        count: 3,
+      },
+      {
+        headline: "Ori decides, live",
+        narration:
+          "Then a human typed an instruction directly. Watch the last word — every AI suggestion above needed explicit approval, but a person's own words are trusted the moment they land.",
+        paneId: "frame-gate-live-refusal",
+        anchor: exactLineStarting(
+          frameGateLiveRefusal,
+          'devague capture --kind decision "Ori loves',
+        ),
+        count: 2,
+        note: "confirmed instantly — no separate approval step, because a human said it.",
+      },
+      {
+        headline: "The empty ledger, said plainly",
+        narration:
+          "The tool keeps a ledger of moments the build had to leave the plan. Nothing went off-plan in this run — and the ledger says so, instead of inventing drama. Honesty over padding.",
+        paneId: "deviate-ledger-read",
+        anchor: "devague --version",
+        count: 4,
+      },
+      {
+        headline: "The report refuses to pretend",
+        narration:
+          "The delivery report was test-run before anything was built — so every result field correctly says 'fill this in later' rather than claiming work that hadn't happened.",
+        paneId: "summary-skeleton-read",
+        anchor: "## Mid-work Decisions",
+        count: 4,
+      },
+    ],
+    heroPaneId: "scope-survey-seeds",
+    paneIds: [
+      "scope-survey-seeds",
+      "frame-gate-live-refusal",
+      "deviate-ledger-read",
+      "summary-skeleton-read",
+    ],
+  },
+  {
+    n: 3,
+    title: "The what-did-we-miss pass",
+    date: "15 July 2026",
+    version: "devague 0.19",
+    intro: [
+      "One more ability arrived: a formal blind-spot check. It swept the finished spec through a fixed checklist of angles — hidden assumptions, security, what-if-it-breaks, can-we-undo-it — specifically to catch what nobody had thought to ask.",
+    ],
+    beats: [
+      {
+        headline: "One real catch",
+        narration:
+          "The sweep found a genuinely undecided question — seven cards in a grid designed for six — and routed it to a human to decide, rather than quietly picking an answer.",
+        paneId: "challenge-sweep-route",
+        anchor: exactLineStarting(
+          challengeSweepRoute,
+          'devague scope "challenge pass / unstated-assumptions lens',
+        ),
+        count: 2,
+      },
+      {
+        headline: "Honest about the unknown",
+        narration:
+          "One thing couldn't be known yet — how a layout reads on tablet-sized screens — so it was parked as an open unknown instead of being papered over.",
+        paneId: "challenge-sweep-route",
+        anchor: exactLineStarting(
+          challengeSweepRoute,
+          'devague park "how the re-timed 9-stage cascade',
+        ),
+        count: 2,
+      },
+      {
+        headline: "Adjudicated, reconverged, re-exported",
+        narration:
+          "Ori confirmed the one open call, the frame converged again, and the export rewrote the same spec file — the pass made the existing spec stronger rather than spawning a new one.",
+        paneId: "challenge-adjudicate-reexport",
+        anchor: "devague confirm c19",
+        count: 7,
+      },
+    ],
+    heroPaneId: "challenge-sweep-route",
+    paneIds: ["challenge-sweep-route", "challenge-adjudicate-reexport"],
+  },
+];
+
+export const getCapturePane = (paneId: CapturePaneId): CapturePane =>
+  capturePanes[paneId];
+
+export const resolveStoryBeat = (
+  beat: StoryBeat,
+): { pane: CapturePane; lines: CaptureLine[] } => {
+  const pane = getCapturePane(beat.paneId);
+  const occurrence = beat.occurrence ?? 1;
+  let seen = 0;
+  const start = pane.lines.findIndex((line) => {
+    if (line.text !== beat.anchor) return false;
+    seen += 1;
+    return seen === occurrence;
+  });
+
+  if (start < 0) {
+    throw new Error(
+      `Story anchor did not resolve in ${pane.id} (occurrence ${occurrence}): ${beat.anchor}`,
+    );
+  }
+
+  const lines = pane.lines.slice(start, start + beat.count);
+  if (lines.length !== beat.count) {
+    throw new Error(
+      `Story excerpt overruns ${pane.id}: wanted ${beat.count} lines from ${beat.anchor}`,
+    );
+  }
+
+  return { pane, lines };
+};
+
+export const validateDevagueStory = (): void => {
+  for (const session of sessions) {
+    for (const beat of session.beats) resolveStoryBeat(beat);
+  }
+};
+
+validateDevagueStory();
diff --git a/site-astro/src/data/devague.ts b/site-astro/src/data/devague.ts
index 3323a12..840a38e 100644
--- a/site-astro/src/data/devague.ts
+++ b/site-astro/src/data/devague.ts
@@ -38,10 +38,14 @@ export interface MethodMove {
   detail: string;
 }
 
+export type ReviewEffectPart = string | { code: string };
+
 /** One command of the human review loop and what it guarantees. */
 export interface ReviewStep {
+  kind: string;
+  title: string;
   cmd: string;
-  effect: string;
+  effect: ReviewEffectPart[];
 }
 
 /** One operator skill and the pipeline leg it drives. */
@@ -168,40 +172,40 @@ const devague = {
     moves: [
       {
         verb: "scope",
-        ask: "what does this idea actually touch?",
+        ask: "What does this idea actually touch?",
         detail:
           "survey the surfaces before framing — findings land on the frame, each citing what was read",
       },
       {
         verb: "new",
-        ask: "what are we saying shipped?",
+        ask: "What are we saying shipped?",
         detail: "start a frame from the announcement",
       },
       {
         verb: "capture",
-        ask: "what does the announcement claim?",
+        ask: "What does the announcement claim?",
         detail:
           "record and classify a claim — audience, after-state, boundary, success signal",
       },
       {
         verb: "interrogate",
-        ask: "what must be true for this to be honest?",
+        ask: "What must be true for this to be honest?",
         detail: "attach honesty conditions and hard questions to a claim",
       },
       {
         verb: "park",
-        ask: "what do we honestly not know yet?",
+        ask: "What do we honestly not know yet?",
         detail:
           "record open vagueness as first-class state instead of forcing an answer",
       },
       {
         verb: "converge",
-        ask: "is this solid enough to build from?",
+        ask: "Is this solid enough to build from?",
         detail: "list every gap still standing between the frame and a spec",
       },
       {
         verb: "export",
-        ask: "then, and only then —",
+        ask: "Then, and only then —",
         detail: "write the buildable spec; refused until converge passes",
       },
     ] satisfies MethodMove[],
@@ -219,33 +223,56 @@ const devague = {
     ],
     steps: [
       {
+        kind: "review",
+        title: "Review what's proposed",
         cmd: "devague review",
-        effect:
-          "writes .devague/reviews/.md — a durable artifact of every proposal awaiting a human decision",
+        effect: [
+          "writes ",
+          { code: ".devague/reviews/.md" },
+          " — a durable artifact of every proposal awaiting a human decision",
+        ],
       },
       {
+        kind: "confirm",
+        title: "Confirm a batch of claims",
         cmd: "devague confirm c2 h1 h3",
-        effect:
+        effect: [
           "transactional — one bad id in the batch and nothing changes at all",
+        ],
       },
       {
+        kind: "confirm",
+        title: "Confirm from an edited file",
         cmd: "devague confirm --from-review ",
-        effect: "applies the confirm/reject decisions from an edited review file",
+        effect: [
+          "applies the confirm/reject decisions from an edited review file",
+        ],
       },
       {
+        kind: "reject",
+        title: "Reject a claim",
         cmd: "devague reject c3",
-        effect:
+        effect: [
           "the other half of the gate — a rejected claim stays on the record as rejected, not deleted",
+        ],
       },
       {
+        kind: "deviate",
+        title: "Flag a deviation from plan",
         cmd: 'devague deviate "…" --task t3 --origin llm',
-        effect:
+        effect: [
           "mid-build, the same rule — an agent-raised deviation lands as proposed, with a reason and a classification, never as approved",
+        ],
       },
       {
+        kind: "deviate",
+        title: "Confirm a deviation",
         cmd: "devague deviate --confirm d1",
-        effect:
-          "user-only, like every confirm — you approve that specific departure, or --reject it; either way it stays on the ledger",
+        effect: [
+          "user-only, like every confirm — you approve that specific departure, or ",
+          { code: "--reject" },
+          " it; either way it stays on the ledger",
+        ],
       },
     ] satisfies ReviewStep[],
   },
@@ -304,10 +331,7 @@ const devague = {
     eyebrow: "real captures",
     headline: "This page specced itself — three times now",
     intro: [
-      "The sessions replayed below are not staged, and by now they tell three true stories. The first is the original run — the real frame and plan that specced and planned this very page, announcement to converge to export, then the plan leg through its dependency waves.",
-      "The second is the first catch-up, and it is a period piece now: it ran before the challenge leg existed, so its transcript honestly announces the method as it then stood — one leg shorter. When the page had to catch up with the tool, the tool ran its full arc on it: a scope survey before the frame, the convergence gate refusing an incomplete frame live, a user decision landing mid-session, a deviation put on the ledger, and the delivery-summary skeleton closing the loop.",
-      "The third is this update — the first to run the new seventh leg on its own frame. A lightweight challenge pass swept the exported spec for blind spots and surfaced one unstated assumption — the grid row the seventh skill card lands on — which the human confirmed on the record. The clean lenses went down as examined surfaces, the residual uncertainty was parked, and the same dated spec file was re-exported.",
-      "The gate has earned its keep in all three. In the first run, reality changed while the frame was open — and claims that were no longer true were rejected and re-captured, on the record. The human gate is real, not ceremony.",
+      "Three real working sessions are replayed below — recorded live, never edited, never reworded. Each is told twice: first the story in plain language, then the terminal record it comes from. The human gate is real, not ceremony.",
     ],
     provenance:
       "Transcripts are stored verbatim in a data module and replayed as text — the page never runs devague in your browser, and nothing is invented.",
diff --git a/site-astro/src/data/lobes.ts b/site-astro/src/data/lobes.ts
index d303aa3..f9fe517 100644
--- a/site-astro/src/data/lobes.ts
+++ b/site-astro/src/data/lobes.ts
@@ -40,6 +40,7 @@ export interface MachineProfile {
 export interface BenchLink {
   title: string;
   description: string;
+  destination: string;
   url: string;
 }
 
@@ -195,30 +196,35 @@ const lobes = {
         title: "tuning-profiles.md",
         description:
           "The purpose × machine × model layering, and the measured numbers behind the shipped defaults.",
+        destination: "GitHub · document",
         url: "https://github.com/agentculture/lobes-cli/blob/main/docs/tuning-profiles.md",
       },
       {
         title: "machine-profiles.md",
         description:
           "The per-chip strategy registry and per-role budgets — the substrate the deployment shapes compose on.",
+        destination: "GitHub · document",
         url: "https://github.com/agentculture/lobes-cli/blob/main/docs/machine-profiles.md",
       },
       {
         title: "per-model docs",
         description:
           "One doc per runtime model — how to run it, live assess/benchmark results, caveats.",
+        destination: "GitHub · docs directory",
         url: "https://github.com/agentculture/lobes-cli/tree/main/docs",
       },
       {
         title: "lobes/templates/",
         description:
           "The compose templates lobes init scaffolds — the exact deployment this page's captures ran on.",
+        destination: "GitHub · templates directory",
         url: "https://github.com/agentculture/lobes-cli/tree/main/lobes/templates",
       },
       {
         title: "shahizat's NVFP4 benchmark",
         description:
           "The cross-machine reference (DGX Spark / Jetson Thor / Blackwell 6000 Pro) the throughput flags follow.",
+        destination: "NVIDIA Developer Forums",
         url: "https://forums.developer.nvidia.com/t/benchmark-report-qwen3-6-35b-a3b-nvfp4-on-nvidia-dgx-spark-jetson-thor-blackwell-6000-pro/371810",
       },
     ] satisfies BenchLink[],
diff --git a/site-astro/src/data/navigation.test.mjs b/site-astro/src/data/navigation.test.mjs
index c001cc0..5b2941f 100644
--- a/site-astro/src/data/navigation.test.mjs
+++ b/site-astro/src/data/navigation.test.mjs
@@ -1,114 +1,157 @@
 import assert from "node:assert/strict";
-import { existsSync } from "node:fs";
 import { readFile } from "node:fs/promises";
 import test from "node:test";
 
-const navigationUrl = new URL("./navigation.ts", import.meta.url);
-const headerUrl = new URL("../components/Header.astro", import.meta.url);
-const footerUrl = new URL("../components/Footer.astro", import.meta.url);
-const homeUrl = new URL("../pages/index.astro", import.meta.url);
-
-const navigation = existsSync(navigationUrl)
-  ? await import(navigationUrl.href)
-  : undefined;
-
-test("the shared primary navigation has exactly six expected links", () => {
-  assert.ok(navigation, "src/data/navigation.ts must centralize primary navigation");
-  assert.deepEqual(navigation.primaryNavigation, [
-    { href: "/learn/", label: "Learn" },
-    { href: "/framework/", label: "Framework" },
-    { href: "/agents/", label: "Agents" },
-    { href: "/articles/", label: "Articles", match: "section" },
-    { href: "/presentations/", label: "Presentations", match: "section" },
-    { href: "/engage/", label: "Engage" },
-  ]);
+import site from "./site.ts";
+import {
+  agentsNavigation,
+  footerNavigation,
+  isFooterNavCurrent,
+  isNavigationDestinationCurrent,
+  isPrimaryNavCurrent,
+  learnNavigation,
+  LIBRARY_FEATURED_LIMIT,
+  libraryNavigation,
+  primaryNavigation,
+} from "./navigation.ts";
+
+const labelsCurrentAt = (pathname) =>
+  primaryNavigation
+    .filter((item) => isPrimaryNavCurrent(pathname, item))
+    .map(({ label }) => label);
+
+test("the top-level navigation keeps its owned sections and external Learn action", () => {
+  assert.deepEqual(
+    primaryNavigation.map(({ kind, label }) => [kind, label]),
+    [
+      ["link", "Framework"],
+      ["menu", "Agents"],
+      ["menu", "Library"],
+      ["link", "Engage"],
+      ["cta", "Learn"],
+    ],
+  );
+
+  assert.equal(learnNavigation.href, "https://agentculture.org/learn/");
+  assert.equal(learnNavigation.newTab, true);
 });
 
-test("Articles alone owns its index and descendant article routes", () => {
-  assert.ok(navigation, "src/data/navigation.ts must export the current-route matcher");
+test("Agents exposes hosted pages, stable group fragments, and explicit destination kinds", () => {
+  assert.deepEqual(
+    agentsNavigation.groups.map(({ id }) => id),
+    ["agent-pages", "agent-areas"],
+  );
 
-  for (const pathname of [
-    "/articles",
-    "/articles/",
-    "/articles/mind-nervous-system-body/",
-  ]) {
-    const current = navigation.primaryNavigation.filter((item) =>
-      navigation.isPrimaryNavCurrent(pathname, item),
-    );
-    assert.deepEqual(current.map(({ label }) => label), ["Articles"]);
-  }
+  const [pages, areas] = agentsNavigation.groups;
+  assert.equal(pages.items[0].href, "/agents/");
+  assert.ok(
+    areas.items.every(({ href }) => /^\/agents\/#[a-z0-9-]+$/.test(href)),
+  );
+  assert.equal(
+    new Set(areas.items.map(({ href }) => href)).size,
+    areas.items.length,
+  );
 
-  const falsePrefix = navigation.primaryNavigation.filter((item) =>
-    navigation.isPrimaryNavCurrent("/articles-old/", item),
+  const linkedEntries = site.agents.entries.filter(({ url }) => url);
+  assert.ok(
+    linkedEntries.every(({ destinationKind }) =>
+      ["agent-page", "site", "repository"].includes(destinationKind)),
   );
-  assert.deepEqual(falsePrefix, []);
+
+  const hostedPages = linkedEntries
+    .filter(({ destinationKind }) => destinationKind === "agent-page")
+    .map(({ url }) => url)
+    .sort();
+  const menuPages = pages.items
+    .slice(1)
+    .map(({ href }) => href)
+    .sort();
+  assert.deepEqual(menuPages, hostedPages);
 });
 
-test("Presentations alone owns its index and descendant deck routes", () => {
-  assert.ok(navigation, "src/data/navigation.ts must export the current-route matcher");
+test("Library keeps browse-all links and caps featured destinations", () => {
+  assert.equal(LIBRARY_FEATURED_LIMIT, 2);
+  assert.deepEqual(
+    libraryNavigation.groups.map(({ id }) => id),
+    ["articles", "presentations"],
+  );
 
-  for (const pathname of [
-    "/presentations",
-    "/presentations/",
-    "/presentations/mind-nervous-system-body/",
-  ]) {
-    const current = navigation.primaryNavigation.filter((item) =>
-      navigation.isPrimaryNavCurrent(pathname, item),
+  for (const group of libraryNavigation.groups) {
+    assert.match(group.items[0].label, /^Browse all /);
+    assert.ok(group.items[0].href.endsWith("/"));
+    assert.ok(group.items.length <= LIBRARY_FEATURED_LIMIT + 1);
+    assert.ok(
+      group.items
+        .slice(1)
+        .every(({ badge }) => badge?.startsWith("Featured ")),
     );
-    assert.deepEqual(current.map(({ label }) => label), ["Presentations"]);
   }
-
-  const falsePrefix = navigation.primaryNavigation.filter((item) =>
-    navigation.isPrimaryNavCurrent("/presentations-old/", item),
-  );
-  assert.deepEqual(falsePrefix, []);
 });
 
-test("existing exact-route behavior remains stable", () => {
-  assert.ok(navigation, "src/data/navigation.ts must export the current-route matcher");
-
+test("current-state helpers respect ownership, exact destinations, and fragments", () => {
   for (const [pathname, expected] of [
-    ["/learn", "Learn"],
-    ["/framework/", "Framework"],
-    ["/agents/", "Agents"],
-    ["/engage", "Engage"],
+    ["/framework/", ["Framework"]],
+    ["/framework/principles/", ["Framework"]],
+    ["/agents/colleague/", ["Agents"]],
+    ["/articles/example/", ["Library"]],
+    ["/presentations/example/", ["Library"]],
+    ["/engage/", ["Engage"]],
+    ["/articles-old/", []],
+    ["/learn/", []],
   ]) {
-    const current = navigation.primaryNavigation.filter((item) =>
-      navigation.isPrimaryNavCurrent(pathname, item),
-    );
-    assert.deepEqual(current.map(({ label }) => label), [expected]);
+    assert.deepEqual(labelsCurrentAt(pathname), expected);
   }
 
-  for (const pathname of ["/agents/reachy-mini-cli/", "/agent/", "/engagement/"]) {
-    const current = navigation.primaryNavigation.filter((item) =>
-      navigation.isPrimaryNavCurrent(pathname, item),
-    );
-    assert.deepEqual(current, []);
-  }
+  const agentPage = agentsNavigation.groups[0].items.find(
+    ({ href }) => href === "/agents/colleague/",
+  );
+  const agentArea = agentsNavigation.groups[1].items[0];
+  assert.equal(
+    isNavigationDestinationCurrent("/agents/colleague", agentPage),
+    true,
+  );
+  assert.equal(isNavigationDestinationCurrent("/agents/", agentArea), false);
+
+  const framework = footerNavigation[0].items.find(
+    ({ href }) => href === "/framework/",
+  );
+  const external = footerNavigation.at(-1).items[0];
+  assert.equal(isFooterNavCurrent("/framework", framework), true);
+  assert.equal(isFooterNavCurrent("/framework/child/", framework), false);
+  assert.equal(isFooterNavCurrent("/learn/", external), false);
 });
 
-test("Header and Footer share navigation and accessible current-state semantics", async () => {
-  const [header, footer] = await Promise.all([
-    readFile(headerUrl, "utf8"),
-    readFile(footerUrl, "utf8"),
-  ]);
-
-  for (const component of [header, footer]) {
-    assert.match(component, /primaryNavigation\.map/);
-    assert.match(component, /isPrimaryNavCurrent/);
-    assert.match(component, /aria-current=/);
-    assert.match(component, /flex-wrap:\s*wrap/);
+test("the footer stays grouped, unique, and explicit about external destinations", () => {
+  assert.deepEqual(
+    footerNavigation.map(({ id }) => id),
+    ["explore", "agents", "library", "ecosystem"],
+  );
+
+  const items = footerNavigation.flatMap(({ items }) => items);
+  assert.equal(new Set(items.map(({ href }) => href)).size, items.length);
+
+  for (const item of items) {
+    if (item.kind === "internal") {
+      assert.ok(item.href.startsWith("/"));
+    } else {
+      assert.match(item.href, /^https:\/\//);
+      assert.equal(item.newTab, true);
+    }
   }
 });
 
-test("the home Explore surface links Articles and Presentations exactly once each", async () => {
-  const home = await readFile(homeUrl, "utf8");
-  const articleLinks = home.match(/href:\s*["']\/articles\/["']/g) ?? [];
-  const presentationLinks = home.match(/href:\s*["']\/presentations\/["']/g) ?? [];
-
-  assert.equal(articleLinks.length, 1);
-  assert.match(home, /label:\s*["']Articles["']/);
+test("external destination cards keep visible and assistive safe-new-tab cues", async () => {
+  const component = await readFile(
+    new URL("../components/DestinationCard.astro", import.meta.url),
+    "utf8",
+  );
 
-  assert.equal(presentationLinks.length, 1);
-  assert.match(home, /label:\s*["']Presentations["']/);
+  assert.match(component, /target=\{opensInNewTab \? "_blank"/);
+  assert.match(
+    component,
+    /rel=\{opensInNewTab \? "noopener noreferrer"/,
+  );
+  assert.match(component, / \(opens in a new tab\)<\/span>/);
+  assert.match(component, /data-destination-kind=/);
 });
diff --git a/site-astro/src/data/navigation.ts b/site-astro/src/data/navigation.ts
index 6054c3e..e679a6b 100644
--- a/site-astro/src/data/navigation.ts
+++ b/site-astro/src/data/navigation.ts
@@ -1,30 +1,311 @@
-export interface PrimaryNavigationItem {
+import { articles, presentations } from "./presentations.ts";
+import site from "./site.ts";
+
+export interface SiteSectionNavigationItem {
+  kind: "section";
   href: `/${string}/`;
   label: string;
-  match?: "section";
 }
 
+export interface LinkNavigationItem {
+  kind: "link";
+  href: `/${string}/`;
+  label: string;
+}
+
+export interface NavigationDestination {
+  kind: "internal";
+  href: `/${string}`;
+  label: string;
+  description: string;
+  badge?: "Featured article" | "Featured presentation";
+}
+
+export interface NavigationMenuGroup {
+  id: string;
+  label: string;
+  items: readonly NavigationDestination[];
+}
+
+export interface MenuNavigationItem {
+  kind: "menu";
+  id: "agents" | "library";
+  label: string;
+  match: readonly `/${string}/`[];
+  groups: readonly NavigationMenuGroup[];
+}
+
+export interface CtaNavigationItem {
+  kind: "cta";
+  href: `https://${string}`;
+  label: string;
+  newTab: true;
+}
+
+export type HeaderNavigationItem =
+  | LinkNavigationItem
+  | MenuNavigationItem
+  | CtaNavigationItem;
+
+export interface FooterNavigationItem {
+  href: string;
+  label: string;
+  kind: "internal" | "external" | "product";
+  newTab?: true;
+}
+
+export interface FooterNavigationGroup {
+  id: string;
+  label: string;
+  items: readonly FooterNavigationItem[];
+}
+
+// The five owned section indexes remain the source for the homepage and
+// footer. The header can consolidate them without hiding either library.
+export const siteSections = [
+  { kind: "section", href: "/framework/", label: "Framework" },
+  { kind: "section", href: "/agents/", label: "Agents" },
+  { kind: "section", href: "/articles/", label: "Articles" },
+  { kind: "section", href: "/presentations/", label: "Presentations" },
+  { kind: "section", href: "/engage/", label: "Engage" },
+] as const satisfies readonly SiteSectionNavigationItem[];
+
+const ownedAgentPages = site.agents.entries.flatMap((entry) => {
+  if (
+    entry.destinationKind !== "agent-page" ||
+    typeof entry.url !== "string" ||
+    !entry.url.startsWith("/agents/")
+  ) {
+    return [];
+  }
+
+  return [
+    {
+      kind: "internal" as const,
+      href: entry.url as `/${string}`,
+      label: entry.name,
+      description: entry.role,
+    },
+  ];
+});
+
+const agentAreaLinks = site.agents.groups.map((group) => {
+  const count = site.agents.entries.filter(
+    (entry) => entry.groupId === group.id,
+  ).length;
+
+  return {
+    kind: "internal" as const,
+    href: `/agents/#${group.id}` as `/${string}`,
+    label: group.label,
+    description: `${count} ${count === 1 ? "agent" : "agents"}`,
+  };
+});
+
+export const agentsNavigation = {
+  kind: "menu",
+  id: "agents",
+  label: "Agents",
+  match: ["/agents/"],
+  groups: [
+    {
+      id: "agent-pages",
+      label: "Agent pages",
+      items: [
+        {
+          kind: "internal",
+          href: "/agents/",
+          label: "Browse all agents",
+          description: "The full fleet, grouped by what each agent does.",
+        },
+        ...ownedAgentPages,
+      ],
+    },
+    {
+      id: "agent-areas",
+      label: "Browse by area",
+      items: agentAreaLinks,
+    },
+  ],
+} as const satisfies MenuNavigationItem;
+
+export const LIBRARY_FEATURED_LIMIT = 2;
+
+const featuredArticles = articles
+  .filter(({ featuredInNavigation }) => featuredInNavigation)
+  .slice(0, LIBRARY_FEATURED_LIMIT);
+
+const featuredPresentations = presentations
+  .filter(({ featuredInNavigation }) => featuredInNavigation)
+  .slice(0, LIBRARY_FEATURED_LIMIT);
+
+export const libraryNavigation = {
+  kind: "menu",
+  id: "library",
+  label: "Library",
+  match: ["/articles/", "/presentations/"],
+  groups: [
+    {
+      id: "articles",
+      label: "Articles",
+      items: [
+        {
+          kind: "internal",
+          href: "/articles/",
+          label: "Browse all articles",
+          description: "Full-text, sourced talks from the mesh.",
+        },
+        ...featuredArticles.map((article) => ({
+          kind: "internal" as const,
+          href: article.route,
+          label: article.title,
+          description: article.navigationSummary,
+          badge: "Featured article" as const,
+        })),
+      ],
+    },
+    {
+      id: "presentations",
+      label: "Presentations",
+      items: [
+        {
+          kind: "internal",
+          href: "/presentations/",
+          label: "Browse all presentations",
+          description: "Symbolic decks — the slides behind the talks.",
+        },
+        ...featuredPresentations.map((presentation) => ({
+          kind: "internal" as const,
+          href: presentation.route,
+          label: presentation.title,
+          description: presentation.navigationSummary,
+          badge: "Featured presentation" as const,
+        })),
+      ],
+    },
+  ],
+} as const satisfies MenuNavigationItem;
+
+export const learnNavigation = {
+  kind: "cta",
+  href: "https://agentculture.org/learn/",
+  label: "Learn",
+  newTab: true,
+} as const satisfies CtaNavigationItem;
+
 export const primaryNavigation = [
-  { href: "/learn/", label: "Learn" },
-  { href: "/framework/", label: "Framework" },
-  { href: "/agents/", label: "Agents" },
-  { href: "/articles/", label: "Articles", match: "section" },
-  { href: "/presentations/", label: "Presentations", match: "section" },
-  { href: "/engage/", label: "Engage" },
-] as const satisfies readonly PrimaryNavigationItem[];
+  { kind: "link", href: "/framework/", label: "Framework" },
+  agentsNavigation,
+  libraryNavigation,
+  { kind: "link", href: "/engage/", label: "Engage" },
+  learnNavigation,
+] as const satisfies readonly HeaderNavigationItem[];
+
+const toFooterInternalItem = ({
+  href,
+  label,
+}: Pick): FooterNavigationItem => ({
+  href,
+  label,
+  kind: "internal",
+});
+
+export const footerNavigation = [
+  {
+    id: "explore",
+    label: "Explore",
+    items: siteSections
+      .filter(({ href }) => href === "/framework/" || href === "/engage/")
+      .map(toFooterInternalItem),
+  },
+  {
+    id: "agents",
+    label: "Agents",
+    items: agentsNavigation.groups[0].items.map(toFooterInternalItem),
+  },
+  {
+    id: "library",
+    label: "Library",
+    items: libraryNavigation.groups.map(({ label, items }) => ({
+      ...toFooterInternalItem(items[0]),
+      label,
+    })),
+  },
+  {
+    id: "ecosystem",
+    label: "Ecosystem",
+    items: [
+      {
+        href: learnNavigation.href,
+        label: learnNavigation.label,
+        kind: "product",
+        newTab: true,
+      },
+      {
+        href: "https://github.com/agentculture",
+        label: "GitHub",
+        kind: "external",
+        newTab: true,
+      },
+      {
+        href: "https://culture.dev",
+        label: "culture.dev",
+        kind: "external",
+        newTab: true,
+      },
+      {
+        href: "https://tools.culture.dev",
+        label: "tools.culture.dev",
+        kind: "external",
+        newTab: true,
+      },
+    ],
+  },
+] as const satisfies readonly FooterNavigationGroup[];
 
 const withTrailingSlash = (pathname: string) =>
   pathname.endsWith("/") ? pathname : `${pathname}/`;
 
+const matchesPrefix = (pathname: string, prefix: `/${string}/`) =>
+  withTrailingSlash(pathname).startsWith(prefix);
+
 export function isPrimaryNavCurrent(
   pathname: string,
-  item: PrimaryNavigationItem,
+  item: HeaderNavigationItem | SiteSectionNavigationItem,
 ): boolean {
-  const here = withTrailingSlash(pathname);
+  if (item.kind === "menu") {
+    return item.match.some((prefix) => matchesPrefix(pathname, prefix));
+  }
+
+  const isOwnedLink =
+    item.kind === "link" ||
+    item.kind === "section" ||
+    item.kind === "internal";
+  if (!isOwnedLink || !item.href.startsWith("/")) return false;
 
-  if (item.match === "section") {
-    return here.startsWith(item.href);
+  return matchesPrefix(pathname, item.href as `/${string}/`);
+}
+
+export function isFooterNavCurrent(
+  pathname: string,
+  item: FooterNavigationItem,
+): boolean {
+  if (
+    item.kind !== "internal" ||
+    !item.href.startsWith("/") ||
+    item.href.includes("#")
+  ) {
+    return false;
   }
 
-  return here === item.href;
+  return withTrailingSlash(pathname) === withTrailingSlash(item.href);
+}
+
+export function isNavigationDestinationCurrent(
+  pathname: string,
+  destination: NavigationDestination,
+): boolean {
+  if (destination.href.includes("#")) return false;
+
+  return withTrailingSlash(pathname) === withTrailingSlash(destination.href);
 }
diff --git a/site-astro/src/data/presentations.ts b/site-astro/src/data/presentations.ts
index 0e74aa0..5065b4b 100644
--- a/site-astro/src/data/presentations.ts
+++ b/site-astro/src/data/presentations.ts
@@ -39,6 +39,8 @@ export type PresentationEvidenceSource =
 export interface PresentationCard {
   title: string;
   summary: string;
+  navigationSummary: string;
+  featuredInNavigation: boolean;
   route: `/presentations/${string}/`;
   topic: string;
   sourceProjects: readonly PresentationProjectLabel[];
@@ -47,6 +49,8 @@ export interface PresentationCard {
 export interface ArticleCard {
   title: string;
   summary: string;
+  navigationSummary: string;
+  featuredInNavigation: boolean;
   route: `/articles/${string}/`;
   topic: string;
   sourceProjects: readonly PresentationProjectLabel[];
@@ -169,6 +173,9 @@ export const presentations = [
     title: "A CLI for intelligence, a runtime for embodiment",
     summary:
       "Every robot should expose two interfaces: a deterministic CLI that lets humans and agents operate it, and a persistent runtime that keeps it alive, reactive, and bounded — shown end-to-end on Reachy Mini CLI and supported by ARM101 CLI's operating contract.",
+    navigationSummary:
+      "A two-interface operating model for intelligent robots.",
+    featuredInNavigation: true,
     route: "/presentations/mind-nervous-system-body/",
     topic: "Robot operational architecture",
     sourceProjects: ["Reachy Mini CLI", "ARM101 CLI"],
@@ -180,6 +187,9 @@ export const articles = [
     title: "Mind, nervous system, body",
     summary:
       "How an agent's harness and model become the mind, robot-specific code becomes a symbolic nervous system, and physical robots become the body — grounded in Reachy Mini CLI and ARM101 CLI.",
+    navigationSummary:
+      "How agents, software, and robots form one embodied system.",
+    featuredInNavigation: true,
     route: "/articles/mind-nervous-system-body/",
     topic: "Neurosymbolic robotics",
     sourceProjects: ["Reachy Mini CLI", "ARM101 CLI"],
diff --git a/site-astro/src/data/site.ts b/site-astro/src/data/site.ts
index a36c9d5..0d33182 100644
--- a/site-astro/src/data/site.ts
+++ b/site-astro/src/data/site.ts
@@ -65,15 +65,15 @@ const site: SiteData = {
   agents: {
     intro: [
       "Most repositories in the org share one shape: a CLI a human can run, and an agent that knows how to operate it. The same tool, two consumers.",
-      "This is a curated selection of the fleet, grouped by what each agent does. Every entry links to its public repository.",
+      "This is a curated selection of the fleet, grouped by what each agent does. Each entry opens an AgentCulture page, a public repository, or a connected product.",
     ],
     groups: [
-      "Mesh & platform",
-      "Memory & data",
-      "Developer tooling",
-      "Cloud & infrastructure",
-      "Edge & robotics",
-      "Learning & play",
+      { id: "mesh-platform", label: "Mesh & platform" },
+      { id: "memory-data", label: "Memory & data" },
+      { id: "developer-tooling", label: "Developer tooling" },
+      { id: "cloud-infrastructure", label: "Cloud & infrastructure" },
+      { id: "edge-robotics", label: "Edge & robotics" },
+      { id: "learning-play", label: "Learning & play" },
     ],
     entries: [
       // Mesh & platform
@@ -81,216 +81,238 @@ const site: SiteData = {
         name: "culture",
         repo: "agentculture/culture",
         url: "https://github.com/agentculture/culture",
+        destinationKind: "repository",
         role: "The workspace itself — turns isolated stochastic agents into cooperative, inspectable, improvable colleagues.",
-        group: "Mesh & platform",
+        groupId: "mesh-platform",
       },
       {
         name: "colleague",
         repo: "agentculture/colleague",
         url: "/agents/colleague/",
+        destinationKind: "agent-page",
         role: "A swappable coder-agent harness — one runtime, many minds; runs by itself, and other agents.",
-        group: "Mesh & platform",
+        groupId: "mesh-platform",
       },
       {
         name: "irc-lens",
         repo: "agentculture/irc-lens",
         url: "https://github.com/agentculture/irc-lens",
+        destinationKind: "repository",
         role: "The inspection lens for AgentIRC — see what is happening on the mesh.",
-        group: "Mesh & platform",
+        groupId: "mesh-platform",
       },
       {
         name: "agenda",
         repo: "agentculture/agenda",
         url: "https://github.com/agentculture/agenda",
+        destinationKind: "repository",
         role: "Task and task-version tracking for the mesh, with a task-overview surface.",
-        group: "Mesh & platform",
+        groupId: "mesh-platform",
       },
       {
         name: "lobes-cli",
         repo: "agentculture/lobes-cli",
         url: "/agents/lobes/",
+        destinationKind: "agent-page",
         role: "A local thinking agent for the Culture ecosystem.",
-        group: "Mesh & platform",
+        groupId: "mesh-platform",
       },
       // Memory & data
       {
         name: "eidetic-cli",
         repo: "agentculture/eidetic-cli",
         url: "https://github.com/agentculture/eidetic-cli",
+        destinationKind: "repository",
         role: "Eidetic, perfect-recall memory for agents.",
-        group: "Memory & data",
+        groupId: "memory-data",
       },
       {
         name: "coherence-cli",
         repo: "agentculture/coherence-cli",
         url: "https://github.com/agentculture/coherence-cli",
+        destinationKind: "repository",
         role: "Turns context, claims, provenance, and behavioral traces into inspectable signals agents can decide to trust, refresh, or repair.",
-        group: "Memory & data",
+        groupId: "memory-data",
       },
       {
         name: "data-refinery-cli",
         repo: "agentculture/data-refinery-cli",
         url: "https://github.com/agentculture/data-refinery-cli",
+        destinationKind: "repository",
         role: "Data quality in storage and retrieval — validating, deduplicating, and checking integrity and freshness.",
-        group: "Memory & data",
+        groupId: "memory-data",
       },
       // Developer tooling
       {
         name: "agentfront",
         repo: "agentculture/agentfront",
         url: "https://github.com/agentculture/agentfront",
+        destinationKind: "repository",
         role: "The Agent First Interface — one registry that derives a CLI, an MCP server, and an HTTP site that cannot drift apart.",
-        group: "Developer tooling",
+        groupId: "developer-tooling",
       },
       {
         name: "culture-tools",
         repo: "agentculture/culture-tools",
         url: "https://github.com/agentculture/culture-tools",
+        destinationKind: "repository",
         role: "The package index behind tools.culture.dev — agent-first CLI tools certified against the agentfront contract.",
-        group: "Developer tooling",
+        groupId: "developer-tooling",
       },
       {
         name: "refactor-cli",
         repo: "agentculture/refactor-cli",
         url: "https://github.com/agentculture/refactor-cli",
+        destinationKind: "repository",
         role: "Composable, behavior-preserving refactor actions that don't change what the code does.",
-        group: "Developer tooling",
+        groupId: "developer-tooling",
       },
       {
         name: "dominion-breaker",
         repo: "agentculture/dominion-breaker",
         url: "https://github.com/agentculture/dominion-breaker",
+        destinationKind: "repository",
         role: "Cited monolith decomposition — entity agents defend domain boundaries, and every claim keeps its evidence.",
-        group: "Developer tooling",
+        groupId: "developer-tooling",
       },
       {
         name: "webglass-cli",
         repo: "agentculture/webglass-cli",
         url: "https://github.com/agentculture/webglass-cli",
+        destinationKind: "repository",
         role: "Agent-first web browsing — wraps Playwright and headless Chromium so an agent can navigate, read, and interact with pages.",
-        group: "Developer tooling",
+        groupId: "developer-tooling",
       },
       {
         name: "arxivist",
         repo: "agentculture/arxivist",
         url: "https://github.com/agentculture/arxivist",
+        destinationKind: "repository",
         role: "Fetches arXiv papers, keeps a knowledge base, implements paper solutions, and benchmarks them against the papers' claims.",
-        group: "Developer tooling",
+        groupId: "developer-tooling",
       },
       {
         name: "auntiepypi",
         repo: "agentculture/auntiepypi",
         url: "https://github.com/agentculture/auntiepypi",
+        destinationKind: "repository",
         role: "Maintains, uses, and serves the CLI for managing PyPI packages.",
-        group: "Developer tooling",
+        groupId: "developer-tooling",
       },
       {
         name: "devague",
         repo: "agentculture/devague",
         url: "/agents/devague/",
+        destinationKind: "agent-page",
         role: "Turns a vague feature idea into a buildable spec, then a buildable plan, then a closed loop through delivery — working backwards, then forwards, then recording deviations and summarizing delivery against the plan.",
-        group: "Developer tooling",
+        groupId: "developer-tooling",
       },
       // Cloud & infrastructure
       {
         name: "cultureflare",
         repo: "agentculture/cultureflare",
         url: "https://github.com/agentculture/cultureflare",
+        destinationKind: "repository",
         role: "Agent-first Cloudflare management — action-oriented, idempotent, dry-run by default.",
-        group: "Cloud & infrastructure",
+        groupId: "cloud-infrastructure",
       },
       {
         name: "cloudai-cli",
         repo: "agentculture/cloudai-cli",
         url: "https://github.com/agentculture/cloudai-cli",
+        destinationKind: "repository",
         role: "Cloud AI providers behind one interface — Amazon Bedrock today, with room for more.",
-        group: "Cloud & infrastructure",
+        groupId: "cloud-infrastructure",
       },
       {
         name: "ec2-cli",
         repo: "agentculture/ec2-cli",
         url: "https://github.com/agentculture/ec2-cli",
+        destinationKind: "repository",
         role: "Manages AWS EC2 instances — launch, inspect, start and stop, operate fleets.",
-        group: "Cloud & infrastructure",
+        groupId: "cloud-infrastructure",
       },
       // Edge & robotics
       {
         name: "reachy-mini-cli",
         repo: "agentculture/reachy-mini-cli",
         url: "/agents/reachy-mini-cli/",
+        destinationKind: "agent-page",
         role: "Operates the Reachy Mini expressive robot — device setup, app management, runtime ops.",
-        group: "Edge & robotics",
+        groupId: "edge-robotics",
       },
       {
         name: "jetson",
         repo: "agentculture/jetson",
         url: "https://github.com/agentculture/jetson",
+        destinationKind: "repository",
         role: "NVIDIA Jetson edge-AI ops — device setup, container builds, on-device deployment.",
-        group: "Edge & robotics",
+        groupId: "edge-robotics",
       },
       {
         name: "dgx-spark-cli",
         repo: "agentculture/dgx-spark-cli",
         url: "https://github.com/agentculture/dgx-spark-cli",
+        destinationKind: "repository",
         role: "Operates an NVIDIA DGX Spark workstation — setup, health, and local AI/ML workloads.",
-        group: "Edge & robotics",
+        groupId: "edge-robotics",
       },
       {
         name: "drone-cli",
         repo: "agentculture/drone-cli",
         url: "https://github.com/agentculture/drone-cli",
+        destinationKind: "repository",
         role: "Controls a single flying drone — connect, arm, fly missions, stream telemetry, land.",
-        group: "Edge & robotics",
+        groupId: "edge-robotics",
       },
       {
         name: "fleet-cli",
         repo: "agentculture/fleet-cli",
         url: "https://github.com/agentculture/fleet-cli",
+        destinationKind: "repository",
         role: "Coordinates a fleet of drones at once, built on drone-cli.",
-        group: "Edge & robotics",
+        groupId: "edge-robotics",
       },
       {
         name: "arm101-cli",
         repo: "agentculture/arm101-cli",
         url: "https://github.com/agentculture/arm101-cli",
+        destinationKind: "repository",
         role: "Controls SO-ARM101 robotic arm grippers.",
-        group: "Edge & robotics",
+        groupId: "edge-robotics",
       },
       {
         name: "harmonics-cli",
         repo: "agentculture/harmonics-cli",
         url: "https://github.com/agentculture/harmonics-cli",
+        destinationKind: "repository",
         role: "Non-speech audio for agents and robots — chimes, pulses, and tonal motifs mapped to intent and state.",
-        group: "Edge & robotics",
+        groupId: "edge-robotics",
       },
       // Learning & play
       {
-        name: "league-of-agents",
+        name: "League of Agents",
         repo: "agentculture/league-of-agents",
-        url: "https://github.com/agentculture/league-of-agents",
-        role: "A cooperative and competitive strategy arena where agent teams complete missions and out-coordinate opponents.",
-        group: "Learning & play",
-      },
-      {
-        name: "league-of-agents-platform",
-        repo: "agentculture/league-of-agents-platform",
-        url: "https://github.com/agentculture/league-of-agents-platform",
-        role: "The hosted arena at league-of-agents.ai — a turn-based game for humans and agents, for fun and for benchmarks.",
-        group: "Learning & play",
+        url: "https://league-of-agents.ai",
+        destinationKind: "site",
+        role: "A hosted turn-based strategy arena where humans and agent teams play, compete, complete missions, and get benchmarked.",
+        groupId: "learning-play",
       },
       {
         name: "learn-cli",
         repo: "agentculture/learn-cli",
         url: "https://agentculture.org/learn/",
+        destinationKind: "site",
         role: "A hosted site where humans and agents learn a subject step by step; fronts the language tutors.",
-        group: "Learning & play",
+        groupId: "learning-play",
       },
       {
         name: "french-cli",
         repo: "agentculture/french-cli",
         url: "https://github.com/agentculture/french-cli",
+        destinationKind: "repository",
         role: "A private French tutor — track progress, read stories, practice written and spoken French.",
-        group: "Learning & play",
+        groupId: "learning-play",
       },
     ],
   },
diff --git a/site-astro/src/data/types.ts b/site-astro/src/data/types.ts
index 91dfadf..21ccc76 100644
--- a/site-astro/src/data/types.ts
+++ b/site-astro/src/data/types.ts
@@ -1,7 +1,6 @@
 // The content contract between the data layer (src/data/site.ts) and the
-// page/component layer. Frozen for the wave-3 build: the content task owns
-// site.ts values, the design task consumes this shape — neither edits this
-// file. Widen it only in a follow-up where both sides move together.
+// page/component layer. Navigation uses stable group ids so published
+// /agents/#... anchors do not drift when a display label changes.
 
 export interface Hero {
   /** The site's one-line identity, e.g. "AgentCulture". */
@@ -25,17 +24,26 @@ export interface Pillar {
   points: string[];
 }
 
+export interface AgentGroup {
+  /** Stable fragment id used by the directory jump navigation. */
+  id: string;
+  /** Human-readable group heading. */
+  label: string;
+}
+
 export interface AgentEntry {
   /** Display name, usually the repo token. */
   name: string;
   /** owner/repo. */
   repo: string;
-  /** Public URL, or null when the repo is private. */
+  /** Primary public destination, or null when it is private. */
   url: string | null;
+  /** What the directory card links to and how its CTA is labelled. */
+  destinationKind: "agent-page" | "site" | "repository";
   /** One-line role description. */
   role: string;
-  /** Grouping key — must be one of agents.groups. */
-  group: string;
+  /** Stable grouping key — must match one agents.groups id. */
+  groupId: string;
 }
 
 export interface EngageChannel {
@@ -55,8 +63,8 @@ export interface SiteData {
   };
   agents: {
     intro: string[];
-    /** Ordered group labels; every entry's group must appear here. */
-    groups: string[];
+    /** Ordered groups; every entry's groupId must appear here. */
+    groups: AgentGroup[];
     entries: AgentEntry[];
   };
   engage: {
diff --git a/site-astro/src/pages/agents.astro b/site-astro/src/pages/agents.astro
index 026be23..4de6e3c 100644
--- a/site-astro/src/pages/agents.astro
+++ b/site-astro/src/pages/agents.astro
@@ -1,4 +1,5 @@
 ---
+import AgentDirectoryCard from "../components/AgentDirectoryCard.astro";
 import Layout from "../layouts/Layout.astro";
 import PageHero from "../components/PageHero.astro";
 import site from "../data/site";
@@ -7,9 +8,10 @@ const { agents, hero } = site;
 
 // Preserve the data layer's group order; skip groups with no entries.
 const groups = agents.groups
-  .map((label) => ({
+  .map(({ id, label }) => ({
+    id,
     label,
-    entries: agents.entries.filter((entry) => entry.group === label),
+    entries: agents.entries.filter((entry) => entry.groupId === id),
   }))
   .filter((group) => group.entries.length > 0);
 ---
@@ -22,21 +24,15 @@ const groups = agents.groups
 
   {
     groups.map((group) => (
-      
      
-        
      
-          
      
+      
      
+        
      
+          
      
             {group.label}
           
      
           
        
             {group.entries.map((agent, i) => (
               
      • 
-                
        
-                  
        
-                    {agent.url ? {agent.name} : agent.name}
-                  
        
-                  
        {agent.role}
        
-                  {agent.repo}
-                
        
+                
               
        • 
             ))}
           
      
@@ -52,52 +48,21 @@ const groups = agents.groups
   }
 
   .group-label {
-    font-size: 1.05rem;
+    margin-bottom: 1.3rem;
+    color: var(--ink-soft);
     font-family: var(--font-body);
+    font-size: var(--ac-type-component-title);
     font-variation-settings: normal;
     font-weight: 620;
-    letter-spacing: 0.14em;
+    line-height: var(--ac-leading-ui);
+    letter-spacing: var(--ac-tracking-caps);
     text-transform: uppercase;
-    color: var(--ink-soft);
-    margin-bottom: 1.3rem;
   }
 
   .grid {
-    list-style: none;
     display: grid;
     grid-template-columns: repeat(auto-fill, minmax(15rem, 1fr));
     gap: 1.2rem;
-  }
-
-  .entry {
-    height: 100%;
-    padding: 1.5rem 1.6rem;
-    display: flex;
-    flex-direction: column;
-    gap: 0.35rem;
-  }
-
-  .entry h3 {
-    margin: 0;
-    font-size: 1.18rem;
-  }
-
-  .entry h3 a {
-    color: inherit;
-    text-decoration-color: color-mix(in srgb, var(--accent) 45%, transparent);
-  }
-
-  .entry h3 a:hover {
-    color: var(--accent);
-  }
-
-  .role {
-    font-size: 0.94rem;
-    line-height: 1.55;
-    flex-grow: 1;
-  }
-
-  .entry .repo {
-    font-size: 0.76rem;
+    list-style: none;
   }
 
diff --git a/site-astro/src/pages/agents/colleague.astro b/site-astro/src/pages/agents/colleague.astro
index 25c367b..a2d4c55 100644
--- a/site-astro/src/pages/agents/colleague.astro
+++ b/site-astro/src/pages/agents/colleague.astro
@@ -33,6 +33,9 @@
 // placeholder for it — no invented transcript ever stood in for it.
 import Layout from "../../layouts/Layout.astro";
 import PageHero from "../../components/PageHero.astro";
+import ClosingBand from "../../components/ClosingBand.astro";
+import SectionIntro from "../../components/SectionIntro.astro";
+import StructuredCard from "../../components/StructuredCard.astro";
 import ColleagueDiagram from "../../components/ColleagueDiagram.astro";
 import ColleagueTerminal from "../../components/ColleagueTerminal.astro";
 import site from "../../data/site";
@@ -64,6 +67,7 @@ const dogfood = {
     "The other three are this very page. While it was being specced, colleague explored its own repo as ask-colleague's second, independent mind, and that run was graded through the same ROI loop described above. Then, before this page's pull request opened, colleague reviewed the diff itself — its one real catch shipped, recorded as a first-class deviation on the plan's ledger.",
   ],
 };
+
 ---
 
 
   
      
-    
      
+    
      
       
        
         {
           colleague.facts.map((fact, i) => (
@@ -85,7 +89,17 @@ const dogfood = {
             >
               {fact.label}
               
-                {fact.href ? {fact.value} : fact.value}
+                {fact.href ? (
+                  
+                    {fact.value}
+                  
+                ) : (
+                  fact.value
+                )}
               
             
           ))
@@ -95,27 +109,25 @@ const dogfood = {
   
      
 
   
-  
      
-    
      
-      {colleague.paradigm.eyebrow}
-      
      {colleague.paradigm.headline}
      
-      
      
-        {colleague.paradigm.intro.map((p) => 
      {p}
      )}
-      
      
+  
      
+    
      
+      
       
      
         
       
      
-      
        
+      
          
         {
           colleague.paradigm.cards.map((card, i) => (
-            
        • 
-              
          {card.name}
          
-              
          {card.detail}
          
-            
          • 
+            
           ))
         }
       
        
@@ -126,26 +138,24 @@ const dogfood = {
   
      
 
   
-  
      
-    
      
-      {colleague.tiers.eyebrow}
-      
      {colleague.tiers.headline}
      
-      
      
-        {colleague.tiers.intro.map((p) => 
      {p}
      )}
-      
      
-      
        
+  
        
+    
        
+      
+      
          
         {
           colleague.tiers.cards.map((tier, i) => (
-            
        • 
-              
          {tier.name}
          
-              {tier.surface}
-              
          {tier.detail}
          
-              {tier.commands}
-            
          • 
+            
           ))
         }
       
        
@@ -158,32 +168,30 @@ const dogfood = {
   
        
 
   
-  
        
-    
        
-      {colleague.work.eyebrow}
-      
        {colleague.work.headline}
        
-      
        
-        {colleague.work.intro.map((p) => 
        {p}
        )}
-      
        
-      
          
+  
          
+    
          
+      
+      
            
         {
           colleague.work.cards.map((card, i) => (
-            
          • 
-              
            {card.name}
            
-              {card.verbs}
-              
            {card.detail}
            
-            
            • 
+            
           ))
         }
       
          
-      
-      
          
+      
+      
          
         
          
           
         
          
@@ -195,13 +203,14 @@ const dogfood = {
   
          
 
   
-  
          
-    
          
-      {colleague.subagents.eyebrow}
-      
          {colleague.subagents.headline}
          
-      
          
-        {colleague.subagents.intro.map((p) => 
          {p}
          )}
-      
          
+  
          
+    
          
+      
       
          
 
   
-  
          
-    
          
-      {colleague.cortexSenses.eyebrow}
-      
          {colleague.cortexSenses.headline}
          
-      
          
-        {colleague.cortexSenses.intro.map((p) => 
          {p}
          )}
-      
          
-      
            
+  
            
+    
            
+      
+      
              
         {
           colleague.cortexSenses.cards.map((card, i) => (
-            
            • 
-              
              {card.name}
              
-              {card.role}
-              
              {card.detail}
              
-            
              • 
+            
           ))
         }
       
            
-      
+      
       
            
         
            
           
@@ -286,13 +297,14 @@ const dogfood = {
   
            
 
   
-  
            
-    
            
-      {colleague.memory.eyebrow}
-      
            {colleague.memory.headline}
            
-      
            
-        {colleague.memory.intro.map((p) => 
            {p}
            )}
-      
            
+  
            
+    
            
+      
       
            
         {
           colleague.memory.measured.map((leg, i) => (
@@ -332,24 +344,26 @@ const dogfood = {
   
            
 
   
-  
            
-    
            
-      {colleague.moreSurfaces.eyebrow}
-      
            {colleague.moreSurfaces.headline}
            
-      
            
-        {colleague.moreSurfaces.intro.map((p) => 
            {p}
            )}
-      
            
-      
              
+  
              
+    
              
+      
+      
                
         {
           colleague.moreSurfaces.cards.map((card, i) => (
-            
              • 
-              
                {card.name}
                
-              
                {card.detail}
                
-            
                • 
+            
           ))
         }
       
              
@@ -357,13 +371,14 @@ const dogfood = {
   
              
 
   
-  
              
-    
              
-      {dogfood.eyebrow}
-      
              {dogfood.headline}
              
-      
              
-        {dogfood.intro.map((p) => 
              {p}
              )}
-      
              
+  
              
+    
              
+      
       
       
              
         
              
@@ -393,13 +408,14 @@ const dogfood = {
   
              
 
   
-  
              
-    
              
-      {colleague.whatsNext.eyebrow}
-      
              {colleague.whatsNext.headline}
              
-      
              
-        {colleague.whatsNext.intro.map((p) => 
              {p}
              )}
-      
              
+  
              
+    
              
+      
       
                
         {
           colleague.whatsNext.themes.map((theme, i) => (
@@ -413,7 +429,11 @@ const dogfood = {
               
              
   
              
 
-  
-  
              
-    
              
-      
              
-        {colleague.closing.paragraphs.map((p) => 
              {p}
              )}
-        
              
-          {colleague.closing.repoCta} →
-          {colleague.closing.pypiCta}
-        
              
-      
              
-    
              
-  
              
+  
 
 
 
diff --git a/site-astro/src/pages/agents/devague.astro b/site-astro/src/pages/agents/devague.astro
index 4bad957..9e8185b 100644
--- a/site-astro/src/pages/agents/devague.astro
+++ b/site-astro/src/pages/agents/devague.astro
@@ -19,22 +19,16 @@
 // — nothing on this page runs devague in the browser.
 import Layout from "../../layouts/Layout.astro";
 import PageHero from "../../components/PageHero.astro";
+import ClosingBand from "../../components/ClosingBand.astro";
+import SectionIntro from "../../components/SectionIntro.astro";
+import StructuredCard from "../../components/StructuredCard.astro";
 import DevagueFlow from "../../components/DevagueFlow.astro";
-import DevagueTerminal from "../../components/DevagueTerminal.astro";
+import CaptureSession from "../../components/CaptureSession.astro";
+import CaptureTranscriptModal from "../../components/CaptureTranscriptModal.astro";
 import site from "../../data/site";
 import devague from "../../data/devague";
-import {
-  frameAnnounceCapture,
-  frameInterrogateReviewShift,
-  frameGateConvergeExport,
-  planTaskConvergeExport,
-  scopeSurveySeeds,
-  frameGateLiveRefusal,
-  deviateLedgerRead,
-  summarySkeletonRead,
-  challengeSweepRoute,
-  challengeAdjudicateReexport,
-} from "../../data/devague-captures";
+import { sessions } from "../../data/devague-story";
+
 ---
 
 
   
              
-    
              
+    
              
       
                
         {
           devague.facts.map((fact, i) => (
@@ -56,7 +50,17 @@ import {
             >
               {fact.label}
               
-                {fact.href ? {fact.value} : fact.value}
+                {fact.href ? (
+                  
+                    {fact.value}
+                  
+                ) : (
+                  fact.value
+                )}
               
             
           ))
@@ -66,60 +70,71 @@ import {
   
              
 
   
-  
              
-    
              
-      {devague.pipeline.eyebrow}
-      
              {devague.pipeline.headline}
              
-      
              
-        {devague.pipeline.intro.map((p) => 
              {p}
              )}
-      
              
+  
              
+    
              
+      
       
              
         
       
              
-      
                
+      
                  
         {
-          devague.pipeline.stages.map((stage, i) => (
-            
                1. 
-              
                  {stage.name}
                  
-              {stage.engine}
-              
                  {stage.detail}
                  
-              {stage.verbs}
+          devague.pipeline.stages.map((stage) => (
+            
                2. 
+              
                  
+                
                  {stage.engine}
                  
+                
                  {stage.name}
                  
+              
                  
+
+              
                  
+                
                  {stage.detail}
                  
+                
                    
+                  {
+                    stage.verbs.split(" · ").map((verb) => (
+                      
                  • {verb}
                    • 
+                    ))
+                  }
+                
                  
+              
                  
             
                  3. 
           ))
         }
-      
              
+
    -
    -
    - {devague.method.eyebrow} -

    {devague.method.headline}

    -
    - {devague.method.intro.map((p) =>

    {p}

    )} -
    -
      +
      +
      + +
        { devague.method.moves.map((move, i) => ( -
      1. - -

        {move.verb}

        -

        {move.ask}

        -

        {move.detail}

        -
        2. + )) }
      @@ -127,13 +142,14 @@ import {
      -
      -
      - {devague.reviewLoop.eyebrow} -

      {devague.reviewLoop.headline}

      -
      - {devague.reviewLoop.intro.map((p) =>

      {p}

      )} -
      +
      +
      +
        { devague.reviewLoop.steps.map((step, i) => ( @@ -142,8 +158,32 @@ import { data-reveal style={`--reveal-delay: ${Math.min(i * 0.07, 0.28)}s`} > - {step.cmd} -

        {step.effect}

        +
        +

        + + {" · "} + {step.kind} +

        +

        {step.title}

        +

        + { + step.effect.map((part) => + typeof part === "string" ? part : {part.code} + ) + } +

        +
        + +
        +
        + + human gate +
        + + + {step.cmd} + +
        )) } @@ -152,25 +192,28 @@ import {
      -
      -
      - {devague.skills.eyebrow} -

      {devague.skills.headline}

      -
      - {devague.skills.intro.map((p) =>

      {p}

      )} -
      -
        +
        +
        + +
          { devague.skills.cards.map((card, i) => ( -
        • -

          {card.name}

          - {card.leg} -

          {card.duty}

          -
          • + )) }
        @@ -178,77 +221,29 @@ import {
        -
        -
        - {devague.captures.eyebrow} -

        {devague.captures.headline}

        -
        - {devague.captures.intro.map((p) =>

        {p}

        )} -
        - -
        -
        - -
        -
        - -
        -
        - -
        -
        - -
        -
        - -
        -
        - -
        -
        - -
        -
        - -
        -
        - -
        -
        - -
        -
        - -
        -
        - -
        -
        - -
        -
        - -
        -
        +
        +
        + + {sessions.map((session) => )}

        {devague.captures.provenance}

        +
        -
        -
        - {devague.whatsNext.eyebrow} -

        {devague.whatsNext.headline}

        -
        - {devague.whatsNext.intro.map((p) =>

        {p}

        )} -
        +
        +
        +
        - -
        -
        -
        - {devague.closing.paragraphs.map((p) =>

        {p}

        )} -

        - {devague.closing.repoCta} → - {devague.closing.pypiCta} -

        -
        -
        -
        + + + diff --git a/site-astro/src/pages/agents/lobes.astro b/site-astro/src/pages/agents/lobes.astro index ba797f5..6cca76a 100644 --- a/site-astro/src/pages/agents/lobes.astro +++ b/site-astro/src/pages/agents/lobes.astro @@ -6,6 +6,10 @@ // ../../data/lobes-captures.ts — nothing on this page dials a machine. import Layout from "../../layouts/Layout.astro"; import PageHero from "../../components/PageHero.astro"; +import ClosingBand from "../../components/ClosingBand.astro"; +import DestinationCard from "../../components/DestinationCard.astro"; +import SectionIntro from "../../components/SectionIntro.astro"; +import StructuredCard from "../../components/StructuredCard.astro"; import LobesDiagram from "../../components/LobesDiagram.astro"; import LobesTerminal from "../../components/LobesTerminal.astro"; import site from "../../data/site"; @@ -19,6 +23,7 @@ import { meshThor, meshAsk, } from "../../data/lobes-captures"; + ---
        -
        +
          { lobes.facts.map((fact, i) => ( @@ -40,7 +45,17 @@ import { > {fact.label} - {fact.href ? {fact.value} : fact.value} + {fact.href ? ( + + {fact.value} + + ) : ( + fact.value + )} )) @@ -50,25 +65,23 @@ import {
        -
        -
        - the lobes -

        One machine serves a small fleet of minds

        -
        - {lobes.story.what.map((p) =>

        {p}

        )} -
        -