| name | gaia |
| description | GAIA workflow router. Dispatches to the user-invoked GAIA workflows - plan (task orchestration), spec (Socratic SPEC artifact), handoff (session handoff doc), pickup (resume from handoff), audit (knowledge audit), forensics (bug report bridge), wiki (sync/consolidate/lint chain). Trigger on `/gaia <subcommand>` or natural-language asks like "kick off a plan", "write a handoff", "pick up where we left off", "audit the knowledge stores", "sync the wiki". |
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. |
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)
forensics [description] Capture a redacted, classified, file-able bug report
wiki [sync|consolidate|lint] Wiki maintenance (full chain if no sub-arg)
