docs: migrate /gaia router to discrete commands, sync post-#277 drift, fix table rendering#3
Merged
Merged
Conversation
Tracks gaia PR #277, which deleted the /gaia skill router and split its workflows into five commands (/gaia-plan, /gaia-spec, /gaia-audit, /gaia-fitness, /gaia-forensics) and three skills (/gaia-wiki, /gaia-handoff, /gaia-pickup). - commands/index.mdx: drop the "skill router" framing and SKILL.md path, reframe as discrete /gaia-* entries, replace obsolete help-message section - rename /gaia <sub> -> /gaia-<sub> across command, reference, contributor, and getting-started pages plus sidebar labels - note natural-language triggers for the three skills - update CLAUDE.md surface map (Layers 1-3), adding /gaia-fitness and the setup-gaia-ci command; verified against .gaia/release-exclude - leave CLI no-slash forms and GitHub URLs intact Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
- Add the a11y-fixes skill to the Code skills page - Add the pr-merge rule to the rules reference (always-loaded) - Summarize audit-ci-tests.yml and the on-demand gaia-ci-* workflows in contributors/ci - Name the canonical /speckit-gaia-spec-close in the spec page - Note the gaia update-deps CLI primitive behind the /update-deps skill - Refresh the source-survey snapshot to gaia 3ab9e1b (286 items) Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
astro 6.4.2 is incompatible with the @astrojs/mdx 5.0.6 that Starlight bundles: under astro 6.4's changed markdown API, MDX silently drops GFM, so every table rendered as raw text site-wide (0 <table> in the build). Roll back to the known-good astro 6.3.0 / starlight 0.39.1 with a single @astrojs/markdown-remark. Re-bump only when Starlight ships an @astrojs/mdx built for astro 6.4. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
stevensacks
changed the title
- hooks: add block-no-verify, red-verify-commit-check, capture-red-observations (SPEC-003) - rules: add dep-audit (Dependency-CVE advisory) - agents: code-review-audit now runs pnpm audit advisory alongside react-doctor/knip - wiki: /gaia-wiki lint is standalone GAIA-native; add checks #14/#15/#16, drop stale claude-obsidian wrap claim - cli: add gaia wiki frontmatter and empty-sections subcommands Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Captures the 1.5.0 surface (and post-tag contributor-only #317/#318). Drift since 3ab9e1b: 13 NEW, 0 REMOVED, 0 AUDIENCE-CHANGED. The adopter NEW items (dep-audit rule, 3 TDD RED-verification hooks, gaia wiki frontmatter/empty-sections) are now documented; release-notes skill is contributor-only and intentionally undocumented. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Adds v1.5.0 on its own line above the copyright/MIT line. Version is a hardcoded constant (docs build has no access to the gaia repo in CI); bump it on each release. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
- Move GAIA_VERSION into shared src/version.ts (single bump point). - Mobile: version + copyright render on one line; desktop keeps the version on its own line above the copyright. - Mobile colophon vertical padding 0.5rem top / 0 bottom. - Mobile "On this page" toggle padding set to 0.5rem. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
The /gaia router was split into discrete /gaia-* commands and skills (#277); there is no longer a gaia skill acting as a command. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
Started as a docs sync for gaia PR #277 (the
/gaiarouter split) and grew to cover the follow-on drift found bysource-survey, plus a build-rendering regression discovered along the way.1.
/gaiarouter migration (#277)Tracks gaia PR #277, which deleted the
/gaiaskill router (gaia/SKILL.md) and split its workflows into discrete, autocomplete-visible slash entries: five commands (/gaia-plan,/gaia-spec,/gaia-audit,/gaia-fitness,/gaia-forensics) and three skills (/gaia-wiki,/gaia-handoff,/gaia-pickup). Sub-args are unchanged; workflow logic still dispatches into the survivingreferences/*.commands/index.mdx— dropped the "/gaiais a skill router at.claude/skills/gaia/SKILL.md" framing (that file is deleted) and the obsolete "Help message" section. Reframed as discrete/gaia-*entries./gaia <sub>→/gaia-<sub>across command pages (titles, prose, code blocks, headings, cross-links), reference/contributor/getting-started pages, and sidebar labels inastro.config.mjs. Also/gaia spec close→/gaia-spec closeand "skill family" → "skill".wiki.mdxandhandoff-pickup.mdxnow note these skills also fire on plain-English asks ("sync the wiki", "write a handoff", "pick up where we left off").CLAUDE.mdsurface map — updated Layers 1-3 (router removed, the five commands + three skills added,/gaia-fitnessand/setup-gaia-cinow listed). Verified adopter-vs-contributor split against.gaia/release-exclude.2. Post-#277 drift pass
source-surveyfound the snapshot was 232 commits stale and surfaced gaps that slipped through:skills/code.mdx— documented the newa11y-fixesskill (axe-core violation fixes).reference/rules.mdx— added the newpr-mergerule to the always-loaded table.contributors/ci.mdx— addedaudit-ci-tests.ymland a summary of the on-demandgaia-ci-*workflows installed by/setup-gaia-ci(cross-linked, not enumerated).commands/spec.mdx— named the canonical/speckit-gaia-spec-closefor SPEC disposition.commands/update-deps.mdx— noted thegaia update-depsCLI primitive backing the skill and CI..claude/audit/source-state.json— regenerated the survey snapshot against gaia3ab9e1b(286 items).3. Fix: MDX table rendering regression
The earlier astro 6.4.2 / starlight 0.39.2 bump broke GFM tables site-wide: astro 6.4 is incompatible with the
@astrojs/mdx5.0.6 that Starlight bundles, so MDX silently dropped GFM and every table rendered as raw| --- |text (0<table>in the build). Reverted to the known-good astro 6.3.0 / starlight 0.39.1 (single@astrojs/markdown-remark). Re-bump only when Starlight ships an@astrojs/mdxbuilt for astro 6.4.4. Contributors overview list order
Reordered the "What's in this section" list on
contributors/index.mdxto match the sidebar (CI → CLI → Health audit → Release → Wiki).Left intact (by design)
gaia wiki sync land,.gaia/cli/gaia) oncontributors/cli.mdxsrc/overrides/*.astrowhite-space: nowraprule intheme.css(only its stale comment example updated)Verification
pnpm buildclean — 27 pages built, no broken links<table>again (regression fixed); deprecation warning gone/gaia <sub>in published content / sidebarsrc/.gaia/release-exclude🤖 Generated with Claude Code