'use strict'; /** * capability-registry.cjs — generated by scripts/gen-capability-registry.cjs * DO NOT EDIT BY HAND. Run: node scripts/gen-capability-registry.cjs --write * ADR-894 §5 — role-partitioned Capability Registry. */ const capabilities = { "ai-integration": { "id": "ai-integration", "role": "feature", "title": "AI design contract", "description": "AI-SPEC design contract workflow for phases that build AI systems; owns the AI integration command, agents, and workflow.ai_integration_phase activation key.", "tier": "full", "requires": [], "runtimeCompat": { "supported": [ "*" ], "unsupported": [] }, "skills": [ "ai-integration-phase" ], "agents": [ "gsd-framework-selector", "gsd-ai-researcher", "gsd-domain-researcher", "gsd-eval-planner" ], "hooks": [], "config": { "workflow.ai_integration_phase": { "type": "boolean", "default": true, "description": "Prompt for an AI-SPEC design contract before planning phases that involve AI systems." } }, "steps": [ { "point": "plan:pre", "ref": { "skill": "ai-integration-phase" }, "produces": [ "AI-SPEC.md" ], "consumes": [ "CONTEXT.md" ], "when": "workflow.ai_integration_phase", "onError": "skip" } ], "contributions": [], "gates": [] }, "antigravity": { "id": "antigravity", "role": "runtime", "title": "Antigravity", "description": "Google Antigravity IDE — nested under ~/.gemini/antigravity; probed across 1.x and 2.x layouts; Gemini hook event dialect; nested skill layout; tier-1 support.", "tier": "core", "requires": [], "runtime": { "configHome": { "kind": "dot-home-nested", "name": "antigravity", "parent": ".gemini", "env": [ "ANTIGRAVITY_CONFIG_DIR" ], "probe": [ "antigravity", "antigravity-ide", "antigravity-cli" ] }, "configFormat": "settings-json", "artifactLayout": { "global": [ { "kind": "skills", "destSubpath": "skills", "prefix": "gsd-", "nesting": "nested", "recursive": false, "converter": "convertClaudeCommandToAntigravitySkill" } ], "local": [ { "kind": "skills", "destSubpath": "skills", "prefix": "gsd-", "nesting": "nested", "recursive": false, "converter": "convertClaudeCommandToAntigravitySkill" } ] }, "commandStyle": "slash-hyphen", "hooksSurface": "settings-json", "hookEvents": "gemini", "sandboxTier": "none", "supportTier": 1, "installSurface": "settings-json", "writesSharedSettings": true, "permissionWriter": null, "extendedHookEvents": [] } }, "audit": { "id": "audit", "role": "feature", "title": "Audit", "description": "Open-artifact audit and UAT-gap audit for milestone close gates; exposes `gsd-tools audit-uat` (cross-phase UAT outstanding items) and `gsd-tools audit-open` (structured open-artifact scan across debug, tasks, threads, todos, seeds, UAT, verification, context-questions).", "tier": "full", "requires": [], "runtimeCompat": { "supported": [ "*" ], "unsupported": [] }, "skills": [], "agents": [], "config": {}, "commands": [ { "family": "audit-uat", "module": "audit-command-router.cjs", "router": "routeAuditUat" }, { "family": "audit-open", "module": "audit-command-router.cjs", "router": "routeAuditOpen" } ], "hooks": [], "steps": [], "contributions": [], "gates": [] }, "augment": { "id": "augment", "role": "runtime", "title": "Augment Code", "description": "Augment Code CLI — commands + nested-skill artifact layout; settings-json hook surface; Claude hook event dialect; tier-2 support.", "tier": "core", "requires": [], "runtime": { "configHome": { "kind": "dot-home", "name": ".augment", "env": [ "AUGMENT_CONFIG_DIR" ] }, "configFormat": "settings-json", "artifactLayout": { "global": [ { "kind": "commands", "destSubpath": "commands", "prefix": "gsd-", "nesting": "flat", "recursive": false, "converter": null }, { "kind": "skills", "destSubpath": "skills", "prefix": "gsd-", "nesting": "nested", "recursive": false, "converter": "convertClaudeCommandToAugmentSkill" } ], "local": [ { "kind": "commands", "destSubpath": "commands", "prefix": "gsd-", "nesting": "flat", "recursive": false, "converter": null }, { "kind": "skills", "destSubpath": "skills", "prefix": "gsd-", "nesting": "nested", "recursive": false, "converter": "convertClaudeCommandToAugmentSkill" } ] }, "commandStyle": "slash-hyphen", "hooksSurface": "settings-json", "hookEvents": "claude", "sandboxTier": "none", "supportTier": 2, "installSurface": "settings-json", "writesSharedSettings": true, "permissionWriter": null, "extendedHookEvents": [] } }, "claude": { "id": "claude", "role": "runtime", "title": "Claude Code", "description": "Anthropic Claude Code — primary development runtime; tier-1 support with full hook surface and skills-based global install.", "tier": "core", "requires": [], "runtime": { "configHome": { "kind": "dot-home", "name": ".claude", "env": [ "CLAUDE_CONFIG_DIR" ] }, "configFormat": "settings-json", "artifactLayout": { "global": [ { "kind": "skills", "destSubpath": "skills", "prefix": "gsd-", "nesting": "flat", "recursive": false, "converter": "convertClaudeCommandToClaudeSkill" } ], "local": [ { "kind": "commands", "destSubpath": "commands/gsd", "prefix": "gsd-", "nesting": "flat", "recursive": false, "converter": null }, { "kind": "agents", "destSubpath": "agents", "prefix": "gsd-", "nesting": "flat", "recursive": false, "converter": null } ] }, "commandStyle": "slash-hyphen", "hooksSurface": "settings-json", "hookEvents": "claude", "sandboxTier": "none", "supportTier": 1, "installSurface": "settings-json", "writesSharedSettings": true, "permissionWriter": null, "extendedHookEvents": [ "SubagentStop", "Stop", "PreCompact", "FileChanged" ] } }, "cline": { "id": "cline", "role": "runtime", "title": "Cline", "description": "Cline (VS Code extension) — global-only nested-skill layout; cline-rules hook surface (.clinerules); no hook events emitted; tier-2 support.", "tier": "core", "requires": [], "runtime": { "configHome": { "kind": "dot-home", "name": ".cline", "env": [ "CLINE_CONFIG_DIR" ] }, "configFormat": "markdown-dir", "artifactLayout": { "global": [ { "kind": "skills", "destSubpath": "skills", "prefix": "gsd-", "nesting": "nested", "recursive": false, "converter": "convertClaudeCommandToClineSkill" } ], "local": [] }, "commandStyle": "slash-hyphen", "hooksSurface": "cline-rules", "sandboxTier": "none", "supportTier": 2, "installSurface": "cline-rules", "writesSharedSettings": false, "permissionWriter": null, "extendedHookEvents": [] } }, "code-review": { "id": "code-review", "role": "feature", "title": "Code review", "description": "Source-file code review and review-fix workflow support for completed execution work.", "tier": "full", "requires": [], "runtimeCompat": { "supported": [ "*" ], "unsupported": [] }, "skills": [ "code-review" ], "agents": [ "gsd-code-reviewer", "gsd-code-fixer" ], "hooks": [], "config": { "workflow.code_review": { "type": "boolean", "default": true, "description": "Enable code-review participation in post-execution review flows." }, "workflow.code_review_depth": { "type": "enum", "values": [ "quick", "standard", "deep" ], "default": "standard", "description": "Default depth for code review when no --depth override is supplied." } }, "steps": [ { "point": "execute:post", "ref": { "skill": "code-review" }, "produces": [ "REVIEW.md" ], "consumes": [ "SUMMARY.md" ], "when": "workflow.code_review", "onError": "skip" } ], "contributions": [], "gates": [] }, "codebuddy": { "id": "codebuddy", "role": "runtime", "title": "CodeBuddy", "description": "CodeBuddy (Tencent) — converted commands + skills artifact layout; settings-json hook surface; Claude hook event dialect; tier-2 support.", "tier": "core", "requires": [], "runtime": { "configHome": { "kind": "dot-home", "name": ".codebuddy", "env": [ "CODEBUDDY_CONFIG_DIR" ] }, "configFormat": "settings-json", "artifactLayout": { "global": [ { "kind": "commands", "destSubpath": "commands", "prefix": "gsd-", "nesting": "flat", "recursive": false, "converter": "convertClaudeCommandToCodebuddyCommand" }, { "kind": "skills", "destSubpath": "skills", "prefix": "gsd-", "nesting": "flat", "recursive": false, "converter": "convertClaudeCommandToCodebuddySkill" } ], "local": [ { "kind": "commands", "destSubpath": "commands", "prefix": "gsd-", "nesting": "flat", "recursive": false, "converter": "convertClaudeCommandToCodebuddyCommand" }, { "kind": "skills", "destSubpath": "skills", "prefix": "gsd-", "nesting": "flat", "recursive": false, "converter": "convertClaudeCommandToCodebuddySkill" } ] }, "commandStyle": "slash-hyphen", "hooksSurface": "settings-json", "hookEvents": "claude", "sandboxTier": "none", "supportTier": 2, "installSurface": "settings-json", "writesSharedSettings": true, "permissionWriter": null, "extendedHookEvents": [] } }, "codex": { "id": "codex", "role": "runtime", "title": "OpenAI Codex CLI", "description": "OpenAI Codex CLI — shell-var command style; per-agent sandbox tiers; config.toml + hooks.json hook surface; tier-1 support.", "tier": "core", "requires": [], "runtime": { "configHome": { "kind": "dot-home", "name": ".codex", "env": [ "CODEX_HOME" ] }, "configFormat": "toml", "artifactLayout": { "global": [ { "kind": "skills", "destSubpath": "skills", "prefix": "gsd-", "nesting": "flat", "recursive": false, "converter": "convertClaudeCommandToCodexSkill" } ], "local": [ { "kind": "skills", "destSubpath": "skills", "prefix": "gsd-", "nesting": "flat", "recursive": false, "converter": "convertClaudeCommandToCodexSkill" } ] }, "commandStyle": "shell-var", "hooksSurface": "codex-hooks-json", "hookEvents": "claude", "sandboxTier": "codex-agent-sandbox", "supportTier": 1, "installSurface": "codex-toml", "writesSharedSettings": false, "permissionWriter": null, "extendedHookEvents": [] } }, "copilot": { "id": "copilot", "role": "runtime", "title": "GitHub Copilot", "description": "GitHub Copilot (VS Code) — markdown config format; copilot-inline hook surface; no hook events emitted; flat skill nesting (unconfirmed recursive loader); tier-2 support.", "tier": "core", "requires": [], "runtime": { "configHome": { "kind": "dot-home", "name": ".copilot", "env": [ "COPILOT_CONFIG_DIR", "COPILOT_HOME" ] }, "configFormat": "markdown", "artifactLayout": { "global": [ { "kind": "skills", "destSubpath": "skills", "prefix": "gsd-", "nesting": "flat", "recursive": false, "converter": "convertClaudeCommandToCopilotSkill" } ], "local": [ { "kind": "skills", "destSubpath": "skills", "prefix": "gsd-", "nesting": "flat", "recursive": false, "converter": "convertClaudeCommandToCopilotSkill" } ] }, "commandStyle": "slash-hyphen", "hooksSurface": "copilot-inline", "sandboxTier": "none", "supportTier": 2, "installSurface": "copilot-instructions", "writesSharedSettings": false, "permissionWriter": null, "extendedHookEvents": [] } }, "cursor": { "id": "cursor", "role": "runtime", "title": "Cursor", "description": "Cursor IDE — skills + converted commands artifact layout; hooks.json surface; Claude hook event dialect; recursive skill loader (flat nesting); tier-2 support.", "tier": "core", "requires": [], "runtime": { "configHome": { "kind": "dot-home", "name": ".cursor", "env": [ "CURSOR_CONFIG_DIR" ] }, "configFormat": "none", "artifactLayout": { "global": [ { "kind": "skills", "destSubpath": "skills", "prefix": "gsd-", "nesting": "flat", "recursive": true, "converter": "convertClaudeCommandToCursorSkill" }, { "kind": "commands", "destSubpath": "commands", "prefix": "gsd-", "nesting": "flat", "recursive": false, "converter": "convertClaudeCommandToCursorCommand" } ], "local": [ { "kind": "skills", "destSubpath": "skills", "prefix": "gsd-", "nesting": "flat", "recursive": true, "converter": "convertClaudeCommandToCursorSkill" }, { "kind": "commands", "destSubpath": "commands", "prefix": "gsd-", "nesting": "flat", "recursive": false, "converter": "convertClaudeCommandToCursorCommand" } ] }, "commandStyle": "slash-hyphen", "hooksSurface": "cursor-hooks-json", "hookEvents": "claude", "sandboxTier": "none", "supportTier": 2, "installSurface": "cursor-hooks-json", "writesSharedSettings": false, "permissionWriter": null, "extendedHookEvents": [] } }, "drift": { "id": "drift", "role": "feature", "title": "Drift detection gates", "description": "Post-execution drift detection gates that run after each wave completes. Provides two gates at execute:wave:post: a blocking schema drift gate (detects schema files changed without a database push) and a non-blocking codebase drift gate (detects structural additions not reflected in STRUCTURE.md).", "tier": "full", "requires": [], "runtimeCompat": { "supported": [ "*" ], "unsupported": [] }, "skills": [], "agents": [], "hooks": [], "config": { "workflow.drift_threshold": { "type": "number", "default": 3, "description": "Minimum number of new structural elements (directories, barrel exports, migrations, routes) before the codebase drift gate triggers a warn or auto-remap action." }, "workflow.drift_action": { "type": "enum", "values": [ "warn", "auto-remap" ], "default": "warn", "description": "Action taken by the codebase drift gate when the threshold is exceeded: warn (advisory message) or auto-remap (spawn gsd-codebase-mapper agent to refresh STRUCTURE.md)." }, "workflow.schema_drift_gate": { "type": "boolean", "default": true, "description": "Enable the drift gates at execute:wave:post. When enabled, the schema drift gate blocks verification if schema-relevant files changed during execution but no database push command was executed; the codebase drift gate (non-blocking) warns when structural additions exceed the drift_threshold." } }, "steps": [], "contributions": [], "gates": [ { "point": "execute:wave:post", "check": { "query": "verify.schema-drift" }, "when": "workflow.schema_drift_gate", "blocking": true, "onError": "skip" }, { "point": "execute:wave:post", "check": { "query": "verify.codebase-drift" }, "when": "workflow.schema_drift_gate", "blocking": false, "onError": "skip" } ] }, "gap-analysis": { "id": "gap-analysis", "role": "feature", "title": "Post-planning gap analysis", "description": "Proactive, non-blocking post-planning coverage report. After all PLAN.md files are generated, cross-references every REQ-ID and D-ID from REQUIREMENTS.md and CONTEXT.md against plan bodies. Emits a Source | Item | Status table. Does not block phase advancement.", "tier": "standard", "requires": [], "runtimeCompat": { "supported": [ "*" ], "unsupported": [] }, "skills": [], "agents": [], "hooks": [], "config": { "workflow.post_planning_gaps": { "type": "boolean", "default": true, "description": "Run the post-planning gap analysis report after plans are generated." } }, "steps": [], "contributions": [], "gates": [ { "point": "plan:post", "check": { "query": "gap-analysis.plan-post" }, "when": "workflow.post_planning_gaps", "blocking": false, "onError": "skip" } ] }, "gemini": { "id": "gemini", "role": "runtime", "title": "Gemini CLI", "description": "Google Gemini CLI — commands-only artifact layout (TOML); Gemini hook event dialect; settings-json hook surface; tier-2 support.", "tier": "core", "requires": [], "runtime": { "configHome": { "kind": "dot-home", "name": ".gemini", "env": [ "GEMINI_CONFIG_DIR" ] }, "configFormat": "settings-json", "artifactLayout": { "global": [ { "kind": "commands", "destSubpath": "commands/gsd", "prefix": "gsd-", "nesting": "flat", "recursive": false, "converter": null } ], "local": [ { "kind": "commands", "destSubpath": "commands/gsd", "prefix": "gsd-", "nesting": "flat", "recursive": false, "converter": null } ] }, "commandStyle": "slash-hyphen", "hooksSurface": "settings-json", "hookEvents": "gemini", "sandboxTier": "none", "supportTier": 2, "installSurface": "settings-json", "writesSharedSettings": true, "permissionWriter": null, "extendedHookEvents": [ "BeforeAgent", "AfterAgent", "BeforeModel" ] } }, "graphify": { "id": "graphify", "role": "feature", "title": "Knowledge graph", "description": "Build, query, and inspect the project knowledge graph in `.planning/graphs/`; exposes graphify CLI subcommands (build, query, status, diff) and the /gsd-graphify skill.", "tier": "full", "requires": [], "runtimeCompat": { "supported": [ "*" ], "unsupported": [] }, "skills": [ "graphify" ], "agents": [], "activationKey": "graphify.enabled", "config": { "graphify.enabled": { "type": "boolean", "default": false, "description": "Enable the graphify knowledge-graph command + skill." } }, "commands": [ { "family": "graphify", "module": "graphify-command-router.cjs", "router": "routeGraphifyCommand" } ], "hooks": [], "steps": [], "contributions": [], "gates": [] }, "hermes": { "id": "hermes", "role": "runtime", "title": "Hermes Agent", "description": "Hermes Agent (NousResearch) — skills nest under skills/gsd/ category bucket; nested skill layout; settings-json hook surface; Claude hook event dialect; tier-2 support.", "tier": "core", "requires": [], "runtime": { "configHome": { "kind": "dot-home", "name": ".hermes", "env": [ "HERMES_HOME" ] }, "configFormat": "settings-json", "artifactLayout": { "global": [ { "kind": "skills", "destSubpath": "skills/gsd", "prefix": "gsd-", "nesting": "nested", "recursive": false, "converter": "convertClaudeCommandToClaudeSkill" } ], "local": [ { "kind": "skills", "destSubpath": "skills/gsd", "prefix": "gsd-", "nesting": "nested", "recursive": false, "converter": "convertClaudeCommandToClaudeSkill" } ] }, "commandStyle": "slash-hyphen", "hooksSurface": "settings-json", "hookEvents": "claude", "sandboxTier": "none", "supportTier": 2, "installSurface": "settings-json", "writesSharedSettings": true, "permissionWriter": null, "extendedHookEvents": [] } }, "intel": { "id": "intel", "role": "feature", "title": "Codebase intelligence", "description": "Code-intelligence store for codebase querying, diff, snapshot, and API-surface extraction; exposes `gsd-tools intel` subcommands (query, status, update, diff, snapshot, patch-meta, validate, extract-exports, api-surface) and backs `/gsd-map-codebase` and `gsd-intel-updater`.", "tier": "full", "requires": [], "runtimeCompat": { "supported": [ "*" ], "unsupported": [] }, "skills": [], "agents": [], "activationKey": "intel.enabled", "config": { "intel.enabled": { "type": "boolean", "default": false, "description": "Enable the intel code-intelligence command." } }, "commands": [ { "family": "intel", "module": "intel-command-router.cjs", "router": "routeIntelCommand" } ], "hooks": [], "steps": [ { "point": "plan:pre", "ref": { "command": "intel api-surface" }, "produces": [ ".planning/intel/API-SURFACE.md" ], "consumes": [], "when": "intel.enabled", "onError": "skip" } ], "contributions": [], "gates": [] }, "kilo": { "id": "kilo", "role": "runtime", "title": "Kilo Code", "description": "Kilo Code — XDG-based config dir; global skills at ~/.kilo/skills (separate from XDG config); flat command/ + skills artifact layout; no lifecycle hook registration; tier-2 support.", "tier": "core", "requires": [], "runtime": { "configHome": { "kind": "xdg", "name": "kilo", "env": [ "KILO_CONFIG_DIR", "KILO_CONFIG", "XDG_CONFIG_HOME" ], "skillsHome": { "kind": "dot-home", "name": ".kilo", "env": [] } }, "configFormat": "settings-json", "artifactLayout": { "global": [ { "kind": "commands", "destSubpath": "command", "prefix": "gsd-", "nesting": "flat", "recursive": false, "converter": null }, { "kind": "skills", "destSubpath": "skills", "prefix": "gsd-", "nesting": "flat", "recursive": true, "converter": "convertClaudeCommandToKiloSkill" } ], "local": [ { "kind": "commands", "destSubpath": "command", "prefix": "gsd-", "nesting": "flat", "recursive": false, "converter": null }, { "kind": "skills", "destSubpath": "skills", "prefix": "gsd-", "nesting": "flat", "recursive": true, "converter": "convertClaudeCommandToKiloSkill" } ] }, "commandStyle": "slash-hyphen", "hooksSurface": "none", "sandboxTier": "none", "supportTier": 2, "installSurface": "settings-json", "writesSharedSettings": false, "permissionWriter": "kilo", "extendedHookEvents": [] } }, "kimi": { "id": "kimi", "role": "runtime", "title": "Kimi CLI", "description": "Kimi CLI (Moonshot AI) — generic agents root at ~/.config/agents; skills + kimi-agents artifact layout; no hook surface; no hook events; tier-2 support.", "tier": "core", "requires": [], "runtime": { "configHome": { "kind": "generic-agents-root", "name": "agents", "env": [ "KIMI_CONFIG_DIR" ], "probe": [ "~/.config/agents", "~/.agents" ], "probeExists": "skills" }, "configFormat": "none", "artifactLayout": { "global": [ { "kind": "skills", "destSubpath": "skills", "prefix": "gsd-", "nesting": "flat", "recursive": false, "converter": "convertClaudeCommandToKimiSkill" }, { "kind": "kimi-agents", "destSubpath": "agents", "prefix": "gsd", "nesting": "flat", "recursive": false, "converter": null } ], "local": [] }, "commandStyle": "slash-hyphen", "hooksSurface": "none", "sandboxTier": "none", "supportTier": 2, "installSurface": "profile-marker-only", "writesSharedSettings": false, "permissionWriter": null, "extendedHookEvents": [] } }, "mempalace": { "id": "mempalace", "role": "feature", "title": "MemPalace memory", "description": "Cross-session, cross-project memory: deliberate recall before discuss/plan and verbatim capture + temporal-KG sync at phase boundaries, via the MemPalace MCP server and CLI.", "tier": "full", "requires": [], "runtimeCompat": { "supported": [ "*" ], "unsupported": [] }, "skills": [ "mempalace-recall", "mempalace-capture" ], "agents": [ "gsd-mempalace-curator" ], "hooks": [], "config": { "mempalace.enabled": { "type": "boolean", "default": false, "description": "Master toggle for the MemPalace memory capability." }, "mempalace.memory_mode": { "type": "enum", "values": [ "augment", "kg_backend", "replace" ], "default": "augment", "description": "How MemPalace relates to GSD native memory. Only 'augment' (additive) is implemented today; 'kg_backend' and 'replace' are forward-declared (routing seam not yet built) and currently behave as 'augment'." }, "mempalace.wing": { "type": "string", "default": "", "description": "Palace wing name; empty derives from project_code / project dir." }, "mempalace.recall_on_discuss": { "type": "boolean", "default": true, "description": "Inject wake-up + search recall at discuss:pre." }, "mempalace.recall_on_plan": { "type": "boolean", "default": true, "description": "Produce MEMORY-RECALL.md at plan:pre." }, "mempalace.capture_artifacts": { "type": "boolean", "default": true, "description": "File CONTEXT/PLAN/SUMMARY and learnings into the palace at phase boundaries." }, "mempalace.mirror_kg": { "type": "boolean", "default": true, "description": "Mirror decisions/learnings into MemPalace's temporal knowledge graph." }, "mempalace.cross_project_tunnels": { "type": "boolean", "default": false, "description": "Propose/create cross-wing tunnels at ship:post." }, "mempalace.diary_journal": { "type": "boolean", "default": true, "description": "Write a per-agent diary entry at ship:post." }, "mempalace.auto_capture_hooks": { "type": "boolean", "default": false, "description": "Reserved / not yet implemented: will install MemPalace's native stop/precompact Claude Code hooks for passive mid-session capture (the capability's hooks array is currently empty)." } }, "steps": [ { "point": "discuss:post", "ref": { "skill": "mempalace-capture" }, "produces": [], "consumes": [ "CONTEXT.md" ], "when": "mempalace.enabled", "onError": "skip" }, { "point": "plan:pre", "ref": { "skill": "mempalace-recall" }, "produces": [ "MEMORY-RECALL.md" ], "consumes": [ "CONTEXT.md" ], "when": "mempalace.enabled", "onError": "skip" }, { "point": "plan:post", "ref": { "skill": "mempalace-capture" }, "produces": [], "consumes": [ "PLAN.md" ], "when": "mempalace.enabled", "onError": "skip" }, { "point": "verify:post", "ref": { "skill": "mempalace-capture" }, "produces": [], "consumes": [ "SUMMARY.md" ], "when": "mempalace.enabled", "onError": "skip" }, { "point": "ship:post", "ref": { "agent": "gsd-mempalace-curator" }, "produces": [], "consumes": [ "UAT.md" ], "when": "mempalace.enabled", "onError": "skip" } ], "contributions": [ { "point": "discuss:pre", "into": "orchestrator", "fragment": { "path": "fragments/recall-discuss.md", "inline": "\n### Memory recall (MemPalace)\n\n**Gate first.** Read `.planning/config.json`. If `mempalace.enabled` is not `true`, or `mempalace.recall_on_discuss` is `false`, **skip this entire section** and continue the discussion unchanged. (This contribution is only injected when the capability is enabled; the `recall_on_discuss` check lets you turn discuss-time recall off without disabling the rest of the capability.)\n\nOtherwise — before gathering new context, surface what you already know. This is read-only and side-effect-free; if MemPalace is unreachable, note \"memory unavailable\" and continue — recall never blocks discussion.\n\n1. **Resolve the wing.** Use `mempalace.wing` if set; otherwise derive it from `project_code` (fall back to the project directory name).\n2. **Wake up (cheap, ~600–900 tokens).**\n - Interactive run → call `mempalace_search` after a wake-up read of the wing.\n - Headless/cron run (no MCP server) → run `mempalace wake-up --wing ` via the CLI.\n3. **Targeted recall.** Search the palace for prior work on this phase's topic:\n - Interactive → `mempalace_search(query=, wing=)` and, when `mempalace.mirror_kg` is on, `mempalace_kg_query` / `mempalace_kg_timeline` for decision facts and their validity windows.\n - Headless → `mempalace search \"\" --wing `.\n4. **Mode awareness.** Only `augment` is currently wired: always treat the palace as an *additional* recall layer on top of GSD's native memory — never skip `.planning/graphs/` or STATE. `kg_backend`/`replace` are forward-declared and behave as `augment` today.\n5. **Surface, don't dump.** Fold the top relevant drawers, decisions, patterns, and *surprises* into the discussion as prior context — cite drawer/fact provenance. Do not paste raw search output.\n\nIf any MemPalace call errors or times out, skip the rest of recall and proceed with discussion as normal.\n" }, "produces": [], "consumes": [], "when": "mempalace.enabled", "onError": "skip" }, { "point": "execute:wave:post", "into": "verifier", "fragment": { "path": "fragments/capture-problems.md", "inline": "\n### Capture problems → fixes (MemPalace)\n\n**Gate first.** Read `.planning/config.json`. If `mempalace.enabled` is not `true`, or `mempalace.capture_artifacts` is `false`, **skip this entire section** and let the wave complete unchanged. (This contribution is only injected when the capability is enabled; the `capture_artifacts` check lets you turn capture off without disabling the rest of the capability.)\n\nOtherwise — after verifying this wave, persist any *confirmed* problem→fix pairs into the palace so they are recalled in future phases. This is best-effort; if MemPalace is unreachable, skip silently — capture never fails a wave.\n\nFor each confirmed bug/issue resolved in this wave:\n\n1. **Resolve the wing** (`mempalace.wing`, else `project_code`, else project dir) and target `room: problems`.\n2. **Dedupe first.** Call `mempalace_check_duplicate` (interactive) before filing so re-runs don't create duplicate drawers.\n3. **File the drawer verbatim.** Store the problem statement and its fix as a drawer in `room: problems` — interactive: `mempalace_add_drawer`; headless: `mempalace mine` / `mempalace hook run`. Include provenance (`source_file`, phase id).\n4. **Mirror the KG fact** when `mempalace.mirror_kg` is on: add `(, fixed_by, )` with `valid_from` = the phase date via `mempalace_kg_add`.\n5. **Mode awareness.** Only `augment` is currently wired: the fact is an *additive* mirror alongside `.planning/graphs/` (never a replacement). `kg_backend`/`replace` are forward-declared and behave as `augment` today.\n\nCaptures are idempotent: deterministic drawer IDs + `check_duplicate` mean re-running the wave re-files the same content without duplication. On any error, skip and let the wave complete normally.\n" }, "produces": [], "consumes": [], "when": "mempalace.enabled", "onError": "skip" } ], "gates": [] }, "nyquist": { "id": "nyquist", "role": "feature", "title": "Nyquist validation", "description": "Validation coverage audit that maps executed work back to tests and manual-only evidence.", "tier": "full", "requires": [], "runtimeCompat": { "supported": [ "*" ], "unsupported": [] }, "skills": [ "validate-phase" ], "agents": [ "gsd-nyquist-auditor" ], "hooks": [], "config": { "workflow.nyquist_validation": { "type": "boolean", "default": true, "description": "Enable Nyquist validation coverage auditing." } }, "steps": [ { "point": "verify:post", "ref": { "skill": "validate-phase" }, "produces": [ "VALIDATION.md" ], "consumes": [ "SUMMARY.md" ], "when": "workflow.nyquist_validation", "onError": "halt" } ], "contributions": [], "gates": [] }, "opencode": { "id": "opencode", "role": "runtime", "title": "OpenCode", "description": "OpenCode — XDG-based config dir; flat command/ + skills artifact layout; settings-json config format; no lifecycle hook registration; tier-2 support.", "tier": "core", "requires": [], "runtime": { "configHome": { "kind": "xdg", "name": "opencode", "env": [ "OPENCODE_CONFIG_DIR", "OPENCODE_CONFIG", "XDG_CONFIG_HOME" ] }, "configFormat": "settings-json", "artifactLayout": { "global": [ { "kind": "commands", "destSubpath": "command", "prefix": "gsd-", "nesting": "flat", "recursive": false, "converter": null }, { "kind": "skills", "destSubpath": "skills", "prefix": "gsd-", "nesting": "flat", "recursive": true, "converter": "convertClaudeCommandToOpencodeSkill" } ], "local": [ { "kind": "commands", "destSubpath": "command", "prefix": "gsd-", "nesting": "flat", "recursive": false, "converter": null }, { "kind": "skills", "destSubpath": "skills", "prefix": "gsd-", "nesting": "flat", "recursive": true, "converter": "convertClaudeCommandToOpencodeSkill" } ] }, "commandStyle": "slash-hyphen", "hooksSurface": "none", "sandboxTier": "none", "supportTier": 2, "installSurface": "settings-json", "writesSharedSettings": true, "permissionWriter": "opencode", "extendedHookEvents": [] } }, "pattern-mapper": { "id": "pattern-mapper", "role": "feature", "title": "Pattern mapping", "description": "Optional codebase-pattern mapping before planning; owns the pattern mapper agent and workflow.pattern_mapper activation key.", "tier": "full", "requires": [ "research" ], "runtimeCompat": { "supported": [ "*" ], "unsupported": [] }, "skills": [], "agents": [ "gsd-pattern-mapper" ], "hooks": [], "config": { "workflow.pattern_mapper": { "type": "boolean", "default": true, "description": "Run the pattern mapper before planning when context or research is available." } }, "steps": [ { "point": "plan:pre", "ref": { "agent": "gsd-pattern-mapper" }, "fragment": { "path": "fragments/plan-pre.md", "inline": "\n**Phase:** {phase_number} - {phase_name}\n**Phase directory:** {phase_dir}\n**Padded phase:** {padded_phase}\n\n\n- {context_path} (USER DECISIONS from /gsd:discuss-phase)\n- {research_path} (Technical Research)\n\n\n**Output file:** {phase_dir}/{padded_phase}-PATTERNS.md\n\nExtract the list of files to be created/modified from CONTEXT.md and RESEARCH.md. For each file, classify by role and data flow, find the closest existing analog in the codebase, extract concrete code excerpts, and produce PATTERNS.md.\n\n" }, "produces": [ "PATTERNS.md" ], "consumes": [ "RESEARCH.md" ], "when": "workflow.pattern_mapper", "onError": "skip" } ], "contributions": [], "gates": [] }, "profile-pipeline": { "id": "profile-pipeline", "role": "feature", "title": "Developer profiling pipeline", "description": "Developer behavioral profiling from Claude Code session history; scans session JSONL files, extracts and samples user messages, and generates profile artifacts (USER-PROFILE.md, dev-preferences.md, CLAUDE.md sections). Exposes eight `gsd-tools` commands: scan-sessions, extract-messages, profile-sample (pipeline phase) and write-profile, profile-questionnaire, generate-dev-preferences, generate-claude-profile, generate-claude-md (output phase). Backs the /gsd-profile-user skill and gsd-user-profiler agent.", "tier": "full", "requires": [], "runtimeCompat": { "supported": [ "*" ], "unsupported": [] }, "skills": [ "profile-user" ], "agents": [ "gsd-user-profiler" ], "config": { "profile-pipeline.enabled": { "type": "boolean", "default": false, "description": "Enable the developer profiling pipeline commands (scan-sessions, extract-messages, profile-sample, write-profile, etc.)." } }, "commands": [ { "family": "scan-sessions", "module": "profile-pipeline-command-router.cjs", "router": "routeScanSessions" }, { "family": "extract-messages", "module": "profile-pipeline-command-router.cjs", "router": "routeExtractMessages" }, { "family": "profile-sample", "module": "profile-pipeline-command-router.cjs", "router": "routeProfileSample" }, { "family": "write-profile", "module": "profile-pipeline-command-router.cjs", "router": "routeWriteProfile" }, { "family": "profile-questionnaire", "module": "profile-pipeline-command-router.cjs", "router": "routeProfileQuestionnaire" }, { "family": "generate-dev-preferences", "module": "profile-pipeline-command-router.cjs", "router": "routeGenerateDevPreferences" }, { "family": "generate-claude-profile", "module": "profile-pipeline-command-router.cjs", "router": "routeGenerateClaudeProfile" }, { "family": "generate-claude-md", "module": "profile-pipeline-command-router.cjs", "router": "routeGenerateClaudeMd" } ], "hooks": [], "steps": [], "contributions": [], "gates": [] }, "qwen": { "id": "qwen", "role": "runtime", "title": "Qwen Code", "description": "Qwen Code (Alibaba) — nested-skill artifact layout; settings-json hook surface; Claude hook event dialect; tier-2 support.", "tier": "core", "requires": [], "runtime": { "configHome": { "kind": "dot-home", "name": ".qwen", "env": [ "QWEN_CONFIG_DIR" ] }, "configFormat": "settings-json", "artifactLayout": { "global": [ { "kind": "skills", "destSubpath": "skills", "prefix": "gsd-", "nesting": "nested", "recursive": false, "converter": "convertClaudeCommandToClaudeSkill" } ], "local": [ { "kind": "skills", "destSubpath": "skills", "prefix": "gsd-", "nesting": "nested", "recursive": false, "converter": "convertClaudeCommandToClaudeSkill" } ] }, "commandStyle": "slash-hyphen", "hooksSurface": "settings-json", "hookEvents": "claude", "sandboxTier": "none", "supportTier": 2, "installSurface": "settings-json", "writesSharedSettings": true, "permissionWriter": null, "extendedHookEvents": [ "SubagentStop", "Stop", "PreCompact" ] } }, "research": { "id": "research", "role": "feature", "title": "Phase research", "description": "Optional phase research before planning; owns the phase researcher agent and workflow.research activation key.", "tier": "standard", "requires": [], "runtimeCompat": { "supported": [ "*" ], "unsupported": [] }, "skills": [], "agents": [ "gsd-phase-researcher" ], "hooks": [], "config": { "workflow.research": { "type": "boolean", "default": true, "description": "Run phase research before planning when research artifacts are missing or explicitly refreshed." } }, "steps": [ { "point": "plan:pre", "ref": { "agent": "gsd-phase-researcher" }, "fragment": { "path": "fragments/plan-pre.md", "inline": "\nResearch how to implement Phase {phase_number}: {phase_name}\nAnswer: \"What do I need to know to PLAN this phase well?\"\n\n\n\n- {context_path} (USER DECISIONS from /gsd:discuss-phase)\n- {requirements_path} (Project requirements)\n- {state_path} (Project decisions and history)\n\n\n${AGENT_SKILLS_RESEARCHER}\n\n\n**Phase description:** {phase_description}\n**Phase requirement IDs (MUST address):** {phase_req_ids}\n\n**Project instructions:** Read ./CLAUDE.md or ./.claude/CLAUDE.md if either exists; follow project-specific guidelines.\n**Project skills:** Check .claude/skills/ or .agents/skills/ directory if either exists. Read SKILL.md files and account for project skill patterns.\n\n\n\nWrite to: {phase_dir}/{phase_num}-RESEARCH.md\n\n" }, "produces": [ "RESEARCH.md" ], "consumes": [ "CONTEXT.md" ], "when": "workflow.research", "onError": "skip" } ], "contributions": [], "gates": [] }, "schema-gate": { "id": "schema-gate", "role": "feature", "title": "Schema push detection gate", "description": "Detects ORM schema-relevant files in the phase scope during planning and injects a mandatory [BLOCKING] schema push task into the plan. Prevents false-positive verification where build/types pass because TypeScript types come from config, not the live database.", "tier": "full", "requires": [], "runtimeCompat": { "supported": [ "*" ], "unsupported": [] }, "skills": [], "agents": [], "hooks": [], "config": { "workflow.schema_push_detection": { "type": "boolean", "default": true, "description": "Enable ORM schema push detection during planning. When schema-relevant files are detected in the phase scope, a [BLOCKING] push task is injected into the plan." } }, "steps": [], "contributions": [ { "point": "plan:pre", "into": "planner", "fragment": { "path": "fragments/plan-pre.md", "inline": "# Schema Push Detection Gate\n\n> Detects schema-relevant files in the phase scope and injects a mandatory `[BLOCKING]` schema push task into the plan. Prevents false-positive verification where build/types pass because TypeScript types come from config, not the live database.\n\nCheck if any files in the phase scope match schema patterns:\n\n```bash\nPHASE_SECTION=$(gsd_run query roadmap.get-phase \"${PHASE}\" --pick section 2>/dev/null)\n```\n\nScan `PHASE_SECTION`, `CONTEXT.md` (if loaded), and `RESEARCH.md` (if exists) for file paths matching these ORM patterns:\n\n| ORM | File Patterns |\n|-----|--------------|\n| Payload CMS | `src/collections/**/*.ts`, `src/globals/**/*.ts` |\n| Prisma | `prisma/schema.prisma`, `prisma/schema/*.prisma` |\n| Drizzle | `drizzle/schema.ts`, `src/db/schema.ts`, `drizzle/*.ts` |\n| Supabase | `supabase/migrations/*.sql` |\n| TypeORM | `src/entities/**/*.ts`, `src/migrations/**/*.ts` |\n\nAlso check if any existing PLAN.md files for this phase already reference these file patterns in `files_modified`.\n\n**If schema-relevant files detected:**\n\nSet `SCHEMA_PUSH_REQUIRED=true` and `SCHEMA_ORM={detected_orm}`.\n\nDetermine the push command for the detected ORM:\n\n| ORM | Push Command | Non-TTY Workaround |\n|-----|-------------|-------------------|\n| Payload CMS | `npx payload migrate` | `CI=true PAYLOAD_MIGRATING=true npx payload migrate` |\n| Prisma | `npx prisma db push` | `npx prisma db push --accept-data-loss` (if destructive) |\n| Drizzle | `npx drizzle-kit push` | `npx drizzle-kit push` |\n| Supabase | `supabase db push` | Set `SUPABASE_ACCESS_TOKEN` env var |\n| TypeORM | `npx typeorm migration:run` | `npx typeorm migration:run -d src/data-source.ts` |\n\nInject the following into the planner prompt (step 8) as an additional constraint:\n\n```markdown\n\n**[BLOCKING] Schema Push Required**\n\nThis phase modifies schema-relevant files ({detected_files}). The planner MUST include\na `[BLOCKING]` task that runs the database schema push command AFTER all schema file\nmodifications are complete but BEFORE verification.\n\n- ORM detected: {SCHEMA_ORM}\n- Push command: {push_command}\n- Non-TTY workaround: {env_hint}\n- If push requires interactive prompts that cannot be suppressed, flag the task for\n manual intervention with `autonomous: false`\n\nThis task is mandatory — the phase CANNOT pass verification without it. Build and\ntype checks will pass without the push (types come from config, not the live database),\ncreating a false-positive verification state.\n\n```\n\nDisplay: `Schema files detected ({SCHEMA_ORM}) — [BLOCKING] push task will be injected into plans`\n\n**If no schema-relevant files detected:** Skip silently.\n" }, "produces": [], "consumes": [ "CONTEXT.md" ], "when": "workflow.schema_push_detection", "onError": "skip" } ], "gates": [] }, "security": { "id": "security", "role": "feature", "title": "Security enforcement", "description": "Threat mitigation verification and ship-time security blocking for phases with security enforcement enabled.", "tier": "full", "requires": [], "runtimeCompat": { "supported": [ "*" ], "unsupported": [] }, "skills": [ "secure-phase" ], "agents": [ "gsd-security-auditor" ], "hooks": [], "config": { "workflow.security_enforcement": { "type": "boolean", "default": true, "description": "Enable security threat-mitigation verification before phase advancement." }, "workflow.security_asvs_level": { "type": "number", "default": 1, "description": "OWASP ASVS level used by security review guidance." }, "workflow.security_block_on": { "type": "enum", "values": [ "critical", "high", "medium", "low", "none" ], "default": "high", "description": "Minimum open threat severity that blocks advancement." } }, "steps": [ { "point": "verify:post", "ref": { "skill": "secure-phase" }, "produces": [ "SECURITY.md" ], "consumes": [ "SUMMARY.md" ], "when": "workflow.security_enforcement", "onError": "halt" } ], "contributions": [ { "point": "plan:pre", "into": "planner", "fragment": { "inline": "Each PLAN.md must include a block when security enforcement is active. Use the configured ASVS level and blocking threshold from workflow.security_asvs_level and workflow.security_block_on." }, "configValues": { "security_asvs_level": "workflow.security_asvs_level", "security_block_on": "workflow.security_block_on" }, "produces": [], "consumes": [ "CONTEXT.md" ], "when": "workflow.security_enforcement" } ], "gates": [ { "point": "ship:pre", "check": { "predicate": { "kind": "artifact-frontmatter-equals", "artifact": "SECURITY.md", "field": "threats_open", "equals": 0 } }, "when": "workflow.security_enforcement", "blocking": true, "onError": "halt" } ] }, "tdd": { "id": "tdd", "role": "feature", "title": "Test-driven development", "description": "Injects TDD heuristics into the planner and enforces RED/GREEN gate compliance on type:tdd plans after execution. Owns workflow.tdd_mode; the --tdd CLI flag is the ephemeral override.", "tier": "full", "requires": [], "runtimeCompat": { "supported": [ "*" ], "unsupported": [] }, "skills": [], "agents": [], "hooks": [], "config": { "workflow.tdd_mode": { "type": "boolean", "default": false, "description": "Enable TDD mode: planner annotates eligible tasks type:tdd and executor enforces RED/GREEN/REFACTOR gate sequence." } }, "steps": [], "contributions": [ { "point": "plan:pre", "into": "planner", "fragment": { "inline": "\n**TDD Mode is ENABLED.** Apply TDD heuristics to all eligible tasks:\n- Business logic with defined I/O → type: tdd\n- API endpoints with request/response contracts → type: tdd\n- Data transformations, validation, algorithms → type: tdd\n- UI, config, glue code, CRUD → standard plan (type: execute)\nEach TDD plan gets one feature with RED/GREEN/REFACTOR gate sequence.\n" }, "produces": [], "consumes": [], "when": "workflow.tdd_mode", "onError": "skip" } ], "gates": [ { "point": "execute:post", "check": { "query": "tdd.review-checkpoint" }, "when": "workflow.tdd_mode", "blocking": false, "onError": "skip" } ] }, "trae": { "id": "trae", "role": "runtime", "title": "Trae IDE", "description": "Trae IDE — nested-skill artifact layout; no hook surface (profile-marker-only config); tier-2 support.", "tier": "core", "requires": [], "runtime": { "configHome": { "kind": "dot-home", "name": ".trae", "env": [ "TRAE_CONFIG_DIR" ] }, "configFormat": "none", "artifactLayout": { "global": [ { "kind": "skills", "destSubpath": "skills", "prefix": "gsd-", "nesting": "nested", "recursive": false, "converter": "convertClaudeCommandToTraeSkill" } ], "local": [ { "kind": "skills", "destSubpath": "skills", "prefix": "gsd-", "nesting": "nested", "recursive": false, "converter": "convertClaudeCommandToTraeSkill" } ] }, "commandStyle": "slash-hyphen", "hooksSurface": "none", "sandboxTier": "none", "supportTier": 2, "installSurface": "profile-marker-only", "writesSharedSettings": false, "permissionWriter": null, "extendedHookEvents": [] } }, "ui": { "id": "ui", "role": "feature", "title": "UI design contracts", "description": "UI-SPEC design contract + retrospective UI audit for frontend phases.", "tier": "full", "requires": [], "runtimeCompat": { "supported": [ "*" ], "unsupported": [] }, "skills": [ "ui-phase", "ui-review" ], "agents": [ "gsd-ui-checker", "gsd-ui-auditor" ], "hooks": [], "config": { "workflow.ui_phase": { "type": "boolean", "default": true, "description": "Enable the UI design-contract gate during planning." }, "workflow.ui_review": { "type": "boolean", "default": true, "description": "Enable the retrospective UI audit." }, "workflow.ui_safety_gate": { "type": "boolean", "default": true, "description": "Block execution on unmet UI-SPEC contracts." } }, "steps": [ { "point": "plan:pre", "ref": { "skill": "ui-phase" }, "produces": [ "UI-SPEC.md" ], "consumes": [ "CONTEXT.md" ], "when": "workflow.ui_phase", "onError": "skip" }, { "point": "verify:post", "ref": { "skill": "ui-review" }, "produces": [ "UI-REVIEW.md" ], "consumes": [ "UI-SPEC.md" ], "when": "workflow.ui_review", "onError": "skip" } ], "contributions": [], "gates": [ { "point": "plan:pre", "check": { "query": "ui.plan-gate" }, "when": "workflow.ui_safety_gate", "blocking": true, "onError": "halt" }, { "point": "execute:wave:post", "check": { "query": "ui.safety-gate" }, "when": "workflow.ui_safety_gate", "blocking": true, "onError": "halt" } ] }, "windsurf": { "id": "windsurf", "role": "runtime", "title": "Windsurf", "description": "Windsurf (Codeium) — nested under ~/.codeium/windsurf; skills-only artifact layout; no hook surface; no hook events; tier-2 support.", "tier": "core", "requires": [], "runtime": { "configHome": { "kind": "dot-home-nested", "name": "windsurf", "parent": ".codeium", "env": [ "WINDSURF_CONFIG_DIR" ] }, "configFormat": "none", "artifactLayout": { "global": [ { "kind": "skills", "destSubpath": "skills", "prefix": "gsd-", "nesting": "flat", "recursive": false, "converter": "convertClaudeCommandToWindsurfSkill" } ], "local": [ { "kind": "skills", "destSubpath": "skills", "prefix": "gsd-", "nesting": "flat", "recursive": false, "converter": "convertClaudeCommandToWindsurfSkill" } ] }, "commandStyle": "slash-hyphen", "hooksSurface": "none", "sandboxTier": "none", "supportTier": 2, "installSurface": "profile-marker-only", "writesSharedSettings": false, "permissionWriter": null, "extendedHookEvents": [] } } }; const bySkill = { "ai-integration-phase": "ai-integration", "code-review": "code-review", "graphify": "graphify", "mempalace-recall": "mempalace", "mempalace-capture": "mempalace", "validate-phase": "nyquist", "profile-user": "profile-pipeline", "secure-phase": "security", "ui-phase": "ui", "ui-review": "ui" }; const byAgent = { "gsd-framework-selector": "ai-integration", "gsd-ai-researcher": "ai-integration", "gsd-domain-researcher": "ai-integration", "gsd-eval-planner": "ai-integration", "gsd-code-reviewer": "code-review", "gsd-code-fixer": "code-review", "gsd-mempalace-curator": "mempalace", "gsd-nyquist-auditor": "nyquist", "gsd-pattern-mapper": "pattern-mapper", "gsd-user-profiler": "profile-pipeline", "gsd-phase-researcher": "research", "gsd-security-auditor": "security", "gsd-ui-checker": "ui", "gsd-ui-auditor": "ui" }; const byLoopPoint = { "discuss:pre": { "steps": [], "contributions": [ { "capId": "mempalace", "point": "discuss:pre", "into": "orchestrator", "fragment": { "path": "fragments/recall-discuss.md", "inline": "\n### Memory recall (MemPalace)\n\n**Gate first.** Read `.planning/config.json`. If `mempalace.enabled` is not `true`, or `mempalace.recall_on_discuss` is `false`, **skip this entire section** and continue the discussion unchanged. (This contribution is only injected when the capability is enabled; the `recall_on_discuss` check lets you turn discuss-time recall off without disabling the rest of the capability.)\n\nOtherwise — before gathering new context, surface what you already know. This is read-only and side-effect-free; if MemPalace is unreachable, note \"memory unavailable\" and continue — recall never blocks discussion.\n\n1. **Resolve the wing.** Use `mempalace.wing` if set; otherwise derive it from `project_code` (fall back to the project directory name).\n2. **Wake up (cheap, ~600–900 tokens).**\n - Interactive run → call `mempalace_search` after a wake-up read of the wing.\n - Headless/cron run (no MCP server) → run `mempalace wake-up --wing ` via the CLI.\n3. **Targeted recall.** Search the palace for prior work on this phase's topic:\n - Interactive → `mempalace_search(query=, wing=)` and, when `mempalace.mirror_kg` is on, `mempalace_kg_query` / `mempalace_kg_timeline` for decision facts and their validity windows.\n - Headless → `mempalace search \"\" --wing `.\n4. **Mode awareness.** Only `augment` is currently wired: always treat the palace as an *additional* recall layer on top of GSD's native memory — never skip `.planning/graphs/` or STATE. `kg_backend`/`replace` are forward-declared and behave as `augment` today.\n5. **Surface, don't dump.** Fold the top relevant drawers, decisions, patterns, and *surprises* into the discussion as prior context — cite drawer/fact provenance. Do not paste raw search output.\n\nIf any MemPalace call errors or times out, skip the rest of recall and proceed with discussion as normal.\n" }, "produces": [], "consumes": [], "when": "mempalace.enabled", "onError": "skip" } ], "gates": [] }, "discuss:post": { "steps": [ { "capId": "mempalace", "point": "discuss:post", "ref": { "skill": "mempalace-capture" }, "produces": [], "consumes": [ "CONTEXT.md" ], "when": "mempalace.enabled", "onError": "skip" } ], "contributions": [], "gates": [] }, "plan:pre": { "steps": [ { "capId": "ai-integration", "point": "plan:pre", "ref": { "skill": "ai-integration-phase" }, "produces": [ "AI-SPEC.md" ], "consumes": [ "CONTEXT.md" ], "when": "workflow.ai_integration_phase", "onError": "skip" }, { "capId": "intel", "point": "plan:pre", "ref": { "command": "intel api-surface" }, "produces": [ ".planning/intel/API-SURFACE.md" ], "consumes": [], "when": "intel.enabled", "onError": "skip" }, { "capId": "mempalace", "point": "plan:pre", "ref": { "skill": "mempalace-recall" }, "produces": [ "MEMORY-RECALL.md" ], "consumes": [ "CONTEXT.md" ], "when": "mempalace.enabled", "onError": "skip" }, { "capId": "research", "point": "plan:pre", "ref": { "agent": "gsd-phase-researcher" }, "fragment": { "path": "fragments/plan-pre.md", "inline": "\nResearch how to implement Phase {phase_number}: {phase_name}\nAnswer: \"What do I need to know to PLAN this phase well?\"\n\n\n\n- {context_path} (USER DECISIONS from /gsd:discuss-phase)\n- {requirements_path} (Project requirements)\n- {state_path} (Project decisions and history)\n\n\n${AGENT_SKILLS_RESEARCHER}\n\n\n**Phase description:** {phase_description}\n**Phase requirement IDs (MUST address):** {phase_req_ids}\n\n**Project instructions:** Read ./CLAUDE.md or ./.claude/CLAUDE.md if either exists; follow project-specific guidelines.\n**Project skills:** Check .claude/skills/ or .agents/skills/ directory if either exists. Read SKILL.md files and account for project skill patterns.\n\n\n\nWrite to: {phase_dir}/{phase_num}-RESEARCH.md\n\n" }, "produces": [ "RESEARCH.md" ], "consumes": [ "CONTEXT.md" ], "when": "workflow.research", "onError": "skip" }, { "capId": "ui", "point": "plan:pre", "ref": { "skill": "ui-phase" }, "produces": [ "UI-SPEC.md" ], "consumes": [ "CONTEXT.md" ], "when": "workflow.ui_phase", "onError": "skip" }, { "capId": "pattern-mapper", "point": "plan:pre", "ref": { "agent": "gsd-pattern-mapper" }, "fragment": { "path": "fragments/plan-pre.md", "inline": "\n**Phase:** {phase_number} - {phase_name}\n**Phase directory:** {phase_dir}\n**Padded phase:** {padded_phase}\n\n\n- {context_path} (USER DECISIONS from /gsd:discuss-phase)\n- {research_path} (Technical Research)\n\n\n**Output file:** {phase_dir}/{padded_phase}-PATTERNS.md\n\nExtract the list of files to be created/modified from CONTEXT.md and RESEARCH.md. For each file, classify by role and data flow, find the closest existing analog in the codebase, extract concrete code excerpts, and produce PATTERNS.md.\n\n" }, "produces": [ "PATTERNS.md" ], "consumes": [ "RESEARCH.md" ], "when": "workflow.pattern_mapper", "onError": "skip" } ], "contributions": [ { "capId": "schema-gate", "point": "plan:pre", "into": "planner", "fragment": { "path": "fragments/plan-pre.md", "inline": "# Schema Push Detection Gate\n\n> Detects schema-relevant files in the phase scope and injects a mandatory `[BLOCKING]` schema push task into the plan. Prevents false-positive verification where build/types pass because TypeScript types come from config, not the live database.\n\nCheck if any files in the phase scope match schema patterns:\n\n```bash\nPHASE_SECTION=$(gsd_run query roadmap.get-phase \"${PHASE}\" --pick section 2>/dev/null)\n```\n\nScan `PHASE_SECTION`, `CONTEXT.md` (if loaded), and `RESEARCH.md` (if exists) for file paths matching these ORM patterns:\n\n| ORM | File Patterns |\n|-----|--------------|\n| Payload CMS | `src/collections/**/*.ts`, `src/globals/**/*.ts` |\n| Prisma | `prisma/schema.prisma`, `prisma/schema/*.prisma` |\n| Drizzle | `drizzle/schema.ts`, `src/db/schema.ts`, `drizzle/*.ts` |\n| Supabase | `supabase/migrations/*.sql` |\n| TypeORM | `src/entities/**/*.ts`, `src/migrations/**/*.ts` |\n\nAlso check if any existing PLAN.md files for this phase already reference these file patterns in `files_modified`.\n\n**If schema-relevant files detected:**\n\nSet `SCHEMA_PUSH_REQUIRED=true` and `SCHEMA_ORM={detected_orm}`.\n\nDetermine the push command for the detected ORM:\n\n| ORM | Push Command | Non-TTY Workaround |\n|-----|-------------|-------------------|\n| Payload CMS | `npx payload migrate` | `CI=true PAYLOAD_MIGRATING=true npx payload migrate` |\n| Prisma | `npx prisma db push` | `npx prisma db push --accept-data-loss` (if destructive) |\n| Drizzle | `npx drizzle-kit push` | `npx drizzle-kit push` |\n| Supabase | `supabase db push` | Set `SUPABASE_ACCESS_TOKEN` env var |\n| TypeORM | `npx typeorm migration:run` | `npx typeorm migration:run -d src/data-source.ts` |\n\nInject the following into the planner prompt (step 8) as an additional constraint:\n\n```markdown\n\n**[BLOCKING] Schema Push Required**\n\nThis phase modifies schema-relevant files ({detected_files}). The planner MUST include\na `[BLOCKING]` task that runs the database schema push command AFTER all schema file\nmodifications are complete but BEFORE verification.\n\n- ORM detected: {SCHEMA_ORM}\n- Push command: {push_command}\n- Non-TTY workaround: {env_hint}\n- If push requires interactive prompts that cannot be suppressed, flag the task for\n manual intervention with `autonomous: false`\n\nThis task is mandatory — the phase CANNOT pass verification without it. Build and\ntype checks will pass without the push (types come from config, not the live database),\ncreating a false-positive verification state.\n\n```\n\nDisplay: `Schema files detected ({SCHEMA_ORM}) — [BLOCKING] push task will be injected into plans`\n\n**If no schema-relevant files detected:** Skip silently.\n" }, "produces": [], "consumes": [ "CONTEXT.md" ], "when": "workflow.schema_push_detection", "onError": "skip" }, { "capId": "security", "point": "plan:pre", "into": "planner", "fragment": { "inline": "Each PLAN.md must include a block when security enforcement is active. Use the configured ASVS level and blocking threshold from workflow.security_asvs_level and workflow.security_block_on." }, "configValues": { "security_asvs_level": "workflow.security_asvs_level", "security_block_on": "workflow.security_block_on" }, "produces": [], "consumes": [ "CONTEXT.md" ], "when": "workflow.security_enforcement" }, { "capId": "tdd", "point": "plan:pre", "into": "planner", "fragment": { "inline": "\n**TDD Mode is ENABLED.** Apply TDD heuristics to all eligible tasks:\n- Business logic with defined I/O → type: tdd\n- API endpoints with request/response contracts → type: tdd\n- Data transformations, validation, algorithms → type: tdd\n- UI, config, glue code, CRUD → standard plan (type: execute)\nEach TDD plan gets one feature with RED/GREEN/REFACTOR gate sequence.\n" }, "produces": [], "consumes": [], "when": "workflow.tdd_mode", "onError": "skip" } ], "gates": [ { "capId": "ui", "point": "plan:pre", "check": { "query": "ui.plan-gate" }, "when": "workflow.ui_safety_gate", "blocking": true, "onError": "halt" } ] }, "plan:post": { "steps": [ { "capId": "mempalace", "point": "plan:post", "ref": { "skill": "mempalace-capture" }, "produces": [], "consumes": [ "PLAN.md" ], "when": "mempalace.enabled", "onError": "skip" } ], "contributions": [], "gates": [ { "capId": "gap-analysis", "point": "plan:post", "check": { "query": "gap-analysis.plan-post" }, "when": "workflow.post_planning_gaps", "blocking": false, "onError": "skip" } ] }, "execute:pre": { "steps": [], "contributions": [], "gates": [] }, "execute:wave:pre": { "steps": [], "contributions": [], "gates": [] }, "execute:wave:post": { "steps": [], "contributions": [ { "capId": "mempalace", "point": "execute:wave:post", "into": "verifier", "fragment": { "path": "fragments/capture-problems.md", "inline": "\n### Capture problems → fixes (MemPalace)\n\n**Gate first.** Read `.planning/config.json`. If `mempalace.enabled` is not `true`, or `mempalace.capture_artifacts` is `false`, **skip this entire section** and let the wave complete unchanged. (This contribution is only injected when the capability is enabled; the `capture_artifacts` check lets you turn capture off without disabling the rest of the capability.)\n\nOtherwise — after verifying this wave, persist any *confirmed* problem→fix pairs into the palace so they are recalled in future phases. This is best-effort; if MemPalace is unreachable, skip silently — capture never fails a wave.\n\nFor each confirmed bug/issue resolved in this wave:\n\n1. **Resolve the wing** (`mempalace.wing`, else `project_code`, else project dir) and target `room: problems`.\n2. **Dedupe first.** Call `mempalace_check_duplicate` (interactive) before filing so re-runs don't create duplicate drawers.\n3. **File the drawer verbatim.** Store the problem statement and its fix as a drawer in `room: problems` — interactive: `mempalace_add_drawer`; headless: `mempalace mine` / `mempalace hook run`. Include provenance (`source_file`, phase id).\n4. **Mirror the KG fact** when `mempalace.mirror_kg` is on: add `(, fixed_by, )` with `valid_from` = the phase date via `mempalace_kg_add`.\n5. **Mode awareness.** Only `augment` is currently wired: the fact is an *additive* mirror alongside `.planning/graphs/` (never a replacement). `kg_backend`/`replace` are forward-declared and behave as `augment` today.\n\nCaptures are idempotent: deterministic drawer IDs + `check_duplicate` mean re-running the wave re-files the same content without duplication. On any error, skip and let the wave complete normally.\n" }, "produces": [], "consumes": [], "when": "mempalace.enabled", "onError": "skip" } ], "gates": [ { "capId": "drift", "point": "execute:wave:post", "check": { "query": "verify.schema-drift" }, "when": "workflow.schema_drift_gate", "blocking": true, "onError": "skip" }, { "capId": "drift", "point": "execute:wave:post", "check": { "query": "verify.codebase-drift" }, "when": "workflow.schema_drift_gate", "blocking": false, "onError": "skip" }, { "capId": "ui", "point": "execute:wave:post", "check": { "query": "ui.safety-gate" }, "when": "workflow.ui_safety_gate", "blocking": true, "onError": "halt" } ] }, "execute:post": { "steps": [ { "capId": "code-review", "point": "execute:post", "ref": { "skill": "code-review" }, "produces": [ "REVIEW.md" ], "consumes": [ "SUMMARY.md" ], "when": "workflow.code_review", "onError": "skip" } ], "contributions": [], "gates": [ { "capId": "tdd", "point": "execute:post", "check": { "query": "tdd.review-checkpoint" }, "when": "workflow.tdd_mode", "blocking": false, "onError": "skip" } ] }, "verify:pre": { "steps": [], "contributions": [], "gates": [] }, "verify:post": { "steps": [ { "capId": "mempalace", "point": "verify:post", "ref": { "skill": "mempalace-capture" }, "produces": [], "consumes": [ "SUMMARY.md" ], "when": "mempalace.enabled", "onError": "skip" }, { "capId": "nyquist", "point": "verify:post", "ref": { "skill": "validate-phase" }, "produces": [ "VALIDATION.md" ], "consumes": [ "SUMMARY.md" ], "when": "workflow.nyquist_validation", "onError": "halt" }, { "capId": "security", "point": "verify:post", "ref": { "skill": "secure-phase" }, "produces": [ "SECURITY.md" ], "consumes": [ "SUMMARY.md" ], "when": "workflow.security_enforcement", "onError": "halt" }, { "capId": "ui", "point": "verify:post", "ref": { "skill": "ui-review" }, "produces": [ "UI-REVIEW.md" ], "consumes": [ "UI-SPEC.md" ], "when": "workflow.ui_review", "onError": "skip" } ], "contributions": [], "gates": [] }, "ship:pre": { "steps": [], "contributions": [], "gates": [ { "capId": "security", "point": "ship:pre", "check": { "predicate": { "kind": "artifact-frontmatter-equals", "artifact": "SECURITY.md", "field": "threats_open", "equals": 0 } }, "when": "workflow.security_enforcement", "blocking": true, "onError": "halt" } ] }, "ship:post": { "steps": [ { "capId": "mempalace", "point": "ship:post", "ref": { "agent": "gsd-mempalace-curator" }, "produces": [], "consumes": [ "UAT.md" ], "when": "mempalace.enabled", "onError": "skip" } ], "contributions": [], "gates": [] } }; const configKeys = { "workflow.ai_integration_phase": "ai-integration", "workflow.code_review": "code-review", "workflow.code_review_depth": "code-review", "workflow.drift_threshold": "drift", "workflow.drift_action": "drift", "workflow.schema_drift_gate": "drift", "workflow.post_planning_gaps": "gap-analysis", "graphify.enabled": "graphify", "intel.enabled": "intel", "mempalace.enabled": "mempalace", "mempalace.memory_mode": "mempalace", "mempalace.wing": "mempalace", "mempalace.recall_on_discuss": "mempalace", "mempalace.recall_on_plan": "mempalace", "mempalace.capture_artifacts": "mempalace", "mempalace.mirror_kg": "mempalace", "mempalace.cross_project_tunnels": "mempalace", "mempalace.diary_journal": "mempalace", "mempalace.auto_capture_hooks": "mempalace", "workflow.nyquist_validation": "nyquist", "workflow.pattern_mapper": "pattern-mapper", "profile-pipeline.enabled": "profile-pipeline", "workflow.research": "research", "workflow.schema_push_detection": "schema-gate", "workflow.security_enforcement": "security", "workflow.security_asvs_level": "security", "workflow.security_block_on": "security", "workflow.tdd_mode": "tdd", "workflow.ui_phase": "ui", "workflow.ui_review": "ui", "workflow.ui_safety_gate": "ui" }; const configSchema = { "workflow.ai_integration_phase": { "owner": "ai-integration", "type": "boolean", "default": true, "description": "Prompt for an AI-SPEC design contract before planning phases that involve AI systems." }, "workflow.code_review": { "owner": "code-review", "type": "boolean", "default": true, "description": "Enable code-review participation in post-execution review flows." }, "workflow.code_review_depth": { "owner": "code-review", "type": "enum", "default": "standard", "description": "Default depth for code review when no --depth override is supplied.", "values": [ "quick", "standard", "deep" ] }, "workflow.drift_threshold": { "owner": "drift", "type": "number", "default": 3, "description": "Minimum number of new structural elements (directories, barrel exports, migrations, routes) before the codebase drift gate triggers a warn or auto-remap action." }, "workflow.drift_action": { "owner": "drift", "type": "enum", "default": "warn", "description": "Action taken by the codebase drift gate when the threshold is exceeded: warn (advisory message) or auto-remap (spawn gsd-codebase-mapper agent to refresh STRUCTURE.md).", "values": [ "warn", "auto-remap" ] }, "workflow.schema_drift_gate": { "owner": "drift", "type": "boolean", "default": true, "description": "Enable the drift gates at execute:wave:post. When enabled, the schema drift gate blocks verification if schema-relevant files changed during execution but no database push command was executed; the codebase drift gate (non-blocking) warns when structural additions exceed the drift_threshold." }, "workflow.post_planning_gaps": { "owner": "gap-analysis", "type": "boolean", "default": true, "description": "Run the post-planning gap analysis report after plans are generated." }, "graphify.enabled": { "owner": "graphify", "type": "boolean", "default": false, "description": "Enable the graphify knowledge-graph command + skill." }, "intel.enabled": { "owner": "intel", "type": "boolean", "default": false, "description": "Enable the intel code-intelligence command." }, "mempalace.enabled": { "owner": "mempalace", "type": "boolean", "default": false, "description": "Master toggle for the MemPalace memory capability." }, "mempalace.memory_mode": { "owner": "mempalace", "type": "enum", "default": "augment", "description": "How MemPalace relates to GSD native memory. Only 'augment' (additive) is implemented today; 'kg_backend' and 'replace' are forward-declared (routing seam not yet built) and currently behave as 'augment'.", "values": [ "augment", "kg_backend", "replace" ] }, "mempalace.wing": { "owner": "mempalace", "type": "string", "default": "", "description": "Palace wing name; empty derives from project_code / project dir." }, "mempalace.recall_on_discuss": { "owner": "mempalace", "type": "boolean", "default": true, "description": "Inject wake-up + search recall at discuss:pre." }, "mempalace.recall_on_plan": { "owner": "mempalace", "type": "boolean", "default": true, "description": "Produce MEMORY-RECALL.md at plan:pre." }, "mempalace.capture_artifacts": { "owner": "mempalace", "type": "boolean", "default": true, "description": "File CONTEXT/PLAN/SUMMARY and learnings into the palace at phase boundaries." }, "mempalace.mirror_kg": { "owner": "mempalace", "type": "boolean", "default": true, "description": "Mirror decisions/learnings into MemPalace's temporal knowledge graph." }, "mempalace.cross_project_tunnels": { "owner": "mempalace", "type": "boolean", "default": false, "description": "Propose/create cross-wing tunnels at ship:post." }, "mempalace.diary_journal": { "owner": "mempalace", "type": "boolean", "default": true, "description": "Write a per-agent diary entry at ship:post." }, "mempalace.auto_capture_hooks": { "owner": "mempalace", "type": "boolean", "default": false, "description": "Reserved / not yet implemented: will install MemPalace's native stop/precompact Claude Code hooks for passive mid-session capture (the capability's hooks array is currently empty)." }, "workflow.nyquist_validation": { "owner": "nyquist", "type": "boolean", "default": true, "description": "Enable Nyquist validation coverage auditing." }, "workflow.pattern_mapper": { "owner": "pattern-mapper", "type": "boolean", "default": true, "description": "Run the pattern mapper before planning when context or research is available." }, "profile-pipeline.enabled": { "owner": "profile-pipeline", "type": "boolean", "default": false, "description": "Enable the developer profiling pipeline commands (scan-sessions, extract-messages, profile-sample, write-profile, etc.)." }, "workflow.research": { "owner": "research", "type": "boolean", "default": true, "description": "Run phase research before planning when research artifacts are missing or explicitly refreshed." }, "workflow.schema_push_detection": { "owner": "schema-gate", "type": "boolean", "default": true, "description": "Enable ORM schema push detection during planning. When schema-relevant files are detected in the phase scope, a [BLOCKING] push task is injected into the plan." }, "workflow.security_enforcement": { "owner": "security", "type": "boolean", "default": true, "description": "Enable security threat-mitigation verification before phase advancement." }, "workflow.security_asvs_level": { "owner": "security", "type": "number", "default": 1, "description": "OWASP ASVS level used by security review guidance." }, "workflow.security_block_on": { "owner": "security", "type": "enum", "default": "high", "description": "Minimum open threat severity that blocks advancement.", "values": [ "critical", "high", "medium", "low", "none" ] }, "workflow.tdd_mode": { "owner": "tdd", "type": "boolean", "default": false, "description": "Enable TDD mode: planner annotates eligible tasks type:tdd and executor enforces RED/GREEN/REFACTOR gate sequence." }, "workflow.ui_phase": { "owner": "ui", "type": "boolean", "default": true, "description": "Enable the UI design-contract gate during planning." }, "workflow.ui_review": { "owner": "ui", "type": "boolean", "default": true, "description": "Enable the retrospective UI audit." }, "workflow.ui_safety_gate": { "owner": "ui", "type": "boolean", "default": true, "description": "Block execution on unmet UI-SPEC contracts." } }; const runtimes = { "antigravity": { "id": "antigravity", "role": "runtime", "title": "Antigravity", "description": "Google Antigravity IDE — nested under ~/.gemini/antigravity; probed across 1.x and 2.x layouts; Gemini hook event dialect; nested skill layout; tier-1 support.", "tier": "core", "requires": [], "runtime": { "configHome": { "kind": "dot-home-nested", "name": "antigravity", "parent": ".gemini", "env": [ "ANTIGRAVITY_CONFIG_DIR" ], "probe": [ "antigravity", "antigravity-ide", "antigravity-cli" ] }, "configFormat": "settings-json", "artifactLayout": { "global": [ { "kind": "skills", "destSubpath": "skills", "prefix": "gsd-", "nesting": "nested", "recursive": false, "converter": "convertClaudeCommandToAntigravitySkill" } ], "local": [ { "kind": "skills", "destSubpath": "skills", "prefix": "gsd-", "nesting": "nested", "recursive": false, "converter": "convertClaudeCommandToAntigravitySkill" } ] }, "commandStyle": "slash-hyphen", "hooksSurface": "settings-json", "hookEvents": "gemini", "sandboxTier": "none", "supportTier": 1, "installSurface": "settings-json", "writesSharedSettings": true, "permissionWriter": null, "extendedHookEvents": [] } }, "augment": { "id": "augment", "role": "runtime", "title": "Augment Code", "description": "Augment Code CLI — commands + nested-skill artifact layout; settings-json hook surface; Claude hook event dialect; tier-2 support.", "tier": "core", "requires": [], "runtime": { "configHome": { "kind": "dot-home", "name": ".augment", "env": [ "AUGMENT_CONFIG_DIR" ] }, "configFormat": "settings-json", "artifactLayout": { "global": [ { "kind": "commands", "destSubpath": "commands", "prefix": "gsd-", "nesting": "flat", "recursive": false, "converter": null }, { "kind": "skills", "destSubpath": "skills", "prefix": "gsd-", "nesting": "nested", "recursive": false, "converter": "convertClaudeCommandToAugmentSkill" } ], "local": [ { "kind": "commands", "destSubpath": "commands", "prefix": "gsd-", "nesting": "flat", "recursive": false, "converter": null }, { "kind": "skills", "destSubpath": "skills", "prefix": "gsd-", "nesting": "nested", "recursive": false, "converter": "convertClaudeCommandToAugmentSkill" } ] }, "commandStyle": "slash-hyphen", "hooksSurface": "settings-json", "hookEvents": "claude", "sandboxTier": "none", "supportTier": 2, "installSurface": "settings-json", "writesSharedSettings": true, "permissionWriter": null, "extendedHookEvents": [] } }, "claude": { "id": "claude", "role": "runtime", "title": "Claude Code", "description": "Anthropic Claude Code — primary development runtime; tier-1 support with full hook surface and skills-based global install.", "tier": "core", "requires": [], "runtime": { "configHome": { "kind": "dot-home", "name": ".claude", "env": [ "CLAUDE_CONFIG_DIR" ] }, "configFormat": "settings-json", "artifactLayout": { "global": [ { "kind": "skills", "destSubpath": "skills", "prefix": "gsd-", "nesting": "flat", "recursive": false, "converter": "convertClaudeCommandToClaudeSkill" } ], "local": [ { "kind": "commands", "destSubpath": "commands/gsd", "prefix": "gsd-", "nesting": "flat", "recursive": false, "converter": null }, { "kind": "agents", "destSubpath": "agents", "prefix": "gsd-", "nesting": "flat", "recursive": false, "converter": null } ] }, "commandStyle": "slash-hyphen", "hooksSurface": "settings-json", "hookEvents": "claude", "sandboxTier": "none", "supportTier": 1, "installSurface": "settings-json", "writesSharedSettings": true, "permissionWriter": null, "extendedHookEvents": [ "SubagentStop", "Stop", "PreCompact", "FileChanged" ] } }, "cline": { "id": "cline", "role": "runtime", "title": "Cline", "description": "Cline (VS Code extension) — global-only nested-skill layout; cline-rules hook surface (.clinerules); no hook events emitted; tier-2 support.", "tier": "core", "requires": [], "runtime": { "configHome": { "kind": "dot-home", "name": ".cline", "env": [ "CLINE_CONFIG_DIR" ] }, "configFormat": "markdown-dir", "artifactLayout": { "global": [ { "kind": "skills", "destSubpath": "skills", "prefix": "gsd-", "nesting": "nested", "recursive": false, "converter": "convertClaudeCommandToClineSkill" } ], "local": [] }, "commandStyle": "slash-hyphen", "hooksSurface": "cline-rules", "sandboxTier": "none", "supportTier": 2, "installSurface": "cline-rules", "writesSharedSettings": false, "permissionWriter": null, "extendedHookEvents": [] } }, "codebuddy": { "id": "codebuddy", "role": "runtime", "title": "CodeBuddy", "description": "CodeBuddy (Tencent) — converted commands + skills artifact layout; settings-json hook surface; Claude hook event dialect; tier-2 support.", "tier": "core", "requires": [], "runtime": { "configHome": { "kind": "dot-home", "name": ".codebuddy", "env": [ "CODEBUDDY_CONFIG_DIR" ] }, "configFormat": "settings-json", "artifactLayout": { "global": [ { "kind": "commands", "destSubpath": "commands", "prefix": "gsd-", "nesting": "flat", "recursive": false, "converter": "convertClaudeCommandToCodebuddyCommand" }, { "kind": "skills", "destSubpath": "skills", "prefix": "gsd-", "nesting": "flat", "recursive": false, "converter": "convertClaudeCommandToCodebuddySkill" } ], "local": [ { "kind": "commands", "destSubpath": "commands", "prefix": "gsd-", "nesting": "flat", "recursive": false, "converter": "convertClaudeCommandToCodebuddyCommand" }, { "kind": "skills", "destSubpath": "skills", "prefix": "gsd-", "nesting": "flat", "recursive": false, "converter": "convertClaudeCommandToCodebuddySkill" } ] }, "commandStyle": "slash-hyphen", "hooksSurface": "settings-json", "hookEvents": "claude", "sandboxTier": "none", "supportTier": 2, "installSurface": "settings-json", "writesSharedSettings": true, "permissionWriter": null, "extendedHookEvents": [] } }, "codex": { "id": "codex", "role": "runtime", "title": "OpenAI Codex CLI", "description": "OpenAI Codex CLI — shell-var command style; per-agent sandbox tiers; config.toml + hooks.json hook surface; tier-1 support.", "tier": "core", "requires": [], "runtime": { "configHome": { "kind": "dot-home", "name": ".codex", "env": [ "CODEX_HOME" ] }, "configFormat": "toml", "artifactLayout": { "global": [ { "kind": "skills", "destSubpath": "skills", "prefix": "gsd-", "nesting": "flat", "recursive": false, "converter": "convertClaudeCommandToCodexSkill" } ], "local": [ { "kind": "skills", "destSubpath": "skills", "prefix": "gsd-", "nesting": "flat", "recursive": false, "converter": "convertClaudeCommandToCodexSkill" } ] }, "commandStyle": "shell-var", "hooksSurface": "codex-hooks-json", "hookEvents": "claude", "sandboxTier": "codex-agent-sandbox", "supportTier": 1, "installSurface": "codex-toml", "writesSharedSettings": false, "permissionWriter": null, "extendedHookEvents": [] } }, "copilot": { "id": "copilot", "role": "runtime", "title": "GitHub Copilot", "description": "GitHub Copilot (VS Code) — markdown config format; copilot-inline hook surface; no hook events emitted; flat skill nesting (unconfirmed recursive loader); tier-2 support.", "tier": "core", "requires": [], "runtime": { "configHome": { "kind": "dot-home", "name": ".copilot", "env": [ "COPILOT_CONFIG_DIR", "COPILOT_HOME" ] }, "configFormat": "markdown", "artifactLayout": { "global": [ { "kind": "skills", "destSubpath": "skills", "prefix": "gsd-", "nesting": "flat", "recursive": false, "converter": "convertClaudeCommandToCopilotSkill" } ], "local": [ { "kind": "skills", "destSubpath": "skills", "prefix": "gsd-", "nesting": "flat", "recursive": false, "converter": "convertClaudeCommandToCopilotSkill" } ] }, "commandStyle": "slash-hyphen", "hooksSurface": "copilot-inline", "sandboxTier": "none", "supportTier": 2, "installSurface": "copilot-instructions", "writesSharedSettings": false, "permissionWriter": null, "extendedHookEvents": [] } }, "cursor": { "id": "cursor", "role": "runtime", "title": "Cursor", "description": "Cursor IDE — skills + converted commands artifact layout; hooks.json surface; Claude hook event dialect; recursive skill loader (flat nesting); tier-2 support.", "tier": "core", "requires": [], "runtime": { "configHome": { "kind": "dot-home", "name": ".cursor", "env": [ "CURSOR_CONFIG_DIR" ] }, "configFormat": "none", "artifactLayout": { "global": [ { "kind": "skills", "destSubpath": "skills", "prefix": "gsd-", "nesting": "flat", "recursive": true, "converter": "convertClaudeCommandToCursorSkill" }, { "kind": "commands", "destSubpath": "commands", "prefix": "gsd-", "nesting": "flat", "recursive": false, "converter": "convertClaudeCommandToCursorCommand" } ], "local": [ { "kind": "skills", "destSubpath": "skills", "prefix": "gsd-", "nesting": "flat", "recursive": true, "converter": "convertClaudeCommandToCursorSkill" }, { "kind": "commands", "destSubpath": "commands", "prefix": "gsd-", "nesting": "flat", "recursive": false, "converter": "convertClaudeCommandToCursorCommand" } ] }, "commandStyle": "slash-hyphen", "hooksSurface": "cursor-hooks-json", "hookEvents": "claude", "sandboxTier": "none", "supportTier": 2, "installSurface": "cursor-hooks-json", "writesSharedSettings": false, "permissionWriter": null, "extendedHookEvents": [] } }, "gemini": { "id": "gemini", "role": "runtime", "title": "Gemini CLI", "description": "Google Gemini CLI — commands-only artifact layout (TOML); Gemini hook event dialect; settings-json hook surface; tier-2 support.", "tier": "core", "requires": [], "runtime": { "configHome": { "kind": "dot-home", "name": ".gemini", "env": [ "GEMINI_CONFIG_DIR" ] }, "configFormat": "settings-json", "artifactLayout": { "global": [ { "kind": "commands", "destSubpath": "commands/gsd", "prefix": "gsd-", "nesting": "flat", "recursive": false, "converter": null } ], "local": [ { "kind": "commands", "destSubpath": "commands/gsd", "prefix": "gsd-", "nesting": "flat", "recursive": false, "converter": null } ] }, "commandStyle": "slash-hyphen", "hooksSurface": "settings-json", "hookEvents": "gemini", "sandboxTier": "none", "supportTier": 2, "installSurface": "settings-json", "writesSharedSettings": true, "permissionWriter": null, "extendedHookEvents": [ "BeforeAgent", "AfterAgent", "BeforeModel" ] } }, "hermes": { "id": "hermes", "role": "runtime", "title": "Hermes Agent", "description": "Hermes Agent (NousResearch) — skills nest under skills/gsd/ category bucket; nested skill layout; settings-json hook surface; Claude hook event dialect; tier-2 support.", "tier": "core", "requires": [], "runtime": { "configHome": { "kind": "dot-home", "name": ".hermes", "env": [ "HERMES_HOME" ] }, "configFormat": "settings-json", "artifactLayout": { "global": [ { "kind": "skills", "destSubpath": "skills/gsd", "prefix": "gsd-", "nesting": "nested", "recursive": false, "converter": "convertClaudeCommandToClaudeSkill" } ], "local": [ { "kind": "skills", "destSubpath": "skills/gsd", "prefix": "gsd-", "nesting": "nested", "recursive": false, "converter": "convertClaudeCommandToClaudeSkill" } ] }, "commandStyle": "slash-hyphen", "hooksSurface": "settings-json", "hookEvents": "claude", "sandboxTier": "none", "supportTier": 2, "installSurface": "settings-json", "writesSharedSettings": true, "permissionWriter": null, "extendedHookEvents": [] } }, "kilo": { "id": "kilo", "role": "runtime", "title": "Kilo Code", "description": "Kilo Code — XDG-based config dir; global skills at ~/.kilo/skills (separate from XDG config); flat command/ + skills artifact layout; no lifecycle hook registration; tier-2 support.", "tier": "core", "requires": [], "runtime": { "configHome": { "kind": "xdg", "name": "kilo", "env": [ "KILO_CONFIG_DIR", "KILO_CONFIG", "XDG_CONFIG_HOME" ], "skillsHome": { "kind": "dot-home", "name": ".kilo", "env": [] } }, "configFormat": "settings-json", "artifactLayout": { "global": [ { "kind": "commands", "destSubpath": "command", "prefix": "gsd-", "nesting": "flat", "recursive": false, "converter": null }, { "kind": "skills", "destSubpath": "skills", "prefix": "gsd-", "nesting": "flat", "recursive": true, "converter": "convertClaudeCommandToKiloSkill" } ], "local": [ { "kind": "commands", "destSubpath": "command", "prefix": "gsd-", "nesting": "flat", "recursive": false, "converter": null }, { "kind": "skills", "destSubpath": "skills", "prefix": "gsd-", "nesting": "flat", "recursive": true, "converter": "convertClaudeCommandToKiloSkill" } ] }, "commandStyle": "slash-hyphen", "hooksSurface": "none", "sandboxTier": "none", "supportTier": 2, "installSurface": "settings-json", "writesSharedSettings": false, "permissionWriter": "kilo", "extendedHookEvents": [] } }, "kimi": { "id": "kimi", "role": "runtime", "title": "Kimi CLI", "description": "Kimi CLI (Moonshot AI) — generic agents root at ~/.config/agents; skills + kimi-agents artifact layout; no hook surface; no hook events; tier-2 support.", "tier": "core", "requires": [], "runtime": { "configHome": { "kind": "generic-agents-root", "name": "agents", "env": [ "KIMI_CONFIG_DIR" ], "probe": [ "~/.config/agents", "~/.agents" ], "probeExists": "skills" }, "configFormat": "none", "artifactLayout": { "global": [ { "kind": "skills", "destSubpath": "skills", "prefix": "gsd-", "nesting": "flat", "recursive": false, "converter": "convertClaudeCommandToKimiSkill" }, { "kind": "kimi-agents", "destSubpath": "agents", "prefix": "gsd", "nesting": "flat", "recursive": false, "converter": null } ], "local": [] }, "commandStyle": "slash-hyphen", "hooksSurface": "none", "sandboxTier": "none", "supportTier": 2, "installSurface": "profile-marker-only", "writesSharedSettings": false, "permissionWriter": null, "extendedHookEvents": [] } }, "opencode": { "id": "opencode", "role": "runtime", "title": "OpenCode", "description": "OpenCode — XDG-based config dir; flat command/ + skills artifact layout; settings-json config format; no lifecycle hook registration; tier-2 support.", "tier": "core", "requires": [], "runtime": { "configHome": { "kind": "xdg", "name": "opencode", "env": [ "OPENCODE_CONFIG_DIR", "OPENCODE_CONFIG", "XDG_CONFIG_HOME" ] }, "configFormat": "settings-json", "artifactLayout": { "global": [ { "kind": "commands", "destSubpath": "command", "prefix": "gsd-", "nesting": "flat", "recursive": false, "converter": null }, { "kind": "skills", "destSubpath": "skills", "prefix": "gsd-", "nesting": "flat", "recursive": true, "converter": "convertClaudeCommandToOpencodeSkill" } ], "local": [ { "kind": "commands", "destSubpath": "command", "prefix": "gsd-", "nesting": "flat", "recursive": false, "converter": null }, { "kind": "skills", "destSubpath": "skills", "prefix": "gsd-", "nesting": "flat", "recursive": true, "converter": "convertClaudeCommandToOpencodeSkill" } ] }, "commandStyle": "slash-hyphen", "hooksSurface": "none", "sandboxTier": "none", "supportTier": 2, "installSurface": "settings-json", "writesSharedSettings": true, "permissionWriter": "opencode", "extendedHookEvents": [] } }, "qwen": { "id": "qwen", "role": "runtime", "title": "Qwen Code", "description": "Qwen Code (Alibaba) — nested-skill artifact layout; settings-json hook surface; Claude hook event dialect; tier-2 support.", "tier": "core", "requires": [], "runtime": { "configHome": { "kind": "dot-home", "name": ".qwen", "env": [ "QWEN_CONFIG_DIR" ] }, "configFormat": "settings-json", "artifactLayout": { "global": [ { "kind": "skills", "destSubpath": "skills", "prefix": "gsd-", "nesting": "nested", "recursive": false, "converter": "convertClaudeCommandToClaudeSkill" } ], "local": [ { "kind": "skills", "destSubpath": "skills", "prefix": "gsd-", "nesting": "nested", "recursive": false, "converter": "convertClaudeCommandToClaudeSkill" } ] }, "commandStyle": "slash-hyphen", "hooksSurface": "settings-json", "hookEvents": "claude", "sandboxTier": "none", "supportTier": 2, "installSurface": "settings-json", "writesSharedSettings": true, "permissionWriter": null, "extendedHookEvents": [ "SubagentStop", "Stop", "PreCompact" ] } }, "trae": { "id": "trae", "role": "runtime", "title": "Trae IDE", "description": "Trae IDE — nested-skill artifact layout; no hook surface (profile-marker-only config); tier-2 support.", "tier": "core", "requires": [], "runtime": { "configHome": { "kind": "dot-home", "name": ".trae", "env": [ "TRAE_CONFIG_DIR" ] }, "configFormat": "none", "artifactLayout": { "global": [ { "kind": "skills", "destSubpath": "skills", "prefix": "gsd-", "nesting": "nested", "recursive": false, "converter": "convertClaudeCommandToTraeSkill" } ], "local": [ { "kind": "skills", "destSubpath": "skills", "prefix": "gsd-", "nesting": "nested", "recursive": false, "converter": "convertClaudeCommandToTraeSkill" } ] }, "commandStyle": "slash-hyphen", "hooksSurface": "none", "sandboxTier": "none", "supportTier": 2, "installSurface": "profile-marker-only", "writesSharedSettings": false, "permissionWriter": null, "extendedHookEvents": [] } }, "windsurf": { "id": "windsurf", "role": "runtime", "title": "Windsurf", "description": "Windsurf (Codeium) — nested under ~/.codeium/windsurf; skills-only artifact layout; no hook surface; no hook events; tier-2 support.", "tier": "core", "requires": [], "runtime": { "configHome": { "kind": "dot-home-nested", "name": "windsurf", "parent": ".codeium", "env": [ "WINDSURF_CONFIG_DIR" ] }, "configFormat": "none", "artifactLayout": { "global": [ { "kind": "skills", "destSubpath": "skills", "prefix": "gsd-", "nesting": "flat", "recursive": false, "converter": "convertClaudeCommandToWindsurfSkill" } ], "local": [ { "kind": "skills", "destSubpath": "skills", "prefix": "gsd-", "nesting": "flat", "recursive": false, "converter": "convertClaudeCommandToWindsurfSkill" } ] }, "commandStyle": "slash-hyphen", "hooksSurface": "none", "sandboxTier": "none", "supportTier": 2, "installSurface": "profile-marker-only", "writesSharedSettings": false, "permissionWriter": null, "extendedHookEvents": [] } } }; const commandFamilies = { "audit-open": { "capId": "audit", "module": "audit-command-router.cjs", "router": "routeAuditOpen" }, "audit-uat": { "capId": "audit", "module": "audit-command-router.cjs", "router": "routeAuditUat" }, "extract-messages": { "capId": "profile-pipeline", "module": "profile-pipeline-command-router.cjs", "router": "routeExtractMessages" }, "generate-claude-md": { "capId": "profile-pipeline", "module": "profile-pipeline-command-router.cjs", "router": "routeGenerateClaudeMd" }, "generate-claude-profile": { "capId": "profile-pipeline", "module": "profile-pipeline-command-router.cjs", "router": "routeGenerateClaudeProfile" }, "generate-dev-preferences": { "capId": "profile-pipeline", "module": "profile-pipeline-command-router.cjs", "router": "routeGenerateDevPreferences" }, "graphify": { "capId": "graphify", "module": "graphify-command-router.cjs", "router": "routeGraphifyCommand" }, "intel": { "capId": "intel", "module": "intel-command-router.cjs", "router": "routeIntelCommand" }, "profile-questionnaire": { "capId": "profile-pipeline", "module": "profile-pipeline-command-router.cjs", "router": "routeProfileQuestionnaire" }, "profile-sample": { "capId": "profile-pipeline", "module": "profile-pipeline-command-router.cjs", "router": "routeProfileSample" }, "scan-sessions": { "capId": "profile-pipeline", "module": "profile-pipeline-command-router.cjs", "router": "routeScanSessions" }, "write-profile": { "capId": "profile-pipeline", "module": "profile-pipeline-command-router.cjs", "router": "routeWriteProfile" } }; const capabilityClusters = { "ai-integration": [ "ai-integration-phase" ], "code-review": [ "code-review" ], "graphify": [ "graphify" ], "mempalace": [ "mempalace-capture", "mempalace-recall" ], "nyquist": [ "validate-phase" ], "profile-pipeline": [ "profile-user" ], "security": [ "secure-phase" ], "ui": [ "ui-phase", "ui-review" ] }; const profileMembership = { "ai-integration": { "tier": "full", "profiles": [ "full" ] }, "code-review": { "tier": "full", "profiles": [ "full" ] }, "graphify": { "tier": "full", "profiles": [ "full" ] }, "mempalace": { "tier": "full", "profiles": [ "full" ] }, "nyquist": { "tier": "full", "profiles": [ "full" ] }, "profile-pipeline": { "tier": "full", "profiles": [ "full" ] }, "security": { "tier": "full", "profiles": [ "full" ] }, "ui": { "tier": "full", "profiles": [ "full" ] } }; const _requiresGraph = { "ai-integration": [], "antigravity": [], "audit": [], "augment": [], "claude": [], "cline": [], "code-review": [], "codebuddy": [], "codex": [], "copilot": [], "cursor": [], "drift": [], "gap-analysis": [], "gemini": [], "graphify": [], "hermes": [], "intel": [], "kilo": [], "kimi": [], "mempalace": [], "nyquist": [], "opencode": [], "pattern-mapper": [ "research" ], "profile-pipeline": [], "qwen": [], "research": [], "schema-gate": [], "security": [], "tdd": [], "trae": [], "ui": [], "windsurf": [] }; function requiresClosure(id) { const visited = new Set(); const queue = [id]; while (queue.length > 0) { const current = queue.shift(); const reqs = _requiresGraph[current] || []; for (const req of reqs) { if (!visited.has(req)) { visited.add(req); queue.push(req); } } } return visited; } module.exports = { version: '1', capabilities, bySkill, byAgent, byLoopPoint, configKeys, configSchema, runtimes, commandFamilies, capabilityClusters, profileMembership, requiresClosure, };