Changelog

Notable changes to slashsynthex.com — the public marketing and documentation site. For Synthex plugin releases, see the upstream repository at

.

Versions follow SemVer with site-content-level granularity: major = visual/IA overhauls, minor = new pages or sections, patch = copy/style fixes.

#Next — Grok install

The public install guides now include Grok beside the other supported harnesses. Grok uses the same LumenAI marketplace and the same generated Agent Skills as Codex. The canonical command and agent Markdown is unchanged.

#Added

• Agent compatibility and Getting started — native Grok install (grok plugin marketplace add, grok plugin install synthex --trust, grok plugin enable synthex) and /synthex:<command> invocation examples.
• FAQ, links, marketplace, plugin architecture, and llms.txt — Grok is listed with the native plugin installs. The links page points at the Grok skills and marketplace docs.

#Next — Synthex 1.0

Synthex is becoming Claude-first, now for any agent. Claude Code remains the original and primary plugin experience; version 1.0 also distributes the same workflows through Agent Skills for Codex CLI, Gemini CLI, OpenCode, and future compatible harnesses.

#Added

• Agent compatibility — install and invocation instructions for Claude Code, Codex CLI, Gemini CLI, and OpenCode, plus the boundary between portable workflows and Claude-native features.
• Shared-source architecture documentation — explains how canonical agents/ and commands/ Markdown drives generated SKILL.md entrypoints without copying prompts.

#Amended

• Site-wide product language — preserves Synthex's Claude Code roots while accurately describing its Agent Skills distribution and supported harnesses.
• Marketplace, FAQ, links, search, sitemap, and AI-readable documentation — now point to the multi-harness installation guide and supported agent ecosystem.

#0.2.1 — 2026-06-08

Native-looping reliability fix, tracked from upstream. Synthex 0.9.10 + synthex-plus 0.5.10 hardens how a loop binds to its Claude Code session so iteration keeps being driven to completion instead of silently stalling at the first turn-end. This release clarifies that session binding on the concept page. See the upstream plugin release at

.

#Amended

• Native looping concept page — the Multi-session section now notes that each loop is stamped with the id of the session that starts it (and re-stamped on resume). That binding is what lets the framework keep driving a loop turn after turn; the full state-schema and gate-ownership rules live in the upstream spec.

#Acknowledgements

The plugin-side fix was authored and shipped by the upstream Synthex maintainers; this release covers only the documentation work to surface it on the public site.

#0.2.0 — 2026-05-14

Native-looping coverage. The Synthex plugin shipped a native iteration primitive (synthex 0.8.0 + synthex-plus 0.4.0); this release documents and showcases it across the site. See the upstream plugin release at

.

#Added

• Concept page — /docs/concepts/native-looping. Canonical explainer for the iteration framework: state file schema, shared-context vs. isolation mode, multi-session semantics, promise emission, and coexistence with the official ralph-loop plugin.
• Command reference pages (3 new) — full overlays for /synthex:loop/synthex:loop, /synthex:list-loops/synthex:list-loops, and /synthex:cancel-loop/synthex:cancel-loop. Parameter tables, examples, refusal paths, and cross-references to the concept page.
• Command reference page (1 new) — /synthex:refine-requirements/synthex:refine-requirements finally has its own overlay (it previously shipped with only the structured fallback).
• Landing-page feature card — a "Native looping" section between Lifecycle and the Org Chart, with a terminal-style example and a CTA to the concept page. Static SSG; no client JS added.

#Amended

• /synthex:next-priority/synthex:next-priority, /synthex:review-code/synthex:review-code, and /synthex:write-implementation-plan/synthex:write-implementation-plan reference pages each gained a "Native looping" subsection with that command's emission rule and an example.
• Sidebar nav and sitemap include the new concept page and reference pages.

#Acknowledgements

The plugin-side feature was authored and shipped by the upstream Synthex maintainers; this release covers only the documentation work to surface it on the public site.

#0.1.0 — 2026-05-11

Initial public release. The site goes live at slashsynthex.com with the full code-side deliverable across the five planned phases.

#Pages

• Landing — marketing hero, lifecycle, 15-agent org chart with three tiers, command grid, quickstart, footer with Bluminal sponsor credit.
• Docs — three-pane shell with sidebar / right-TOC / scroll-spy. Group ordering: Get started → Concepts → Reference → Extending → Resources. Cmd+K palette across all routes.
• Concepts (7 pages) — Philosophy (excerpt + canonical link to AJ's essay), Lifecycle, Quality gates, Reviewer pipeline, Parallel execution, Marketplace, plus the standalone Configuration reference.
• Reference (7 pages) — includes an Agents directory with per-agent slug routes (15), a Commands directory with per-command slug routes (11), Documents, Specs, ADRs, RFCs, and Plugin architecture.
• Extending (2 pages) — Authoring agents, Authoring commands.
• Top-level — Examples (4 Coming-Soon slots), FAQ (6 Q&A), Links.

#Per-route OG cards

Every route ships with a tailored OG image generated at the edge via @vercel/og. Landing, docs-section, and reference-detail templates cover the full surface. All four dynamic OG handlers wrap their primary render in try/catch with a system-font fallback.

#Programmatic affordances

• <SlashCommand> — single typographic source of truth for the /synthex:<verb> mark across NavBar, OrgChart, Commands grid, MDX, Cmd+K palette, and OG templates.
• <AnchorButton> — left-margin # glyph on every H2/H3 with one-click deep-link copy and <Toast> feedback.
• <PageShare> — Copy URL / Copy as markdown / Share to X / Share to LinkedIn dropdown on every docs page.
• <Toast> — aria-live="polite" provider, FIFO stack of 3, opacity-only animation under prefers-reduced-motion.
• CodeBlock copy — every fenced code block gets a copy button; raw-code copy strips leading prompts ($, ▸, >).

#SEO + AI-search

• JSON-LD on every route: WebSite + Organization site-wide, plus SoftwareApplication, HowTo, TechArticle, BreadcrumbList, CollectionPage, FAQPage as appropriate.
• dateModified derived from git log -1 per source file (no rebuild-time noise).
• public/llms.txt short summary; public/llms-full.txt regenerated at build from all docs MDX.
• Sitemap with 47+ entries; robots.txt allows all crawlers, disallows /design/.
• Lighthouse: /docs and /docs/getting-started pass all four thresholds (Perf 95+, A11y 96, BP 95+, SEO 100).

#Quality gates (CI-enforced)

• ESLint with custom synthex/no-styled-jsx-in-loops rule (D13).
• TypeScript strict mode (noUncheckedIndexedAccess, exactOptionalPropertyTypes).
• Vitest 169/169 unit tests.
• Playwright e2e + a11y; npm run test:a11y passes 15/15 on the local build + 3/3 on the live deploy.
• size-limit budgets per D19 (HTML ≤25KB, JS ≤240KB, CSS ≤30KB — gzipped).
• Local structured-data audit validates every JSON-LD block against minimal Schema.org rules.
• Local internal-link audit asserts zero broken hrefs.
• llms-full.txt staleness check.

#Infrastructure

• Hosted on Vercel (project bluminal-labs/slashsynthex-web) with auto-deploy from main.
• Apex slashsynthex.com + www redirect; HSTS preload-eligible.
• Plugin data sync (data/agents.json + data/commands.json) refreshed from the upstream LumenAI repo at build, with committed-snapshot fallback for rate-limit / outage resilience.

#Acknowledgements

Sponsored and developed by Bluminal. The Ralph Loop driving the authoring iterations is itself a Claude Code plugin pattern.

#Upcoming

• Pagefind search (post-launch, replacing the current static Cmd+K index)
• Examples pages (the four Coming-Soon slots filled in)
• AJ's "Agentic Software Delivery" essay republished where appropriate

The implementation plan tracks per-task status at the source level; this changelog records material site changes as they ship.