- {release.headline ?
+ {release.headline && (
{renderInline(release.headline)}
- : null}
+ )}
{release.summary ?
{renderInline(release.summary)}
@@ -124,7 +124,7 @@ const ReleaseCard = ({
const items = release[field];
if (!items?.length) {
- return null;
+ return undefined;
}
return (
diff --git a/src/pages/changelog/types.ts b/src/pages/changelog/types.ts
index f0c9e0e..81f0843 100644
--- a/src/pages/changelog/types.ts
+++ b/src/pages/changelog/types.ts
@@ -14,5 +14,4 @@ export type Release = ReleaseLead & {
// required union documents the rule; scripts/check-release-titles.mjs enforces
// it across every release file at build time.
type ReleaseLead =
- | {headline: string; summary?: string}
- | {headline?: string; summary: string};
+ {headline: string; summary?: string} | {headline?: string; summary: string};
diff --git a/src/pages/consulting/sections/Consulting.tsx b/src/pages/consulting/sections/Consulting.tsx
index e9b2e6c..dd9aa01 100644
--- a/src/pages/consulting/sections/Consulting.tsx
+++ b/src/pages/consulting/sections/Consulting.tsx
@@ -772,7 +772,7 @@ const Consulting = () => {
{SKUS.map((sku) => (
diff --git a/src/pages/features/App.tsx b/src/pages/features/App.tsx
index 9c38231..ea9674f 100644
--- a/src/pages/features/App.tsx
+++ b/src/pages/features/App.tsx
@@ -10,6 +10,7 @@ import Hero from './sections/Hero';
import LoadOnDemand from './sections/LoadOnDemand';
import ObsidianWikiDetail from './sections/ObsidianWikiDetail';
import Principles from './sections/Principles';
+import ReactPerf from './sections/ReactPerf';
import Stack from './sections/Stack';
import StateOnDisk from './sections/StateOnDisk';
import Trust from './sections/Trust';
@@ -23,6 +24,7 @@ const App = () => {
+
diff --git a/src/pages/features/sections/AgenticDesignDetail.tsx b/src/pages/features/sections/AgenticDesignDetail.tsx
index 5a73a2f..580cfba 100644
--- a/src/pages/features/sections/AgenticDesignDetail.tsx
+++ b/src/pages/features/sections/AgenticDesignDetail.tsx
@@ -88,7 +88,7 @@ const pad = (n: number) => String(n + 1).padStart(2, '0');
const AgenticDesignDetail = () => (
diff --git a/src/pages/features/sections/Fitness.tsx b/src/pages/features/sections/Fitness.tsx
index c026471..fdc4f2e 100644
--- a/src/pages/features/sections/Fitness.tsx
+++ b/src/pages/features/sections/Fitness.tsx
@@ -93,7 +93,7 @@ const gradeTone = (grade: string) => {
const Fitness = () => (
diff --git a/src/pages/features/sections/Forensics.tsx b/src/pages/features/sections/Forensics.tsx
index 62af6a3..9dd726e 100644
--- a/src/pages/features/sections/Forensics.tsx
+++ b/src/pages/features/sections/Forensics.tsx
@@ -2,7 +2,7 @@ import ForensicsIssue from './figures/ForensicsIssue';
const Forensics = () => (
diff --git a/src/pages/features/sections/FxSection.tsx b/src/pages/features/sections/FxSection.tsx
index 523b34a..3277708 100644
--- a/src/pages/features/sections/FxSection.tsx
+++ b/src/pages/features/sections/FxSection.tsx
@@ -18,7 +18,7 @@ const FxSection = ({
title,
}: Properties) => (
diff --git a/src/pages/features/sections/GaiaCi.tsx b/src/pages/features/sections/GaiaCi.tsx
index bc51a13..dafbd5d 100644
--- a/src/pages/features/sections/GaiaCi.tsx
+++ b/src/pages/features/sections/GaiaCi.tsx
@@ -68,7 +68,7 @@ const TONE: Record
= {
const GaiaCi = () => (
diff --git a/src/pages/features/sections/LoadOnDemand.tsx b/src/pages/features/sections/LoadOnDemand.tsx
index 9f114b3..3db3bbd 100644
--- a/src/pages/features/sections/LoadOnDemand.tsx
+++ b/src/pages/features/sections/LoadOnDemand.tsx
@@ -36,6 +36,9 @@ const COLUMNS: Column[] = [
- 'app/**/*.css'
---
+
+ # Tailwind Conventions
+
imports
guess
trace
+
+ rename
+ sed
+ safe
/gaia-audit sweeps memory, the wiki, and autoloaded files
for duplication, stale entries, and rules over budget. It catches
contradictions, not just copies. One review gate stands between the
- findings and your files, cleared with one keystroke. Interrupted runs
- resume, every change is a git-revertable diff, and GAIA flags when a
- sweep is worth running.
+ findings and your files, and GAIA flags when a sweep is worth running.
),
name: 'Knowledge audit',
@@ -133,7 +138,7 @@ const codeStyles =
const LoadOnDemand = () => (
diff --git a/src/pages/features/sections/Principles.tsx b/src/pages/features/sections/Principles.tsx
index fce5b4c..7e70ba0 100644
--- a/src/pages/features/sections/Principles.tsx
+++ b/src/pages/features/sections/Principles.tsx
@@ -9,7 +9,7 @@ const PRINCIPLES = [
const Principles = () => (
+ {'A '}
+
+ bippy
+
+ {
+ ' harness records every render to disk, then a deterministic CLI reduces tens of thousands of tokens of raw capture to the small ranked summary the model reads. The raw dump never enters context.'
+ }
+
+ ),
+ name: 'The raw capture stays on disk',
+ },
+ {
+ desc: 'It flags a memoized component that re-renders anyway when its props or context arrive as a new object or callback every render, and any component whose render crosses the frame budget, memo or not. A cheap re-render with real changes is left alone, so nothing pushes you toward memoizing everything.',
+ name: 'Two signals, not noise',
+ },
+ {
+ desc: 'Findings lead with the memoized components that re-render anyway, then rank by wasted cost: how often each one re-renders times how long a render takes. A barely perceptible render-count win never outranks a memo that keeps re-rendering an expensive subtree on every parent update.',
+ name: 'Ranked by what users feel',
+ },
+];
+
+const ReactPerf = () => (
+
+
+
+
+
+
+ A React app slows down one wasted render at a time. From the outside
+ the app just feels slow. From the inside, you are guessing which
+ component, and why. The profiler shows you every render and ranks
+ none of them.
+
+
+
+ /gaia-react-perf
+
+ {
+ ' drives the interaction you point it at and captures real per-render attribution. The capture runs on the same React instrumentation that powers '
+ }
+
+ react-scan
+
+ , wired into Claude, not a browser overlay. It surfaces two failure
+ modes: a memoized component that re-renders anyway because a prop or
+ context value it depends on is a new object or callback every
+ render, and any component whose render crosses a 16 ms frame budget,
+ memo or not. It skips the cheap re-renders that push you toward
+ memoizing everything, then names the structural fix for what is
+ left.
+
+
+
+
+ {/* Reduced summary · centerpiece */}
+
+
+ /gaia-react-perf
+
+
+ Over budget
+
+ 2
+
+
+
+
+ {TOTALS.map((total) => (
+
+ {total.value}
+ {` ${total.label}`}
+
+ ))}
+
+
+
+
+ Ranked findings
+
+ {FINDINGS.map((finding, index) => (
+
+
{index + 1}
+
+
+
+ {finding.component}
+ {finding.isMemo && (
+
+ memo
+
+ )}
+
+
+ {`${finding.maxTotalMs} ms max`}
+ {finding.exceedsBudget && (
+ {` · over ${FRAME_BUDGET}`}
+ )}
+
+
+
+ {finding.memoDefeated > 0 ?
+ `${finding.renderCount} renders · ${finding.memoDefeated} memo-defeated`
+ : `${finding.renderCount} renders`}
+
+ {finding.inputs.length > 0 && (
+
+
+ {finding.source === 'context' ?
+ 'unstable context: '
+ : 'unstable props: '}
+
+
+ {finding.inputs.join(', ')}
+
+
+ )}
+ {finding.cause && (
+
+ {'react-doctor · '}
+ {finding.cause}
+
+ )}
+
+
+ ))}
+
+
+
+
+ Diagnosis
+
+
+ Two findings cross the 16 ms frame budget, and the fixes differ.
+ Give OrdersTable stable props so its memo holds, then cut the
+ per-render work in RevenueChart, which has no memo at all.
+
+
+
+
+
+ Measure-only: GAIA diagnoses, Claude applies the fix you approve, then
+ re-runs /gaia-react-perf to confirm the finding drops to zero.
+
+
+ {/* Meta strip */}
+
+ {META.map(({desc, name}) => (
+
+
-
+ {name}
+
+ -
+ {desc}
+
+
+ ))}
+
+
+);
+
+export default ReactPerf;
diff --git a/src/pages/features/sections/StateOnDisk.tsx b/src/pages/features/sections/StateOnDisk.tsx
index 310d79a..5f37437 100644
--- a/src/pages/features/sections/StateOnDisk.tsx
+++ b/src/pages/features/sections/StateOnDisk.tsx
@@ -2,7 +2,7 @@ import TokenArtifacts from './figures/TokenArtifacts';
const StateOnDisk = () => (
diff --git a/src/pages/features/sections/Trust.tsx b/src/pages/features/sections/Trust.tsx
index ab84e20..5583e42 100644
--- a/src/pages/features/sections/Trust.tsx
+++ b/src/pages/features/sections/Trust.tsx
@@ -30,11 +30,23 @@ const POINTS: {desc: ReactNode; name: string}[] = [
name: 'Bundled skills wired in for write-time quality',
},
{
- desc: 'Specs become Playwright E2E tests before code is written. The first task in any feature is turning red tests green.',
+ desc: 'Before any code, GAIA turns adversarial agents on its own spec and plan. They try to refute each decision and dependency against the real repo, so a flawed assumption surfaces at planning time, not in review.',
+ name: 'Verified before it’s built',
+ },
+ {
+ desc: 'Specs become Playwright E2E tests before code is written. The first task in any feature is turning red tests green, and the red has to be real. A test that can’t fail proves nothing.',
name: 'Test-driven development',
},
{
- desc: 'The code-review-audit agent scans for security, performance, architecture, code smells, and antipatterns. Extendable with custom rules.',
+ desc: (
+ <>
+ {
+ 'The code-review-audit agent scans for security, performance, architecture, code smells, and antipatterns. Real problems it finds beyond the PR’s scope aren’t dropped or used to block your merge. The audit files them as tracked, deduplicated issues, and '
+ }
+
/gaia-debt
+ {' drains them one reviewed PR at a time.'}
+
+ ),
name: 'Code review before every merge',
},
];
diff --git a/src/pages/features/sections/UpdateDeps.tsx b/src/pages/features/sections/UpdateDeps.tsx
index bf760ec..122fc1c 100644
--- a/src/pages/features/sections/UpdateDeps.tsx
+++ b/src/pages/features/sections/UpdateDeps.tsx
@@ -1,14 +1,30 @@
-const POINTS = [
+import type {ReactNode} from 'react';
+
+const POINTS: {desc: ReactNode; name: string}[] = [
{
desc: 'When a new dependency version requires a codemod or breaking-change migration, GAIA makes sure Claude handles it. The PR includes the bump and the migration together.',
name: 'Codemods and migrations applied',
},
{
- desc: 'When the new version moves or renames public API surface, Update Deps updates the call sites. Grep-replace-with-context work, automated.',
+ desc: (
+ <>
+ {'When the new version moves or renames public API surface, '}
+
/update-deps
+ {' updates the call sites. Grep-replace-with-context work, automated.'}
+
+ ),
name: 'Call sites updated when APIs change',
},
{
- desc: 'When two simultaneous upgrades touch the same code path, Update Deps resolves the overlap before opening the PR. No conflicting PRs that fight at merge.',
+ desc: (
+ <>
+ {'When two simultaneous upgrades touch the same code path, '}
+
/update-deps
+ {
+ ' resolves the overlap before opening the PR. No conflicting PRs that fight at merge.'
+ }
+
+ ),
name: 'Conflicts resolved before the PR opens',
},
{
@@ -120,7 +136,7 @@ const GaiaCard = () => (
const UpdateDeps = () => (
diff --git a/src/pages/features/sections/figures/TrustGraphic.tsx b/src/pages/features/sections/figures/TrustGraphic.tsx
index d9345a0..8d665f8 100644
--- a/src/pages/features/sections/figures/TrustGraphic.tsx
+++ b/src/pages/features/sections/figures/TrustGraphic.tsx
@@ -5,7 +5,7 @@ type Stage = {
const STAGES: Stage[] = [
{label: 'typecheck', result: '0 errors'},
- {label: 'lint · 1,314 rules', result: '0 violations'},
+ {label: 'lint · 1,450 rules', result: '0 violations'},
{label: 'tests · vitest + RTL', result: '47 / 47'},
{label: 'build · 9 entries', result: 'green'},
];
diff --git a/src/pages/get-started/sections/GetStarted.tsx b/src/pages/get-started/sections/GetStarted.tsx
index 052a2c8..31264de 100644
--- a/src/pages/get-started/sections/GetStarted.tsx
+++ b/src/pages/get-started/sections/GetStarted.tsx
@@ -66,7 +66,6 @@ const TERM_SCRIPT: TermStep[] = [
type: 'line',
},
{text: '', type: 'line'},
- {cls: 'muted', text: '+ 47 dependencies, 41 devDependencies', type: 'line'},
{
cls: 'dim',
delay: 320,
@@ -739,7 +738,7 @@ const GetStartedHero = ({
·
- Node.js ≥ 22.19.0
+ Node.js ≥ 22.22.0
{'. We recommend '}
/setup-gaia-ci, installs them.
+ /setup-gaia, installs them.
),
title: 'Standing CI',
@@ -812,7 +811,7 @@ const RECAP = [
const WhatYouGet = () => (
@@ -865,11 +864,7 @@ const WhatYouGet = () => (
['', 'my-app/'],
['├── ', '.claude/', ''],
['│ ├── ', 'agents/', ' # code-review-audit'],
- [
- '│ ├── ',
- 'commands/',
- ' # /gaia-init, /setup-gaia-ci',
- ],
+ ['│ ├── ', 'commands/', ' # /gaia-init, /setup-gaia'],
['│ ├── ', 'hooks/', ' # guardrail hooks'],
[
'│ ├── ',
@@ -886,7 +881,7 @@ const WhatYouGet = () => (
['├── ', '.husky/', ' # pre-commit'],
['├── ', '.specify/', ' # spec-driven workflow'],
['├── ', '.storybook/', ''],
- ['├── ', 'app/', ' # React Router 7 app'],
+ ['├── ', 'app/', ' # React Router 8 app'],
['├── ', 'test/', ' # Vitest, RTL, MSW'],
['├── ', 'wiki/', ' # Obsidian project memory'],
['├── ', 'CLAUDE.md', ' # project brain'],
@@ -1000,10 +995,12 @@ const GetStarted = () => {
const section = document.querySelector('#whats-included');
if (!section) return;
const {top} = section.getBoundingClientRect();
- // Leave the user alone if they've already scrolled the section into view.
- if (top < window.innerHeight - 80) return;
const headerHeight =
document.querySelector('header')?.getBoundingClientRect().height ?? 60;
+ // Only bail once the user has already scrolled the section to (or past)
+ // its resting spot under the sticky header. A small nudge that leaves the
+ // section partway down still gets finished for them; we never yank up.
+ if (top <= headerHeight + 8) return;
// Land the section's top flush under the sticky header, no gap.
window.scrollTo({
behavior: 'smooth',
diff --git a/src/pages/home/sections/Hero.tsx b/src/pages/home/sections/Hero.tsx
index 9241ba7..c65bdc2 100644
--- a/src/pages/home/sections/Hero.tsx
+++ b/src/pages/home/sections/Hero.tsx
@@ -67,7 +67,7 @@ const Hero = () => (
GAIA is the engineering discipline for Claude Code.
- Keep the AI speed, lose the debt.
+ Keep the speed, lose the debt.
diff --git a/src/pages/why/sections/Diagnosis.tsx b/src/pages/why/sections/Diagnosis.tsx
index dae87aa..7eb5c16 100644
--- a/src/pages/why/sections/Diagnosis.tsx
+++ b/src/pages/why/sections/Diagnosis.tsx
@@ -38,7 +38,7 @@ const FAILURES: Item[] = [
const Diagnosis = () => (
diff --git a/src/pages/why/sections/Discipline.tsx b/src/pages/why/sections/Discipline.tsx
index c425197..f37e76d 100644
--- a/src/pages/why/sections/Discipline.tsx
+++ b/src/pages/why/sections/Discipline.tsx
@@ -1,6 +1,6 @@
const Discipline = () => (