GAIA Router
User-invoked GAIA workflows. The first argument selects the sub-command.
Routing
Parse the first whitespace-separated token of $ARGUMENTS:
| First arg | Action |
|---|---|
plan | Read references/plan.md and follow it. |
spec | Read references/spec.md and follow it. |
handoff | Read references/handoff.md and follow it. |
pickup | Read references/pickup.md and follow it. |
audit | Read references/audit.md and follow it. |
fitness | Read references/fitness.md and follow it. |
forensics | Read references/forensics.md and follow it. |
wiki | Read references/wiki.md and follow it. |
| (anything else, including empty) | print help |
Reference paths are relative to this skill (.claude/skills/gaia/). Strip the first arg before passing the remainder; inside the reference, $ARGUMENTS semantically refers to whatever followed the sub-command (e.g. --apply for audit, sync for wiki).
Help message format:
Usage: /gaia <subcommand> [args]
plan [description] Plan a feature using task orchestration
spec [description] Socratic discovery to author an immutable SPEC artifact
spec auto [description] Non-interactive: agent answers Socratic questions, mirrors to GitHub issue, chains to /gaia plan
handoff [notes] Generate a session handoff document
pickup Restore context from the most recent handoff
audit [--apply] Audit memory + wiki and apply changes (--apply: re-apply existing report only)
fitness Check + auto-heal this project's Claude integration (triage/heal/verify, F-to-A+ grade)
forensics [description] Capture a redacted, classified, file-able bug report
wiki [sync|consolidate|lint] Wiki maintenance (full chain if no sub-arg)