feat(#1596): ship GSD skills via .claude-plugin/plugin.json
Phase B-provide of epic #1258. Adds a build-generated skills/ dir + a skills manifest field so plugin-installed GSD exposes gsd-core:<skill> the native Claude Code way. Closes the gap where plugin-only installs lacked the skill surface because bin/install.js never ran. - scripts/gen-plugin-skills.cjs: build step converting commands/gsd/*.md to skills/gsd-<stem>/SKILL.md via convertClaudeCommandToClaudeSkill - .claude-plugin/plugin.json: add "skills": "./skills/" - package.json: add skills to files, gen:plugin-skills to build chain - tests/issue-766-plugin-manifest.test.cjs: Section H conformance (manifest field + dir + frontmatter + count parity) + C2 skills symlink - docs/adr/766-*.md: dated amendment adding skills surface row - .changeset/rapid-bears-hum.md: type Added - skills/: 69 generated gsd-<stem>/SKILL.md files (build-committed) Closes #1596
This commit is contained in:
Tom Boucher
5
.changeset/rapid-bears-hum.md
Normal file
5
.changeset/rapid-bears-hum.md
Normal file
@@ -0,0 +1,5 @@
|
|||||||
|
---
|
||||||
|
type: Added
|
||||||
|
pr: 0
|
||||||
|
---
|
||||||
|
**Plugin installs now expose GSD skills** — when GSD is installed as a Claude Code plugin (`claude plugin install`), its skills are available via `gsd-core:<skill>` the native way. Previously, plugin-only installs lacked the skill surface because `bin/install.js` never ran; agents that preload `global:gsd-core:<skill>` (PR #1261) now resolve against plugin-provided skills. (#1596)
|
||||||
@@ -19,5 +19,6 @@
|
|||||||
"gsd"
|
"gsd"
|
||||||
],
|
],
|
||||||
"commands": "./commands/gsd/",
|
"commands": "./commands/gsd/",
|
||||||
|
"skills": "./skills/",
|
||||||
"hooks": "./hooks/hooks.json"
|
"hooks": "./hooks/hooks.json"
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -68,3 +68,13 @@ To keep the Seam honest about where the plugin contract ends:
|
|||||||
- Installer Module (`bin/install.js`) — owns the `settings.json` always-on hook wiring this Module mirrors for the plugin path.
|
- Installer Module (`bin/install.js`) — owns the `settings.json` always-on hook wiring this Module mirrors for the plugin path.
|
||||||
- `CONTEXT.md` § Glossary — Domain modules and seams (where this Module is registered).
|
- `CONTEXT.md` § Glossary — Domain modules and seams (where this Module is registered).
|
||||||
- Claude Code plugin contract: <https://code.claude.com/docs/en/plugins-reference>.
|
- Claude Code plugin contract: <https://code.claude.com/docs/en/plugins-reference>.
|
||||||
|
|
||||||
|
## Amendment 2026-06-22 — Skills surface projection (#1596)
|
||||||
|
|
||||||
|
The original mapping table projected commands + hooks but omitted skills. Phase B-provide of epic #1258 adds the skills surface:
|
||||||
|
|
||||||
|
| gsd-core surface / source | Claude Code plugin field | Rule / invariant |
|
||||||
|
|---|---|---|
|
||||||
|
| Skill surface (`commands/gsd/*.md` → build-converted) | `skills: "./skills/"` | A `skills/` dir of build-generated `gsd-<stem>/SKILL.md` files, produced by `scripts/gen-plugin-skills.cjs` running `convertClaudeCommandToClaudeSkill` (the same converter the file-copy installer uses). Generated at build time (`npm run build`) and committed (consistent with ADR-457's generated-committed-output pattern). This closes the gap where plugin-only installs lacked the skill surface because `bin/install.js` never ran. Methodology defined by ADR-1593 §5. |
|
||||||
|
|
||||||
|
The `skills/` dir is **generated, not hand-authored** — `scripts/gen-plugin-skills.cjs --check` verifies staleness. The conformance test (`tests/issue-766-plugin-manifest.test.cjs` Section H) asserts the manifest field, dir presence, frontmatter validity, and count parity with `commands/gsd/*.md` (`DEFECT.GENERATIVE-FIX`).
|
||||||
|
|||||||
@@ -10,6 +10,7 @@
|
|||||||
"files": [
|
"files": [
|
||||||
"bin",
|
"bin",
|
||||||
"commands",
|
"commands",
|
||||||
|
"skills",
|
||||||
"gsd-core",
|
"gsd-core",
|
||||||
"assets",
|
"assets",
|
||||||
"agents",
|
"agents",
|
||||||
@@ -78,13 +79,14 @@
|
|||||||
"check:alias-drift": "node scripts/check-alias-drift.cjs",
|
"check:alias-drift": "node scripts/check-alias-drift.cjs",
|
||||||
"check:identity-drift": "node scripts/lint-package-identity-drift.cjs",
|
"check:identity-drift": "node scripts/lint-package-identity-drift.cjs",
|
||||||
"check:integrity": "node scripts/check-npm-integrity.cjs",
|
"check:integrity": "node scripts/check-npm-integrity.cjs",
|
||||||
"build": "npm run generate:identity && npm run build:lib && npm run gen:loop-host-contract && npm run gen:capability-registry && npm run build:hooks",
|
"build": "npm run generate:identity && npm run build:lib && npm run gen:plugin-skills && npm run gen:loop-host-contract && npm run gen:capability-registry && npm run build:hooks",
|
||||||
"build:hooks": "node scripts/build-hooks.js",
|
"build:hooks": "node scripts/build-hooks.js",
|
||||||
"build:lib": "tsc -p tsconfig.build.json",
|
"build:lib": "tsc -p tsconfig.build.json",
|
||||||
"generate:identity": "node scripts/generate-package-identity.cjs",
|
"generate:identity": "node scripts/generate-package-identity.cjs",
|
||||||
"gen:loop-host-contract": "node scripts/gen-loop-host-contract.cjs --write",
|
"gen:loop-host-contract": "node scripts/gen-loop-host-contract.cjs --write",
|
||||||
|
"gen:plugin-skills": "node scripts/gen-plugin-skills.cjs --write",
|
||||||
"gen:capability-registry": "node scripts/gen-capability-registry.cjs --write",
|
"gen:capability-registry": "node scripts/gen-capability-registry.cjs --write",
|
||||||
"prepack": "npm run build:lib",
|
"prepack": "npm run build:lib && npm run gen:plugin-skills",
|
||||||
"prepare": "npm run build:lib",
|
"prepare": "npm run build:lib",
|
||||||
"version": "node scripts/sync-manifest-versions.cjs --stage && node scripts/gen-capability-registry.cjs --write && git add gsd-core/bin/lib/capability-registry.cjs",
|
"version": "node scripts/sync-manifest-versions.cjs --stage && node scripts/gen-capability-registry.cjs --write && git add gsd-core/bin/lib/capability-registry.cjs",
|
||||||
"prepublishOnly": "npm run build:lib && npm run build:hooks",
|
"prepublishOnly": "npm run build:lib && npm run build:hooks",
|
||||||
|
|||||||
117
scripts/gen-plugin-skills.cjs
Normal file
117
scripts/gen-plugin-skills.cjs
Normal file
@@ -0,0 +1,117 @@
|
|||||||
|
#!/usr/bin/env node
|
||||||
|
'use strict';
|
||||||
|
|
||||||
|
/**
|
||||||
|
* gen-plugin-skills.cjs — generates skills/gsd-<stem>/SKILL.md from
|
||||||
|
* commands/gsd/*.md using convertClaudeCommandToClaudeSkill.
|
||||||
|
*
|
||||||
|
* Usage:
|
||||||
|
* node scripts/gen-plugin-skills.cjs # print summary to stdout
|
||||||
|
* node scripts/gen-plugin-skills.cjs --write # write skills/ dir
|
||||||
|
* node scripts/gen-plugin-skills.cjs --check # exit 1 if committed skills/ is stale
|
||||||
|
*
|
||||||
|
* #1596 Phase B-provide. The Claude Code plugin contract discovers skills from
|
||||||
|
* a skills/ directory (plugins-reference). GSD's source-of-truth commands live
|
||||||
|
* in commands/gsd/*.md (command frontmatter); this script converts each to
|
||||||
|
* skill format using the same convertClaudeCommandToClaudeSkill the file-copy
|
||||||
|
* installer uses, producing a build-generated skills/ dir that ships in the
|
||||||
|
* npm package and serves plugin-only installs.
|
||||||
|
*
|
||||||
|
* Depends on: gsd-core/bin/lib/runtime-artifact-conversion.cjs (compiled from
|
||||||
|
* src/runtime-artifact-conversion.cts by `npm run build:lib`). Must run AFTER
|
||||||
|
* build:lib in the build chain.
|
||||||
|
*/
|
||||||
|
|
||||||
|
const fs = require('node:fs');
|
||||||
|
const path = require('node:path');
|
||||||
|
const { ExitError, runMain } = require('./lib/cli-exit.cjs');
|
||||||
|
|
||||||
|
const ROOT = path.resolve(__dirname, '..');
|
||||||
|
const COMMANDS_DIR = path.join(ROOT, 'commands', 'gsd');
|
||||||
|
const SKILLS_DIR = path.join(ROOT, 'skills');
|
||||||
|
const CONVERSION_MODULE = path.join(ROOT, 'gsd-core', 'bin', 'lib', 'runtime-artifact-conversion.cjs');
|
||||||
|
const PREFIX = 'gsd-';
|
||||||
|
const RUNTIME = 'claude';
|
||||||
|
|
||||||
|
function generateSkills(conversion) {
|
||||||
|
const cmdNames = conversion.readGsdCommandNames();
|
||||||
|
const files = fs.readdirSync(COMMANDS_DIR).filter(f => f.endsWith('.md'));
|
||||||
|
const results = [];
|
||||||
|
for (const file of files) {
|
||||||
|
const stem = file.slice(0, -3);
|
||||||
|
const skillName = PREFIX + stem;
|
||||||
|
const src = fs.readFileSync(path.join(COMMANDS_DIR, file), 'utf8');
|
||||||
|
const converted = conversion.convertClaudeCommandToClaudeSkill(src, skillName, RUNTIME, cmdNames, true);
|
||||||
|
results.push({ skillName, content: converted });
|
||||||
|
}
|
||||||
|
return results;
|
||||||
|
}
|
||||||
|
|
||||||
|
function main() {
|
||||||
|
const args = new Set(process.argv.slice(2));
|
||||||
|
const WRITE = args.has('--write');
|
||||||
|
const CHECK = args.has('--check');
|
||||||
|
|
||||||
|
if (!fs.existsSync(CONVERSION_MODULE)) {
|
||||||
|
throw new ExitError(
|
||||||
|
1,
|
||||||
|
`gen-plugin-skills: ${path.relative(ROOT, CONVERSION_MODULE)} not found.\n` +
|
||||||
|
'Run `npm run build:lib` first (this script depends on the compiled converter).'
|
||||||
|
);
|
||||||
|
}
|
||||||
|
const conversion = require(CONVERSION_MODULE);
|
||||||
|
const results = generateSkills(conversion);
|
||||||
|
|
||||||
|
if (WRITE) {
|
||||||
|
fs.rmSync(SKILLS_DIR, { recursive: true, force: true });
|
||||||
|
fs.mkdirSync(SKILLS_DIR, { recursive: true });
|
||||||
|
for (const { skillName, content } of results) {
|
||||||
|
const skillDir = path.join(SKILLS_DIR, skillName);
|
||||||
|
fs.mkdirSync(skillDir, { recursive: true });
|
||||||
|
fs.writeFileSync(path.join(skillDir, 'SKILL.md'), content);
|
||||||
|
}
|
||||||
|
process.stdout.write(`gen-plugin-skills: wrote ${results.length} skills to ${path.relative(ROOT, SKILLS_DIR)}/\n`);
|
||||||
|
return 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
if (CHECK) {
|
||||||
|
if (!fs.existsSync(SKILLS_DIR)) {
|
||||||
|
throw new ExitError(1, 'gen-plugin-skills: skills/ missing. Run: npm run gen:plugin-skills -- --write');
|
||||||
|
}
|
||||||
|
let stale = 0;
|
||||||
|
const expectedNames = new Set(results.map(r => r.skillName));
|
||||||
|
for (const { skillName, content } of results) {
|
||||||
|
const skillMd = path.join(SKILLS_DIR, skillName, 'SKILL.md');
|
||||||
|
if (!fs.existsSync(skillMd)) {
|
||||||
|
process.stderr.write(`gen-plugin-skills: missing ${path.relative(ROOT, skillMd)}\n`);
|
||||||
|
stale++;
|
||||||
|
continue;
|
||||||
|
}
|
||||||
|
if (fs.readFileSync(skillMd, 'utf8') !== content) {
|
||||||
|
process.stderr.write(`gen-plugin-skills: stale ${path.relative(ROOT, skillMd)}\n`);
|
||||||
|
stale++;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const existingDirs = fs.readdirSync(SKILLS_DIR, { withFileTypes: true })
|
||||||
|
.filter(e => e.isDirectory() && e.name.startsWith(PREFIX));
|
||||||
|
for (const dir of existingDirs) {
|
||||||
|
if (!expectedNames.has(dir.name)) {
|
||||||
|
process.stderr.write(`gen-plugin-skills: stale (no source) ${path.relative(ROOT, path.join(SKILLS_DIR, dir.name))}\n`);
|
||||||
|
stale++;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
if (stale > 0) {
|
||||||
|
throw new ExitError(1, `gen-plugin-skills: ${stale} stale skill(s). Run: npm run gen:plugin-skills -- --write`);
|
||||||
|
}
|
||||||
|
process.stdout.write(`gen-plugin-skills: ${results.length} skills up to date\n`);
|
||||||
|
return 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
process.stdout.write(
|
||||||
|
`gen-plugin-skills: would write ${results.length} skills to ${path.relative(ROOT, SKILLS_DIR)}/\n` +
|
||||||
|
' (use --write to generate, --check to verify staleness)\n'
|
||||||
|
);
|
||||||
|
return 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
runMain(main);
|
||||||
38
skills/gsd-add-tests/SKILL.md
Normal file
38
skills/gsd-add-tests/SKILL.md
Normal file
@@ -0,0 +1,38 @@
|
|||||||
|
---
|
||||||
|
name: gsd-add-tests
|
||||||
|
description: "Generate tests for a completed phase based on UAT criteria and implementation"
|
||||||
|
argument-hint: "<phase> [additional instructions]"
|
||||||
|
allowed-tools:
|
||||||
|
- Read
|
||||||
|
- Write
|
||||||
|
- Edit
|
||||||
|
- Bash
|
||||||
|
- Glob
|
||||||
|
- Grep
|
||||||
|
- Agent
|
||||||
|
- AskUserQuestion
|
||||||
|
---
|
||||||
|
|
||||||
|
<objective>
|
||||||
|
Generate unit and E2E tests for a completed phase, using its SUMMARY.md, CONTEXT.md, and VERIFICATION.md as specifications.
|
||||||
|
|
||||||
|
Analyzes implementation files, classifies them into TDD (unit), E2E (browser), or Skip categories, presents a test plan for user approval, then generates tests following RED-GREEN conventions.
|
||||||
|
|
||||||
|
Output: Test files committed with message `test(phase-{N}): add unit and E2E tests from add-tests command`
|
||||||
|
</objective>
|
||||||
|
|
||||||
|
<execution_context>
|
||||||
|
@~/.claude/gsd-core/workflows/add-tests.md
|
||||||
|
</execution_context>
|
||||||
|
|
||||||
|
<context>
|
||||||
|
Phase: $ARGUMENTS
|
||||||
|
|
||||||
|
@.planning/STATE.md
|
||||||
|
@.planning/ROADMAP.md
|
||||||
|
</context>
|
||||||
|
|
||||||
|
<process>
|
||||||
|
Execute end-to-end.
|
||||||
|
Preserve all workflow gates (classification approval, test plan approval, RED-GREEN verification, gap reporting).
|
||||||
|
</process>
|
||||||
37
skills/gsd-ai-integration-phase/SKILL.md
Normal file
37
skills/gsd-ai-integration-phase/SKILL.md
Normal file
@@ -0,0 +1,37 @@
|
|||||||
|
---
|
||||||
|
name: gsd-ai-integration-phase
|
||||||
|
description: "Generate an AI-SPEC.md design contract for phases that involve building AI systems."
|
||||||
|
argument-hint: "[phase number]"
|
||||||
|
allowed-tools:
|
||||||
|
- Read
|
||||||
|
- Write
|
||||||
|
- Bash
|
||||||
|
- Glob
|
||||||
|
- Grep
|
||||||
|
- Agent
|
||||||
|
- WebFetch
|
||||||
|
- WebSearch
|
||||||
|
- AskUserQuestion
|
||||||
|
- mcp__context7__*
|
||||||
|
---
|
||||||
|
|
||||||
|
<objective>
|
||||||
|
Create an AI design contract (AI-SPEC.md) for a phase involving AI system development.
|
||||||
|
Orchestrates gsd-framework-selector → gsd-ai-researcher → gsd-domain-researcher → gsd-eval-planner.
|
||||||
|
Flow: Select Framework → Research Docs → Research Domain → Design Eval Strategy → Done
|
||||||
|
</objective>
|
||||||
|
|
||||||
|
<execution_context>
|
||||||
|
@~/.claude/gsd-core/workflows/ai-integration-phase.md
|
||||||
|
@~/.claude/gsd-core/references/ai-frameworks.md
|
||||||
|
@~/.claude/gsd-core/references/ai-evals.md
|
||||||
|
</execution_context>
|
||||||
|
|
||||||
|
<context>
|
||||||
|
Phase number: $ARGUMENTS — optional, auto-detects next unplanned phase if omitted.
|
||||||
|
</context>
|
||||||
|
|
||||||
|
<process>
|
||||||
|
Execute end-to-end.
|
||||||
|
Preserve all workflow gates.
|
||||||
|
</process>
|
||||||
33
skills/gsd-audit-fix/SKILL.md
Normal file
33
skills/gsd-audit-fix/SKILL.md
Normal file
@@ -0,0 +1,33 @@
|
|||||||
|
---
|
||||||
|
name: gsd-audit-fix
|
||||||
|
description: "Autonomous audit-to-fix pipeline — find issues, classify, fix, test, commit"
|
||||||
|
argument-hint: "--source <audit-uat> [--severity <medium|high|all>] [--max N] [--dry-run]"
|
||||||
|
allowed-tools:
|
||||||
|
- Read
|
||||||
|
- Write
|
||||||
|
- Edit
|
||||||
|
- Bash
|
||||||
|
- Grep
|
||||||
|
- Glob
|
||||||
|
- Agent
|
||||||
|
- AskUserQuestion
|
||||||
|
---
|
||||||
|
|
||||||
|
<objective>
|
||||||
|
Run an audit, classify findings as auto-fixable vs manual-only, then autonomously fix
|
||||||
|
auto-fixable issues with test verification and atomic commits.
|
||||||
|
|
||||||
|
Flags:
|
||||||
|
- `--max N` — maximum findings to fix (default: 5)
|
||||||
|
- `--severity high|medium|all` — minimum severity to process (default: medium)
|
||||||
|
- `--dry-run` — classify findings without fixing (shows classification table)
|
||||||
|
- `--source <audit>` — which audit to run (default: audit-uat)
|
||||||
|
</objective>
|
||||||
|
|
||||||
|
<execution_context>
|
||||||
|
@~/.claude/gsd-core/workflows/audit-fix.md
|
||||||
|
</execution_context>
|
||||||
|
|
||||||
|
<process>
|
||||||
|
Execute end-to-end.
|
||||||
|
</process>
|
||||||
37
skills/gsd-audit-milestone/SKILL.md
Normal file
37
skills/gsd-audit-milestone/SKILL.md
Normal file
@@ -0,0 +1,37 @@
|
|||||||
|
---
|
||||||
|
name: gsd-audit-milestone
|
||||||
|
description: "Audit milestone completion against original intent before archiving"
|
||||||
|
argument-hint: "[version]"
|
||||||
|
allowed-tools:
|
||||||
|
- Read
|
||||||
|
- Glob
|
||||||
|
- Grep
|
||||||
|
- Bash
|
||||||
|
- Agent
|
||||||
|
- Write
|
||||||
|
---
|
||||||
|
|
||||||
|
<objective>
|
||||||
|
Verify milestone achieved its definition of done. Check requirements coverage, cross-phase integration, and end-to-end flows.
|
||||||
|
|
||||||
|
**This command IS the orchestrator.** Reads existing VERIFICATION.md files (phases already verified during execute-phase), aggregates tech debt and deferred gaps, then spawns integration checker for cross-phase wiring.
|
||||||
|
</objective>
|
||||||
|
|
||||||
|
<execution_context>
|
||||||
|
@~/.claude/gsd-core/workflows/audit-milestone.md
|
||||||
|
</execution_context>
|
||||||
|
|
||||||
|
<context>
|
||||||
|
Version: $ARGUMENTS (optional — defaults to current milestone)
|
||||||
|
|
||||||
|
Core planning files are resolved in-workflow (`init milestone-op`) and loaded only as needed.
|
||||||
|
|
||||||
|
**Completed Work:**
|
||||||
|
Glob: .planning/phases/*/*-SUMMARY.md
|
||||||
|
Glob: .planning/phases/*/*-VERIFICATION.md
|
||||||
|
</context>
|
||||||
|
|
||||||
|
<process>
|
||||||
|
Execute end-to-end.
|
||||||
|
Preserve all workflow gates (scope determination, verification reading, integration check, requirements coverage, routing).
|
||||||
|
</process>
|
||||||
25
skills/gsd-audit-uat/SKILL.md
Normal file
25
skills/gsd-audit-uat/SKILL.md
Normal file
@@ -0,0 +1,25 @@
|
|||||||
|
---
|
||||||
|
name: gsd-audit-uat
|
||||||
|
description: "Cross-phase audit of all outstanding UAT and verification items"
|
||||||
|
allowed-tools:
|
||||||
|
- Read
|
||||||
|
- Glob
|
||||||
|
- Grep
|
||||||
|
- Bash
|
||||||
|
---
|
||||||
|
|
||||||
|
<objective>
|
||||||
|
Scan all phases for pending, skipped, blocked, and human_needed UAT items. Cross-reference against codebase to detect stale documentation. Produce prioritized human test plan.
|
||||||
|
</objective>
|
||||||
|
|
||||||
|
<execution_context>
|
||||||
|
@~/.claude/gsd-core/workflows/audit-uat.md
|
||||||
|
</execution_context>
|
||||||
|
|
||||||
|
<context>
|
||||||
|
Core planning files are loaded in-workflow via CLI.
|
||||||
|
|
||||||
|
**Scope:**
|
||||||
|
Glob: .planning/phases/*/*-UAT.md
|
||||||
|
Glob: .planning/phases/*/*-VERIFICATION.md
|
||||||
|
</context>
|
||||||
51
skills/gsd-autonomous/SKILL.md
Normal file
51
skills/gsd-autonomous/SKILL.md
Normal file
@@ -0,0 +1,51 @@
|
|||||||
|
---
|
||||||
|
name: gsd-autonomous
|
||||||
|
description: "Run all remaining phases autonomously — discuss→plan→execute per phase"
|
||||||
|
argument-hint: "[--from N] [--to N] [--only N] [--interactive] [--converge]"
|
||||||
|
effort: max
|
||||||
|
allowed-tools:
|
||||||
|
- Read
|
||||||
|
- Write
|
||||||
|
- Bash
|
||||||
|
- Glob
|
||||||
|
- Grep
|
||||||
|
- AskUserQuestion
|
||||||
|
- Agent
|
||||||
|
---
|
||||||
|
|
||||||
|
<objective>
|
||||||
|
Execute all remaining milestone phases autonomously. For each phase: discuss → plan → execute. Pauses only for user decisions (grey area acceptance, blockers, validation requests).
|
||||||
|
|
||||||
|
Uses ROADMAP.md phase discovery and Skill() flat invocations for each phase command. After all phases complete: milestone audit → complete → cleanup.
|
||||||
|
|
||||||
|
**Creates/Updates:**
|
||||||
|
- `.planning/STATE.md` — updated after each phase
|
||||||
|
- `.planning/ROADMAP.md` — progress updated after each phase
|
||||||
|
- Phase artifacts — CONTEXT.md, PLANs, SUMMARYs per phase
|
||||||
|
|
||||||
|
**After:** Milestone is complete and cleaned up.
|
||||||
|
</objective>
|
||||||
|
|
||||||
|
<execution_context>
|
||||||
|
@~/.claude/gsd-core/workflows/autonomous.md
|
||||||
|
@~/.claude/gsd-core/references/ui-brand.md
|
||||||
|
</execution_context>
|
||||||
|
|
||||||
|
<context>
|
||||||
|
Optional flags:
|
||||||
|
- `--from N` — start from phase N instead of the first incomplete phase.
|
||||||
|
- `--to N` — stop after phase N completes (halt instead of advancing to next phase).
|
||||||
|
- `--only N` — execute only phase N (single-phase mode).
|
||||||
|
- `--interactive` — run discuss inline with questions (not auto-answered), then dispatch plan→execute as background agents. Keeps the main context lean while preserving user input on decisions.
|
||||||
|
- `--converge` — run each phase's planning step through `gsd-plan-review-convergence` instead of plain `gsd-plan-phase`. Requires `workflow.plan_review_convergence=true`.
|
||||||
|
- `--cross-ai` — compatibility alias for `--converge`.
|
||||||
|
|
||||||
|
When `--converge` or `--cross-ai` is set, reviewer selector flags supported by `gsd-plan-review-convergence` may be passed through: `--codex`, `--gemini`, `--claude`, `--opencode`, `--ollama`, `--lm-studio`, `--llama-cpp`, `--all`, and `--max-cycles N`.
|
||||||
|
|
||||||
|
Project context, phase list, and state are resolved inside the workflow using init commands (`gsd-tools query init.milestone-op`, `gsd-tools query roadmap.analyze`). No upfront context loading needed.
|
||||||
|
</context>
|
||||||
|
|
||||||
|
<process>
|
||||||
|
Execute end-to-end.
|
||||||
|
Preserve all workflow gates (phase discovery, per-phase execution, blocker handling, progress display).
|
||||||
|
</process>
|
||||||
67
skills/gsd-capture/SKILL.md
Normal file
67
skills/gsd-capture/SKILL.md
Normal file
@@ -0,0 +1,67 @@
|
|||||||
|
---
|
||||||
|
name: gsd-capture
|
||||||
|
description: "Capture ideas, tasks, notes, and seeds to their destination"
|
||||||
|
argument-hint: "[--note | --backlog | --seed | --list | --list-seeds] [text]"
|
||||||
|
allowed-tools:
|
||||||
|
- Read
|
||||||
|
- Write
|
||||||
|
- Edit
|
||||||
|
- Bash
|
||||||
|
- Glob
|
||||||
|
- Grep
|
||||||
|
- AskUserQuestion
|
||||||
|
---
|
||||||
|
|
||||||
|
|
||||||
|
<objective>
|
||||||
|
Capture ideas, tasks, notes, and seeds to their appropriate destination in the GSD system.
|
||||||
|
|
||||||
|
Mode routing:
|
||||||
|
- **default** (no flag): Capture as a structured todo for later work → add-todo workflow
|
||||||
|
- **--note**: Zero-friction idea capture (append/list/promote) → note workflow
|
||||||
|
- **--backlog**: Add an idea to the backlog parking lot (999.x numbering) → add-backlog workflow
|
||||||
|
- **--seed**: Capture a forward-looking idea with trigger conditions → plant-seed workflow
|
||||||
|
- **--list**: List pending todos and select one to work on → check-todos workflow
|
||||||
|
- **--list-seeds**: List/audit captured seeds (optional status filter) → list-seeds workflow
|
||||||
|
</objective>
|
||||||
|
|
||||||
|
<routing>
|
||||||
|
|
||||||
|
| Flag | Destination | Workflow |
|
||||||
|
|------|-------------|----------|
|
||||||
|
| (none) | Structured todo in .planning/todos/ | add-todo |
|
||||||
|
| --note | Timestamped note file, list, or promote | note |
|
||||||
|
| --backlog | ROADMAP.md backlog section (999.x) | add-backlog |
|
||||||
|
| --seed | .planning/seeds/SEED-NNN-slug.md | plant-seed |
|
||||||
|
| --list | Interactive todo browser + action router | check-todos |
|
||||||
|
| --list-seeds | Read-only seed list/audit (optional status filter) | list-seeds |
|
||||||
|
|
||||||
|
</routing>
|
||||||
|
|
||||||
|
<execution_context>
|
||||||
|
@~/.claude/gsd-core/workflows/add-todo.md
|
||||||
|
@~/.claude/gsd-core/workflows/note.md
|
||||||
|
@~/.claude/gsd-core/workflows/add-backlog.md
|
||||||
|
@~/.claude/gsd-core/workflows/plant-seed.md
|
||||||
|
@~/.claude/gsd-core/workflows/check-todos.md
|
||||||
|
@~/.claude/gsd-core/workflows/list-seeds.md
|
||||||
|
@~/.claude/gsd-core/references/ui-brand.md
|
||||||
|
</execution_context>
|
||||||
|
|
||||||
|
<context>
|
||||||
|
Arguments: $ARGUMENTS
|
||||||
|
|
||||||
|
Parse the first token of $ARGUMENTS:
|
||||||
|
- If it is `--note`: strip the flag, pass remainder to note workflow
|
||||||
|
- If it is `--backlog`: strip the flag, pass remainder to add-backlog workflow
|
||||||
|
- If it is `--seed`: strip the flag, pass remainder to plant-seed workflow
|
||||||
|
- If it is `--list-seeds`: strip the flag, pass remainder (optional status filter) to list-seeds workflow
|
||||||
|
- If it is `--list`: pass remainder (optional area filter) to check-todos workflow
|
||||||
|
- Otherwise: pass all of $ARGUMENTS to add-todo workflow
|
||||||
|
</context>
|
||||||
|
|
||||||
|
<process>
|
||||||
|
1. Parse the leading flag (if any) from $ARGUMENTS.
|
||||||
|
2. Load and execute the appropriate workflow end-to-end based on the routing table above.
|
||||||
|
3. Preserve all workflow gates from the target workflow (directory structure, duplicate detection, commits, etc.).
|
||||||
|
</process>
|
||||||
24
skills/gsd-cleanup/SKILL.md
Normal file
24
skills/gsd-cleanup/SKILL.md
Normal file
@@ -0,0 +1,24 @@
|
|||||||
|
---
|
||||||
|
name: gsd-cleanup
|
||||||
|
description: "Archive accumulated phase directories from completed milestones"
|
||||||
|
allowed-tools:
|
||||||
|
- Read
|
||||||
|
- Write
|
||||||
|
- Bash
|
||||||
|
- AskUserQuestion
|
||||||
|
---
|
||||||
|
|
||||||
|
<objective>
|
||||||
|
Archive phase directories from completed milestones into `.planning/milestones/v{X.Y}-phases/`.
|
||||||
|
|
||||||
|
Use when `.planning/phases/` has accumulated directories from past milestones.
|
||||||
|
</objective>
|
||||||
|
|
||||||
|
<execution_context>
|
||||||
|
@~/.claude/gsd-core/workflows/cleanup.md
|
||||||
|
</execution_context>
|
||||||
|
|
||||||
|
<process>
|
||||||
|
Execute end-to-end.
|
||||||
|
Identify completed milestones, show a dry-run summary, and archive on confirmation.
|
||||||
|
</process>
|
||||||
59
skills/gsd-code-review/SKILL.md
Normal file
59
skills/gsd-code-review/SKILL.md
Normal file
@@ -0,0 +1,59 @@
|
|||||||
|
---
|
||||||
|
name: gsd-code-review
|
||||||
|
description: "Review source files changed during a phase for bugs, security issues, and code quality problems"
|
||||||
|
argument-hint: "<phase-number> [--depth=quick|standard|deep] [--files file1,file2,...] [--fix [--all] [--auto]]"
|
||||||
|
allowed-tools:
|
||||||
|
- Read
|
||||||
|
- Bash
|
||||||
|
- Glob
|
||||||
|
- Grep
|
||||||
|
- Write
|
||||||
|
- Agent
|
||||||
|
---
|
||||||
|
|
||||||
|
<objective>
|
||||||
|
Review source files changed during a phase for bugs, security vulnerabilities, and code quality problems.
|
||||||
|
|
||||||
|
Spawns the gsd-code-reviewer agent to analyze code at the specified depth level. Produces REVIEW.md artifact in the phase directory with severity-classified findings.
|
||||||
|
|
||||||
|
Arguments:
|
||||||
|
- Phase number (required) — which phase's changes to review (e.g., "2" or "02")
|
||||||
|
- `--depth=quick|standard|deep` (optional) — review depth level, overrides workflow.code_review_depth config
|
||||||
|
- quick: Pattern-matching only (~2 min)
|
||||||
|
- standard: Per-file analysis with language-specific checks (~5-15 min, default)
|
||||||
|
- deep: Cross-file analysis including import graphs and call chains (~15-30 min)
|
||||||
|
- `--files file1,file2,...` (optional) — explicit comma-separated file list, skips SUMMARY/git scoping (highest precedence for scoping)
|
||||||
|
- `--fix` (optional) — after review completes (or if REVIEW.md already exists), auto-apply fixes found. Spawns gsd-code-fixer agent. Accepts sub-flags:
|
||||||
|
- `--all` — include Info findings in fix scope (default: Critical + Warning only)
|
||||||
|
- `--auto` — enable fix + re-review iteration loop, capped at 3 iterations
|
||||||
|
|
||||||
|
Output: {padded_phase}-REVIEW.md in phase directory + inline summary of findings
|
||||||
|
</objective>
|
||||||
|
|
||||||
|
<execution_context>
|
||||||
|
@~/.claude/gsd-core/workflows/code-review.md
|
||||||
|
</execution_context>
|
||||||
|
|
||||||
|
<context>
|
||||||
|
Phase: $ARGUMENTS (first positional argument is phase number)
|
||||||
|
|
||||||
|
Optional flags parsed from $ARGUMENTS:
|
||||||
|
- `--depth=VALUE` — Depth override (quick|standard|deep). If provided, overrides workflow.code_review_depth config.
|
||||||
|
- `--files=file1,file2,...` — Explicit file list override. Has highest precedence for file scoping per D-08. When provided, workflow skips SUMMARY.md extraction and git diff fallback entirely.
|
||||||
|
|
||||||
|
Context files (CLAUDE.md, SUMMARY.md, phase state) are resolved inside the workflow via `gsd-tools query init.phase-op` and delegated to agent via `<files_to_read>` blocks.
|
||||||
|
</context>
|
||||||
|
|
||||||
|
<process>
|
||||||
|
This command is a thin dispatch layer. It parses arguments and delegates to the workflow.
|
||||||
|
|
||||||
|
Execute end-to-end.
|
||||||
|
|
||||||
|
The workflow (not this command) enforces these gates:
|
||||||
|
- Phase validation (before config gate)
|
||||||
|
- Config gate check (workflow.code_review)
|
||||||
|
- File scoping (--files override > SUMMARY.md > git diff fallback)
|
||||||
|
- Empty scope check (skip if no files)
|
||||||
|
- Agent spawning (gsd-code-reviewer)
|
||||||
|
- Result presentation (inline summary + next steps)
|
||||||
|
</process>
|
||||||
142
skills/gsd-complete-milestone/SKILL.md
Normal file
142
skills/gsd-complete-milestone/SKILL.md
Normal file
@@ -0,0 +1,142 @@
|
|||||||
|
---
|
||||||
|
name: gsd-complete-milestone
|
||||||
|
description: "Archive completed milestone and prepare for next version"
|
||||||
|
argument-hint: "<version>"
|
||||||
|
allowed-tools:
|
||||||
|
- Read
|
||||||
|
- Write
|
||||||
|
- Bash
|
||||||
|
---
|
||||||
|
|
||||||
|
|
||||||
|
<objective>
|
||||||
|
Mark milestone {{version}} complete, archive to milestones/, and update ROADMAP.md and REQUIREMENTS.md.
|
||||||
|
|
||||||
|
Purpose: Create historical record of shipped version, archive milestone artifacts (roadmap + requirements), and prepare for next milestone.
|
||||||
|
Output: Milestone archived (roadmap + requirements), PROJECT.md evolved, git tagged.
|
||||||
|
</objective>
|
||||||
|
|
||||||
|
<execution_context>
|
||||||
|
**Load these files NOW (before proceeding):**
|
||||||
|
|
||||||
|
- @~/.claude/gsd-core/workflows/complete-milestone.md (main workflow)
|
||||||
|
- @~/.claude/gsd-core/templates/milestone-archive.md (archive template)
|
||||||
|
</execution_context>
|
||||||
|
|
||||||
|
<context>
|
||||||
|
**Project files:**
|
||||||
|
- `.planning/ROADMAP.md`
|
||||||
|
- `.planning/REQUIREMENTS.md`
|
||||||
|
- `.planning/STATE.md`
|
||||||
|
- `.planning/PROJECT.md`
|
||||||
|
|
||||||
|
**User input:**
|
||||||
|
|
||||||
|
- Version: {{version}} (e.g., "1.0", "1.1", "2.0")
|
||||||
|
</context>
|
||||||
|
|
||||||
|
<process>
|
||||||
|
|
||||||
|
**Follow complete-milestone.md workflow:**
|
||||||
|
|
||||||
|
0. **Check for audit:**
|
||||||
|
|
||||||
|
- Look for `.planning/v{{version}}-MILESTONE-AUDIT.md`
|
||||||
|
- If missing or stale: recommend `/gsd-audit-milestone` first
|
||||||
|
- If audit status is `gaps_found`: recommend closing the gaps inline
|
||||||
|
(the audit output already enumerates them — insert closure phases
|
||||||
|
via `/gsd-phase --insert <N>` plus the standard
|
||||||
|
discuss/plan/execute chain) before proceeding.
|
||||||
|
- If audit status is `passed`: proceed to step 1
|
||||||
|
|
||||||
|
```markdown
|
||||||
|
## Pre-flight Check
|
||||||
|
|
||||||
|
{If no v{{version}}-MILESTONE-AUDIT.md:}
|
||||||
|
⚠ No milestone audit found. Run `/gsd-audit-milestone` first to verify
|
||||||
|
requirements coverage, cross-phase integration, and E2E flows.
|
||||||
|
|
||||||
|
{If audit has gaps:}
|
||||||
|
⚠ Milestone audit found gaps. The audit output already enumerates the
|
||||||
|
unsatisfied requirements, cross-phase issues, and broken flows — insert
|
||||||
|
a closure phase per gap with `/gsd-phase --insert <N>` and run the
|
||||||
|
standard `/gsd-discuss-phase` → `/gsd-plan-phase` → `/gsd-execute-phase`
|
||||||
|
chain. Or proceed anyway to accept the gaps as tech debt.
|
||||||
|
|
||||||
|
{If audit passed:}
|
||||||
|
✓ Milestone audit passed. Proceeding with completion.
|
||||||
|
```
|
||||||
|
|
||||||
|
1. **Verify readiness:**
|
||||||
|
|
||||||
|
- Check all phases in milestone have completed plans (SUMMARY.md exists)
|
||||||
|
- Present milestone scope and stats
|
||||||
|
- Wait for confirmation
|
||||||
|
|
||||||
|
2. **Gather stats:**
|
||||||
|
|
||||||
|
- Count phases, plans, tasks
|
||||||
|
- Calculate git range, file changes, LOC
|
||||||
|
- Extract timeline from git log
|
||||||
|
- Present summary, confirm
|
||||||
|
|
||||||
|
3. **Extract accomplishments:**
|
||||||
|
|
||||||
|
- Read all phase SUMMARY.md files in milestone range
|
||||||
|
- Extract 4-6 key accomplishments
|
||||||
|
- Present for approval
|
||||||
|
|
||||||
|
4. **Archive milestone:**
|
||||||
|
|
||||||
|
- Create `.planning/milestones/v{{version}}-ROADMAP.md`
|
||||||
|
- Extract full phase details from ROADMAP.md
|
||||||
|
- Fill milestone-archive.md template
|
||||||
|
- Update ROADMAP.md to one-line summary with link
|
||||||
|
|
||||||
|
5. **Archive requirements:**
|
||||||
|
|
||||||
|
- Create `.planning/milestones/v{{version}}-REQUIREMENTS.md`
|
||||||
|
- Mark all v1 requirements as complete (checkboxes checked)
|
||||||
|
- Note requirement outcomes (validated, adjusted, dropped)
|
||||||
|
- Delete `.planning/REQUIREMENTS.md` (fresh one created for next milestone)
|
||||||
|
|
||||||
|
6. **Update PROJECT.md:**
|
||||||
|
|
||||||
|
- Add "Current State" section with shipped version
|
||||||
|
- Add "Next Milestone Goals" section
|
||||||
|
- Archive previous content in `<details>` (if v1.1+)
|
||||||
|
|
||||||
|
7. **Commit and tag:**
|
||||||
|
|
||||||
|
- Stage: MILESTONES.md, PROJECT.md, ROADMAP.md, STATE.md, archive files
|
||||||
|
- Commit: `chore: archive v{{version}} milestone`
|
||||||
|
- Tag: `git tag -a v{{version}} -m "[milestone summary]"`
|
||||||
|
- Ask about pushing tag
|
||||||
|
|
||||||
|
8. **Offer next steps:**
|
||||||
|
- `/gsd-new-milestone` — start next milestone (questioning → research → requirements → roadmap)
|
||||||
|
|
||||||
|
</process>
|
||||||
|
|
||||||
|
<success_criteria>
|
||||||
|
|
||||||
|
- Milestone archived to `.planning/milestones/v{{version}}-ROADMAP.md`
|
||||||
|
- Requirements archived to `.planning/milestones/v{{version}}-REQUIREMENTS.md`
|
||||||
|
- `.planning/REQUIREMENTS.md` deleted (fresh for next milestone)
|
||||||
|
- ROADMAP.md collapsed to one-line entry
|
||||||
|
- PROJECT.md updated with current state
|
||||||
|
- Git tag v{{version}} created (if `git.create_tag` enabled)
|
||||||
|
- Commit successful
|
||||||
|
- User knows next steps (including need for fresh requirements)
|
||||||
|
</success_criteria>
|
||||||
|
|
||||||
|
<critical_rules>
|
||||||
|
|
||||||
|
- **Load workflow first:** Read complete-milestone.md before executing
|
||||||
|
- **Verify completion:** All phases must have SUMMARY.md files
|
||||||
|
- **User confirmation:** Wait for approval at verification gates
|
||||||
|
- **Archive before deleting:** Always create archive files before updating/deleting originals
|
||||||
|
- **One-line summary:** Collapsed milestone in ROADMAP.md should be single line with link
|
||||||
|
- **Context efficiency:** Archive keeps ROADMAP.md and REQUIREMENTS.md constant size per milestone
|
||||||
|
- **Fresh requirements:** Next milestone starts with `/gsd-new-milestone` which includes requirements definition
|
||||||
|
</critical_rules>
|
||||||
56
skills/gsd-config/SKILL.md
Normal file
56
skills/gsd-config/SKILL.md
Normal file
@@ -0,0 +1,56 @@
|
|||||||
|
---
|
||||||
|
name: gsd-config
|
||||||
|
description: "Configure GSD settings — workflow toggles, advanced knobs, integrations, and model profile"
|
||||||
|
argument-hint: "[--advanced | --integrations | --profile <name>]"
|
||||||
|
allowed-tools:
|
||||||
|
- Read
|
||||||
|
- Write
|
||||||
|
- Bash
|
||||||
|
- AskUserQuestion
|
||||||
|
---
|
||||||
|
|
||||||
|
|
||||||
|
<objective>
|
||||||
|
Configure GSD settings interactively with a single consolidated command.
|
||||||
|
|
||||||
|
Mode routing:
|
||||||
|
- **default** (no flag): Common-case toggles (model, research, plan_check, verifier, branching) → settings workflow
|
||||||
|
- **--advanced**: Power-user knobs (planning tuning, timeouts, branch templates, cross-AI execution) → settings-advanced workflow
|
||||||
|
- **--integrations**: Third-party API keys, code-review CLI routing, agent-skill injection → settings-integrations workflow
|
||||||
|
- **--profile <name>**: Switch model profile (quality|balanced|budget|inherit) → set-profile (inline)
|
||||||
|
</objective>
|
||||||
|
|
||||||
|
<routing>
|
||||||
|
|
||||||
|
| Flag | Action | Workflow |
|
||||||
|
|------|--------|----------|
|
||||||
|
| (none) | Interactive 5-question common-case config prompt | settings |
|
||||||
|
| --advanced | Power-user knobs: planning, execution, discussion, cross-AI, git, runtime | settings-advanced |
|
||||||
|
| --integrations | API keys (Brave/Firecrawl/Exa), review CLI routing, agent skills | settings-integrations |
|
||||||
|
| --profile <name> | Switch model profile without interactive prompt | gsd-tools query config-set-model-profile |
|
||||||
|
|
||||||
|
</routing>
|
||||||
|
|
||||||
|
<execution_context>
|
||||||
|
@~/.claude/gsd-core/workflows/settings.md
|
||||||
|
@~/.claude/gsd-core/workflows/settings-advanced.md
|
||||||
|
@~/.claude/gsd-core/workflows/settings-integrations.md
|
||||||
|
</execution_context>
|
||||||
|
|
||||||
|
<context>
|
||||||
|
Arguments: $ARGUMENTS
|
||||||
|
|
||||||
|
Parse the first token of $ARGUMENTS:
|
||||||
|
- If it is `--advanced`: strip the flag, execute settings-advanced workflow
|
||||||
|
- If it is `--integrations`: strip the flag, execute settings-integrations workflow
|
||||||
|
- If it starts with `--profile`: extract the profile name (remainder after `--profile`), then:
|
||||||
|
1. Verify `gsd-tools` is on PATH via `command -v gsd-tools`; if absent, emit the install hint `Install GSD via 'npm i -g @opengsd/gsd-core'` and stop.
|
||||||
|
2. Run: `gsd-tools query config-set-model-profile <profile-name> --raw` and display the output verbatim.
|
||||||
|
- Otherwise: execute settings workflow (no argument needed)
|
||||||
|
</context>
|
||||||
|
|
||||||
|
<process>
|
||||||
|
1. Parse the leading flag (if any) from $ARGUMENTS.
|
||||||
|
2. Load and execute the appropriate workflow end-to-end, or run the inline SDK command for --profile.
|
||||||
|
3. Preserve all workflow gates from the target workflow.
|
||||||
|
</process>
|
||||||
53
skills/gsd-debug/SKILL.md
Normal file
53
skills/gsd-debug/SKILL.md
Normal file
@@ -0,0 +1,53 @@
|
|||||||
|
---
|
||||||
|
name: gsd-debug
|
||||||
|
description: "Systematic debugging with persistent state across context resets"
|
||||||
|
argument-hint: "[list | status <slug> | continue <slug> | --diagnose] [issue description]"
|
||||||
|
allowed-tools:
|
||||||
|
- Read
|
||||||
|
- Write
|
||||||
|
- Bash
|
||||||
|
- Agent
|
||||||
|
- AskUserQuestion
|
||||||
|
---
|
||||||
|
|
||||||
|
|
||||||
|
<objective>
|
||||||
|
Debug issues using scientific method with subagent isolation.
|
||||||
|
|
||||||
|
**Orchestrator role:** Gather symptoms, spawn gsd-debugger agent, handle checkpoints, spawn continuations.
|
||||||
|
|
||||||
|
**Flags:**
|
||||||
|
- `--diagnose` — Diagnose only. Returns a Root Cause Report without applying a fix.
|
||||||
|
|
||||||
|
**Subcommands:** `list` · `status <slug>` · `continue <slug>`
|
||||||
|
</objective>
|
||||||
|
|
||||||
|
<available_agent_types>
|
||||||
|
Valid GSD subagent types (use exact names — do not fall back to 'general-purpose'):
|
||||||
|
- gsd-debug-session-manager — manages debug checkpoint/continuation loop in isolated context
|
||||||
|
- gsd-debugger — investigates bugs using scientific method
|
||||||
|
</available_agent_types>
|
||||||
|
|
||||||
|
<execution_context>
|
||||||
|
@~/.claude/gsd-core/workflows/debug.md
|
||||||
|
</execution_context>
|
||||||
|
|
||||||
|
<context>
|
||||||
|
User's input: $ARGUMENTS
|
||||||
|
|
||||||
|
Parse subcommands and flags from $ARGUMENTS BEFORE the active-session check:
|
||||||
|
- If $ARGUMENTS starts with "list": SUBCMD=list, no further args
|
||||||
|
- If $ARGUMENTS starts with "status ": SUBCMD=status, SLUG=remainder (trim whitespace)
|
||||||
|
- If $ARGUMENTS starts with "continue ": SUBCMD=continue, SLUG=remainder (trim whitespace)
|
||||||
|
- If $ARGUMENTS contains `--diagnose`: SUBCMD=debug, diagnose_only=true, strip `--diagnose` from description
|
||||||
|
- Otherwise: SUBCMD=debug, diagnose_only=false
|
||||||
|
|
||||||
|
Check for active sessions (used for non-list/status/continue flows):
|
||||||
|
```bash
|
||||||
|
ls .planning/debug/*.md 2>/dev/null | grep -v resolved | head -5
|
||||||
|
```
|
||||||
|
</context>
|
||||||
|
|
||||||
|
<process>
|
||||||
|
Execute end-to-end.
|
||||||
|
</process>
|
||||||
77
skills/gsd-discuss-phase/SKILL.md
Normal file
77
skills/gsd-discuss-phase/SKILL.md
Normal file
@@ -0,0 +1,77 @@
|
|||||||
|
---
|
||||||
|
name: gsd-discuss-phase
|
||||||
|
description: "Gather phase context through adaptive questioning before planning."
|
||||||
|
argument-hint: "<phase> [--all] [--auto] [--chain] [--batch] [--analyze] [--text] [--power] [--assumptions]"
|
||||||
|
allowed-tools:
|
||||||
|
- Read
|
||||||
|
- Write
|
||||||
|
- Bash
|
||||||
|
- Glob
|
||||||
|
- Grep
|
||||||
|
- AskUserQuestion
|
||||||
|
- Agent
|
||||||
|
- mcp__context7__resolve-library-id
|
||||||
|
- mcp__context7__query-docs
|
||||||
|
---
|
||||||
|
|
||||||
|
|
||||||
|
<objective>
|
||||||
|
Extract implementation decisions that downstream agents need — researcher and planner will use CONTEXT.md to know what to investigate and what choices are locked.
|
||||||
|
|
||||||
|
**How it works:**
|
||||||
|
1. Load prior context (PROJECT.md, REQUIREMENTS.md, STATE.md, prior CONTEXT.md files)
|
||||||
|
2. Scout codebase for reusable assets and patterns
|
||||||
|
3. Analyze phase — skip gray areas already decided in prior phases
|
||||||
|
4. Present remaining gray areas — user selects which to discuss
|
||||||
|
5. Deep-dive each selected area until satisfied
|
||||||
|
6. Create CONTEXT.md with decisions that guide research and planning
|
||||||
|
|
||||||
|
**Output:** `{phase_num}-CONTEXT.md` — decisions clear enough that downstream agents can act without asking the user again
|
||||||
|
</objective>
|
||||||
|
|
||||||
|
<execution_context>
|
||||||
|
Workflow files are loaded on-demand in the <process> section below — not upfront.
|
||||||
|
Do not pre-load any workflow files before reading the mode routing instructions.
|
||||||
|
</execution_context>
|
||||||
|
|
||||||
|
<runtime_note>
|
||||||
|
**Copilot (VS Code):** Use `vscode_askquestions` wherever this workflow calls `AskUserQuestion`. They are equivalent — `vscode_askquestions` is the VS Code Copilot implementation of the same interactive question API.
|
||||||
|
</runtime_note>
|
||||||
|
|
||||||
|
<context>
|
||||||
|
Phase number: $ARGUMENTS (required)
|
||||||
|
|
||||||
|
Context files are resolved in-workflow using `init phase-op` and roadmap/state tool calls.
|
||||||
|
</context>
|
||||||
|
|
||||||
|
<process>
|
||||||
|
**Mode routing:**
|
||||||
|
```bash
|
||||||
|
_GSD_SHIM_NAME="gsd-tools.cjs"; _GSD_RUNTIME_ROOT="${RUNTIME_DIR:-$(git rev-parse --show-toplevel 2>/dev/null || pwd)}"; GSD_TOOLS="${_GSD_RUNTIME_ROOT}/gsd-core/bin/${_GSD_SHIM_NAME}"; if [ -f "$GSD_TOOLS" ]; then gsd_run() { node "$GSD_TOOLS" "$@"; }; elif [ -f "${_GSD_RUNTIME_ROOT}/.claude/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="${_GSD_RUNTIME_ROOT}/.claude/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; elif command -v gsd-tools >/dev/null 2>&1; then GSD_TOOLS="$(command -v gsd-tools)"; gsd_run() { "$GSD_TOOLS" "$@"; }; elif [ -f "$HOME/.claude/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="$HOME/.claude/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; else echo "ERROR: gsd-tools.cjs not found at $GSD_TOOLS and gsd-tools is not on PATH. Run: npx -y @opengsd/gsd-core@latest --claude --local" >&2; exit 1; fi
|
||||||
|
DISCUSS_MODE=$(gsd_run query config-get workflow.discuss_mode 2>/dev/null || echo "discuss")
|
||||||
|
```
|
||||||
|
|
||||||
|
If `--assumptions` is in $ARGUMENTS:
|
||||||
|
Read and execute `~/.claude/gsd-core/workflows/list-phase-assumptions.md` end-to-end.
|
||||||
|
Stop here.
|
||||||
|
|
||||||
|
Otherwise, if `DISCUSS_MODE` is `"assumptions"`:
|
||||||
|
Read and execute `~/.claude/gsd-core/workflows/discuss-phase-assumptions.md` end-to-end.
|
||||||
|
|
||||||
|
Otherwise (`"discuss"` / unset / any other value):
|
||||||
|
Read and execute `~/.claude/gsd-core/workflows/discuss-phase.md` end-to-end.
|
||||||
|
|
||||||
|
**MANDATORY:** Read the appropriate workflow file BEFORE taking any action. The objective and success_criteria sections in this command file are summaries — the workflow file contains the complete step-by-step process with all required behaviors, config checks, and interaction patterns. Do not improvise from the summary.
|
||||||
|
|
||||||
|
**Lazy loading:** `templates/context.md` is loaded inside the `write_context` step of the active workflow. `discuss-phase-power.md` is loaded inside `discuss-phase.md` when `--power` is detected. Do not load either here.
|
||||||
|
</process>
|
||||||
|
|
||||||
|
<success_criteria>
|
||||||
|
- Prior context loaded and applied (no re-asking decided questions)
|
||||||
|
- Gray areas identified through intelligent analysis
|
||||||
|
- User chose which areas to discuss
|
||||||
|
- Each selected area explored until satisfied
|
||||||
|
- Scope creep redirected to deferred ideas
|
||||||
|
- CONTEXT.md captures decisions, not vague vision
|
||||||
|
- User knows next steps
|
||||||
|
</success_criteria>
|
||||||
49
skills/gsd-docs-update/SKILL.md
Normal file
49
skills/gsd-docs-update/SKILL.md
Normal file
@@ -0,0 +1,49 @@
|
|||||||
|
---
|
||||||
|
name: gsd-docs-update
|
||||||
|
description: "Generate or update project documentation verified against the codebase"
|
||||||
|
argument-hint: "[--force] [--verify-only]"
|
||||||
|
allowed-tools:
|
||||||
|
- Read
|
||||||
|
- Write
|
||||||
|
- Edit
|
||||||
|
- Bash
|
||||||
|
- Glob
|
||||||
|
- Grep
|
||||||
|
- Agent
|
||||||
|
- AskUserQuestion
|
||||||
|
---
|
||||||
|
|
||||||
|
<objective>
|
||||||
|
Generate and update up to 9 documentation files for the current project. Each doc type is written by a gsd-doc-writer subagent that explores the codebase directly — no hallucinated paths, phantom endpoints, or stale signatures.
|
||||||
|
|
||||||
|
Flag handling rule:
|
||||||
|
- The optional flags documented below are available behaviors, not implied active behaviors
|
||||||
|
- A flag is active only when its literal token appears in `$ARGUMENTS`
|
||||||
|
- If a documented flag is absent from `$ARGUMENTS`, treat it as inactive
|
||||||
|
- `--force`: skip preservation prompts, regenerate all docs regardless of existing content or GSD markers
|
||||||
|
- `--verify-only`: check existing docs for accuracy against codebase, no generation (full verification requires Phase 4 verifier)
|
||||||
|
- If `--force` and `--verify-only` both appear in `$ARGUMENTS`, `--force` takes precedence
|
||||||
|
</objective>
|
||||||
|
|
||||||
|
<execution_context>
|
||||||
|
@~/.claude/gsd-core/workflows/docs-update.md
|
||||||
|
</execution_context>
|
||||||
|
|
||||||
|
<context>
|
||||||
|
Arguments: $ARGUMENTS
|
||||||
|
|
||||||
|
**Available optional flags (documentation only — not automatically active):**
|
||||||
|
- `--force` — Regenerate all docs. Overwrites hand-written and GSD docs alike. No preservation prompts.
|
||||||
|
- `--verify-only` — Check existing docs for accuracy against the codebase. No files are written. Reports VERIFY marker count. Full codebase fact-checking requires the gsd-doc-verifier agent (Phase 4).
|
||||||
|
|
||||||
|
**Active flags must be derived from `$ARGUMENTS`:**
|
||||||
|
- `--force` is active only if the literal `--force` token is present in `$ARGUMENTS`
|
||||||
|
- `--verify-only` is active only if the literal `--verify-only` token is present in `$ARGUMENTS`
|
||||||
|
- If neither token appears, run the standard full-phase generation flow
|
||||||
|
- Do not infer that a flag is active just because it is documented in this prompt
|
||||||
|
</context>
|
||||||
|
|
||||||
|
<process>
|
||||||
|
Execute end-to-end.
|
||||||
|
Preserve all workflow gates (preservation_check, flag handling, wave execution, monorepo dispatch, commit, reporting).
|
||||||
|
</process>
|
||||||
33
skills/gsd-eval-review/SKILL.md
Normal file
33
skills/gsd-eval-review/SKILL.md
Normal file
@@ -0,0 +1,33 @@
|
|||||||
|
---
|
||||||
|
name: gsd-eval-review
|
||||||
|
description: "Audit an executed AI phase's evaluation coverage and produce an EVAL-REVIEW.md remediation plan."
|
||||||
|
argument-hint: "[phase number]"
|
||||||
|
allowed-tools:
|
||||||
|
- Read
|
||||||
|
- Write
|
||||||
|
- Bash
|
||||||
|
- Glob
|
||||||
|
- Grep
|
||||||
|
- Agent
|
||||||
|
- AskUserQuestion
|
||||||
|
---
|
||||||
|
|
||||||
|
<objective>
|
||||||
|
Conduct a retroactive evaluation coverage audit of a completed AI phase.
|
||||||
|
Checks whether the evaluation strategy from AI-SPEC.md was implemented.
|
||||||
|
Produces EVAL-REVIEW.md with score, verdict, gaps, and remediation plan.
|
||||||
|
</objective>
|
||||||
|
|
||||||
|
<execution_context>
|
||||||
|
@~/.claude/gsd-core/workflows/eval-review.md
|
||||||
|
@~/.claude/gsd-core/references/ai-evals.md
|
||||||
|
</execution_context>
|
||||||
|
|
||||||
|
<context>
|
||||||
|
Phase: $ARGUMENTS — optional, defaults to last completed phase.
|
||||||
|
</context>
|
||||||
|
|
||||||
|
<process>
|
||||||
|
Execute end-to-end.
|
||||||
|
Preserve all workflow gates.
|
||||||
|
</process>
|
||||||
65
skills/gsd-execute-phase/SKILL.md
Normal file
65
skills/gsd-execute-phase/SKILL.md
Normal file
@@ -0,0 +1,65 @@
|
|||||||
|
---
|
||||||
|
name: gsd-execute-phase
|
||||||
|
description: "Execute all plans in a phase with wave-based parallelization"
|
||||||
|
argument-hint: "<phase-number> [--wave N] [--gaps-only] [--interactive] [--tdd]"
|
||||||
|
effort: max
|
||||||
|
allowed-tools:
|
||||||
|
- Read
|
||||||
|
- Write
|
||||||
|
- Edit
|
||||||
|
- Glob
|
||||||
|
- Grep
|
||||||
|
- Bash
|
||||||
|
- Agent
|
||||||
|
- TodoWrite
|
||||||
|
- AskUserQuestion
|
||||||
|
---
|
||||||
|
|
||||||
|
<objective>
|
||||||
|
Execute all plans in a phase using wave-based parallel execution.
|
||||||
|
|
||||||
|
Orchestrator stays lean: discover plans, analyze dependencies, group into waves, spawn subagents, collect results. Each subagent loads the full execute-plan context and handles its own plan.
|
||||||
|
|
||||||
|
Optional wave filter:
|
||||||
|
- `--wave N` executes only Wave `N` for pacing, quota management, or staged rollout
|
||||||
|
- phase verification/completion still only happens when no incomplete plans remain after the selected wave finishes
|
||||||
|
|
||||||
|
Flag handling rule:
|
||||||
|
- The optional flags documented below are available behaviors, not implied active behaviors
|
||||||
|
- A flag is active only when its literal token appears in `$ARGUMENTS`
|
||||||
|
- If a documented flag is absent from `$ARGUMENTS`, treat it as inactive
|
||||||
|
|
||||||
|
Context budget: ~15% orchestrator, 100% fresh per subagent.
|
||||||
|
</objective>
|
||||||
|
|
||||||
|
<execution_context>
|
||||||
|
@~/.claude/gsd-core/workflows/execute-phase.md
|
||||||
|
@~/.claude/gsd-core/references/ui-brand.md
|
||||||
|
</execution_context>
|
||||||
|
|
||||||
|
<runtime_note>
|
||||||
|
**Copilot (VS Code):** Use `vscode_askquestions` wherever this workflow calls `AskUserQuestion`. They are equivalent — `vscode_askquestions` is the VS Code Copilot implementation of the same interactive question API.
|
||||||
|
</runtime_note>
|
||||||
|
|
||||||
|
<context>
|
||||||
|
Phase: $ARGUMENTS
|
||||||
|
|
||||||
|
**Available optional flags (documentation only — not automatically active):**
|
||||||
|
- `--wave N` — Execute only Wave `N` in the phase. Use when you want to pace execution or stay inside usage limits.
|
||||||
|
- `--gaps-only` — Execute only gap closure plans (plans with `gap_closure: true` in frontmatter). Use after verify-work creates fix plans.
|
||||||
|
- `--interactive` — Execute plans sequentially inline (no subagents) with user checkpoints between tasks. Lower token usage, pair-programming style. Best for small phases, bug fixes, and verification gaps.
|
||||||
|
|
||||||
|
**Active flags must be derived from `$ARGUMENTS`:**
|
||||||
|
- `--wave N` is active only if the literal `--wave` token is present in `$ARGUMENTS`
|
||||||
|
- `--gaps-only` is active only if the literal `--gaps-only` token is present in `$ARGUMENTS`
|
||||||
|
- `--interactive` is active only if the literal `--interactive` token is present in `$ARGUMENTS`
|
||||||
|
- If none of these tokens appear, run the standard full-phase execution flow with no flag-specific filtering
|
||||||
|
- Do not infer that a flag is active just because it is documented in this prompt
|
||||||
|
|
||||||
|
Context files are resolved inside the workflow via `gsd-tools query init.execute-phase` and per-subagent `<files_to_read>` blocks.
|
||||||
|
</context>
|
||||||
|
|
||||||
|
<process>
|
||||||
|
Execute end-to-end.
|
||||||
|
Preserve all workflow gates (wave execution, checkpoint handling, verification, state updates, routing).
|
||||||
|
</process>
|
||||||
28
skills/gsd-explore/SKILL.md
Normal file
28
skills/gsd-explore/SKILL.md
Normal file
@@ -0,0 +1,28 @@
|
|||||||
|
---
|
||||||
|
name: gsd-explore
|
||||||
|
description: "Socratic ideation and idea routing — think through ideas before committing to plans"
|
||||||
|
allowed-tools:
|
||||||
|
- Read
|
||||||
|
- Write
|
||||||
|
- Bash
|
||||||
|
- Grep
|
||||||
|
- Glob
|
||||||
|
- Agent
|
||||||
|
- AskUserQuestion
|
||||||
|
---
|
||||||
|
|
||||||
|
<objective>
|
||||||
|
Open-ended Socratic ideation session. Guides the developer through exploring an idea via
|
||||||
|
probing questions, optionally spawns research, then routes outputs to the appropriate GSD
|
||||||
|
artifacts (notes, todos, seeds, research questions, requirements, or new phases).
|
||||||
|
|
||||||
|
Accepts an optional topic argument: `/gsd-explore authentication strategy`
|
||||||
|
</objective>
|
||||||
|
|
||||||
|
<execution_context>
|
||||||
|
@~/.claude/gsd-core/workflows/explore.md
|
||||||
|
</execution_context>
|
||||||
|
|
||||||
|
<process>
|
||||||
|
Execute end-to-end.
|
||||||
|
</process>
|
||||||
22
skills/gsd-extract-learnings/SKILL.md
Normal file
22
skills/gsd-extract-learnings/SKILL.md
Normal file
@@ -0,0 +1,22 @@
|
|||||||
|
---
|
||||||
|
name: gsd-extract-learnings
|
||||||
|
description: "Extract decisions, lessons, patterns, and surprises from completed phase artifacts"
|
||||||
|
argument-hint: "<phase-number>"
|
||||||
|
allowed-tools:
|
||||||
|
- Read
|
||||||
|
- Write
|
||||||
|
- Bash
|
||||||
|
- Grep
|
||||||
|
- Glob
|
||||||
|
- Agent
|
||||||
|
---
|
||||||
|
|
||||||
|
<objective>
|
||||||
|
Extract structured learnings from completed phase artifacts (PLAN.md, SUMMARY.md, VERIFICATION.md, UAT.md, STATE.md) into a LEARNINGS.md file that captures decisions, lessons learned, patterns discovered, and surprises encountered.
|
||||||
|
</objective>
|
||||||
|
|
||||||
|
<execution_context>
|
||||||
|
@~/.claude/gsd-core/workflows/extract-learnings.md
|
||||||
|
</execution_context>
|
||||||
|
|
||||||
|
Execute the extract-learnings workflow from @~/.claude/gsd-core/workflows/extract-learnings.md end-to-end.
|
||||||
31
skills/gsd-fast/SKILL.md
Normal file
31
skills/gsd-fast/SKILL.md
Normal file
@@ -0,0 +1,31 @@
|
|||||||
|
---
|
||||||
|
name: gsd-fast
|
||||||
|
description: "Execute a trivial task inline — no subagents, no planning overhead"
|
||||||
|
argument-hint: "[task description]"
|
||||||
|
allowed-tools:
|
||||||
|
- Read
|
||||||
|
- Write
|
||||||
|
- Edit
|
||||||
|
- Bash
|
||||||
|
- Grep
|
||||||
|
- Glob
|
||||||
|
---
|
||||||
|
|
||||||
|
|
||||||
|
<objective>
|
||||||
|
Execute a trivial task directly in the current context without spawning subagents
|
||||||
|
or generating PLAN.md files. For tasks too small to justify planning overhead:
|
||||||
|
typo fixes, config changes, small refactors, forgotten commits, simple additions.
|
||||||
|
|
||||||
|
This is NOT a replacement for /gsd-quick — use /gsd-quick for anything that
|
||||||
|
needs research, multi-step planning, or verification. /gsd-fast is for tasks
|
||||||
|
you could describe in one sentence and execute in under 2 minutes.
|
||||||
|
</objective>
|
||||||
|
|
||||||
|
<execution_context>
|
||||||
|
@~/.claude/gsd-core/workflows/fast.md
|
||||||
|
</execution_context>
|
||||||
|
|
||||||
|
<process>
|
||||||
|
Execute end-to-end.
|
||||||
|
</process>
|
||||||
56
skills/gsd-forensics/SKILL.md
Normal file
56
skills/gsd-forensics/SKILL.md
Normal file
@@ -0,0 +1,56 @@
|
|||||||
|
---
|
||||||
|
name: gsd-forensics
|
||||||
|
description: "Post-mortem investigation for failed GSD workflows — diagnoses what went wrong."
|
||||||
|
argument-hint: "[problem description]"
|
||||||
|
allowed-tools:
|
||||||
|
- Read
|
||||||
|
- Write
|
||||||
|
- Bash
|
||||||
|
- Grep
|
||||||
|
- Glob
|
||||||
|
---
|
||||||
|
|
||||||
|
|
||||||
|
<objective>
|
||||||
|
Investigate what went wrong during a GSD workflow execution. Analyzes git history, `.planning/` artifacts, and file system state to detect anomalies and generate a structured diagnostic report.
|
||||||
|
|
||||||
|
Purpose: Diagnose failed or stuck workflows so the user can understand root cause and take corrective action.
|
||||||
|
Output: Forensic report saved to `.planning/forensics/`, presented inline, with optional issue creation.
|
||||||
|
</objective>
|
||||||
|
|
||||||
|
<execution_context>
|
||||||
|
@~/.claude/gsd-core/workflows/forensics.md
|
||||||
|
</execution_context>
|
||||||
|
|
||||||
|
<context>
|
||||||
|
**Data sources:**
|
||||||
|
- `git log` (recent commits, patterns, time gaps)
|
||||||
|
- `git status` / `git diff` (uncommitted work, conflicts)
|
||||||
|
- `.planning/STATE.md` (current position, session history)
|
||||||
|
- `.planning/ROADMAP.md` (phase scope and progress)
|
||||||
|
- `.planning/phases/*/` (PLAN.md, SUMMARY.md, VERIFICATION.md, CONTEXT.md)
|
||||||
|
- `.planning/reports/SESSION_REPORT.md` (last session outcomes)
|
||||||
|
|
||||||
|
**User input:**
|
||||||
|
- Problem description: $ARGUMENTS (optional — will ask if not provided)
|
||||||
|
</context>
|
||||||
|
|
||||||
|
<process>
|
||||||
|
Execute end-to-end.
|
||||||
|
</process>
|
||||||
|
|
||||||
|
<success_criteria>
|
||||||
|
- Evidence gathered from all available data sources
|
||||||
|
- At least 4 anomaly types checked (stuck loop, missing artifacts, abandoned work, crash/interruption)
|
||||||
|
- Structured forensic report written to `.planning/forensics/report-{timestamp}.md`
|
||||||
|
- Report presented inline with findings, anomalies, and recommendations
|
||||||
|
- Interactive investigation offered for deeper analysis
|
||||||
|
- GitHub issue creation offered if actionable findings exist
|
||||||
|
</success_criteria>
|
||||||
|
|
||||||
|
<critical_rules>
|
||||||
|
- **Read-only investigation:** Do not modify project source files during forensics. Only write the forensic report and update STATE.md session tracking.
|
||||||
|
- **Redact sensitive data:** Strip absolute paths, API keys, tokens from reports and issues.
|
||||||
|
- **Ground findings in evidence:** Every anomaly must cite specific commits, files, or state data.
|
||||||
|
- **No speculation without evidence:** If data is insufficient, say so — do not fabricate root causes.
|
||||||
|
</critical_rules>
|
||||||
204
skills/gsd-graphify/SKILL.md
Normal file
204
skills/gsd-graphify/SKILL.md
Normal file
@@ -0,0 +1,204 @@
|
|||||||
|
---
|
||||||
|
name: gsd-graphify
|
||||||
|
description: "Build, query, and inspect the project knowledge graph in .planning/graphs/"
|
||||||
|
argument-hint: "[build|query <term>|status|diff]"
|
||||||
|
allowed-tools:
|
||||||
|
- Read
|
||||||
|
- Bash
|
||||||
|
---
|
||||||
|
|
||||||
|
|
||||||
|
**STOP -- DO NOT READ THIS FILE. You are already reading it. This prompt was injected into your context by Claude Code's command system. Using the Read tool on this file wastes tokens. Begin executing Step 0 immediately.**
|
||||||
|
|
||||||
|
**CJS-only (graphify):** `graphify` subcommands are not registered on `gsd-tools query`. Use the `gsd_run` launcher shim (defined in each bash block below) or invoke the binary directly: `node <runtime-home>/gsd-core/bin/gsd-tools.cjs graphify …` where `<runtime-home>` is your runtime's config directory (e.g. `~/.claude`, `~/.hermes`, `~/.cursor`). See `docs/CLI-TOOLS.md` for details. Other tooling may still use `gsd-tools query` where a handler exists.
|
||||||
|
|
||||||
|
## Step 0 -- Banner
|
||||||
|
|
||||||
|
**Before ANY tool calls**, display this banner:
|
||||||
|
|
||||||
|
```
|
||||||
|
GSD > GRAPHIFY
|
||||||
|
```
|
||||||
|
|
||||||
|
Then proceed to Step 1.
|
||||||
|
|
||||||
|
## Step 1 -- Config Gate
|
||||||
|
|
||||||
|
Check if graphify is enabled by reading `.planning/config.json` directly using the Read tool.
|
||||||
|
|
||||||
|
**DO NOT use the gsd-tools config get-value command** -- it hard-exits on missing keys.
|
||||||
|
|
||||||
|
1. Read `.planning/config.json` using the Read tool
|
||||||
|
2. If the file does not exist: display the disabled message below and **STOP**
|
||||||
|
3. Parse the JSON content. Check if `config.graphify && config.graphify.enabled === true`
|
||||||
|
4. If `graphify.enabled` is NOT explicitly `true`: display the disabled message below and **STOP**
|
||||||
|
5. If `graphify.enabled` is `true`: proceed to Step 2
|
||||||
|
|
||||||
|
**Disabled message:**
|
||||||
|
|
||||||
|
```
|
||||||
|
GSD > GRAPHIFY
|
||||||
|
|
||||||
|
Knowledge graph is disabled. To activate:
|
||||||
|
|
||||||
|
node <runtime-home>/gsd-core/bin/gsd-tools.cjs config-set graphify.enabled true
|
||||||
|
|
||||||
|
Then run /gsd-graphify build to create the initial graph.
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Step 2 -- Parse Argument
|
||||||
|
|
||||||
|
Parse `$ARGUMENTS` to determine the operation mode:
|
||||||
|
|
||||||
|
| Argument | Action |
|
||||||
|
|----------|--------|
|
||||||
|
| `build` | Run inline build (Step 3) |
|
||||||
|
| `query <term>` | Run inline query (Step 2a) |
|
||||||
|
| `status` | Run inline status check (Step 2b) |
|
||||||
|
| `diff` | Run inline diff check (Step 2c) |
|
||||||
|
| No argument or unknown | Show usage message |
|
||||||
|
|
||||||
|
**Usage message** (shown when no argument or unrecognized argument):
|
||||||
|
|
||||||
|
```
|
||||||
|
GSD > GRAPHIFY
|
||||||
|
|
||||||
|
Usage: /gsd-graphify <mode>
|
||||||
|
|
||||||
|
Modes:
|
||||||
|
build Build or rebuild the knowledge graph
|
||||||
|
query <term> Search the graph for a term
|
||||||
|
status Show graph freshness and statistics
|
||||||
|
diff Show changes since last build
|
||||||
|
```
|
||||||
|
|
||||||
|
### Step 2a -- Query
|
||||||
|
|
||||||
|
Run:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
_GSD_SHIM_NAME="gsd-tools.cjs"; _GSD_RUNTIME_ROOT="${RUNTIME_DIR:-$(git rev-parse --show-toplevel 2>/dev/null || pwd)}"; GSD_TOOLS="${_GSD_RUNTIME_ROOT}/gsd-core/bin/${_GSD_SHIM_NAME}"; if [ -f "$GSD_TOOLS" ]; then gsd_run() { node "$GSD_TOOLS" "$@"; }; elif [ -f "${_GSD_RUNTIME_ROOT}/.claude/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="${_GSD_RUNTIME_ROOT}/.claude/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; elif command -v gsd-tools >/dev/null 2>&1; then GSD_TOOLS="$(command -v gsd-tools)"; gsd_run() { "$GSD_TOOLS" "$@"; }; elif [ -f "$HOME/.claude/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="$HOME/.claude/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; elif [ -f "${HERMES_HOME:-$HOME/.hermes}/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="${HERMES_HOME:-$HOME/.hermes}/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; elif [ -f "${CURSOR_CONFIG_DIR:-$HOME/.cursor}/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="${CURSOR_CONFIG_DIR:-$HOME/.cursor}/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; elif [ -f "${CODEX_HOME:-$HOME/.codex}/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="${CODEX_HOME:-$HOME/.codex}/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; elif [ -f "${GEMINI_CONFIG_DIR:-$HOME/.gemini}/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="${GEMINI_CONFIG_DIR:-$HOME/.gemini}/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; elif [ -f "${COPILOT_CONFIG_DIR:-$HOME/.copilot}/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="${COPILOT_CONFIG_DIR:-$HOME/.copilot}/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; elif [ -f "${WINDSURF_CONFIG_DIR:-$HOME/.codeium/windsurf}/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="${WINDSURF_CONFIG_DIR:-$HOME/.codeium/windsurf}/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; elif [ -f "${AUGMENT_CONFIG_DIR:-$HOME/.augment}/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="${AUGMENT_CONFIG_DIR:-$HOME/.augment}/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; elif [ -f "${TRAE_CONFIG_DIR:-$HOME/.trae}/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="${TRAE_CONFIG_DIR:-$HOME/.trae}/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; elif [ -f "${QWEN_CONFIG_DIR:-$HOME/.qwen}/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="${QWEN_CONFIG_DIR:-$HOME/.qwen}/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; elif [ -f "${CODEBUDDY_CONFIG_DIR:-$HOME/.codebuddy}/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="${CODEBUDDY_CONFIG_DIR:-$HOME/.codebuddy}/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; elif [ -f "${CLINE_CONFIG_DIR:-$HOME/.cline}/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="${CLINE_CONFIG_DIR:-$HOME/.cline}/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; elif [ -f "${GROK_AGENTS_HOME:-$HOME/.agents}/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="${GROK_AGENTS_HOME:-$HOME/.agents}/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; elif [ -f "${ANTIGRAVITY_CONFIG_DIR:-$HOME/.gemini/antigravity}/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="${ANTIGRAVITY_CONFIG_DIR:-$HOME/.gemini/antigravity}/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; elif [ -f "${OPENCODE_CONFIG_DIR:-${XDG_CONFIG_HOME:-$HOME/.config}/opencode}/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="${OPENCODE_CONFIG_DIR:-${XDG_CONFIG_HOME:-$HOME/.config}/opencode}/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; elif [ -f "${KILO_CONFIG_DIR:-${XDG_CONFIG_HOME:-$HOME/.config}/kilo}/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="${KILO_CONFIG_DIR:-${XDG_CONFIG_HOME:-$HOME/.config}/kilo}/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; else echo "ERROR: gsd-tools.cjs not found at $GSD_TOOLS and gsd-tools is not on PATH. Run: npx -y @opengsd/gsd-core@latest --claude --local" >&2; exit 1; fi
|
||||||
|
gsd_run graphify query <term>
|
||||||
|
```
|
||||||
|
|
||||||
|
Parse the JSON output and display results:
|
||||||
|
- If the output contains `"disabled": true`, display the disabled message from Step 1 and **STOP**
|
||||||
|
- If the output contains `"error"` field, display the error message and **STOP**
|
||||||
|
- If no nodes found, display: `No graph matches for '<term>'. Try /gsd-graphify build to create or rebuild the graph.`
|
||||||
|
- Otherwise, display matched nodes grouped by type, with edge relationships and confidence tiers (EXTRACTED/INFERRED/AMBIGUOUS)
|
||||||
|
|
||||||
|
**STOP** after displaying results. Do not spawn an agent.
|
||||||
|
|
||||||
|
### Step 2b -- Status
|
||||||
|
|
||||||
|
Run:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
_GSD_SHIM_NAME="gsd-tools.cjs"; _GSD_RUNTIME_ROOT="${RUNTIME_DIR:-$(git rev-parse --show-toplevel 2>/dev/null || pwd)}"; GSD_TOOLS="${_GSD_RUNTIME_ROOT}/gsd-core/bin/${_GSD_SHIM_NAME}"; if [ -f "$GSD_TOOLS" ]; then gsd_run() { node "$GSD_TOOLS" "$@"; }; elif [ -f "${_GSD_RUNTIME_ROOT}/.claude/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="${_GSD_RUNTIME_ROOT}/.claude/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; elif command -v gsd-tools >/dev/null 2>&1; then GSD_TOOLS="$(command -v gsd-tools)"; gsd_run() { "$GSD_TOOLS" "$@"; }; elif [ -f "$HOME/.claude/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="$HOME/.claude/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; elif [ -f "${HERMES_HOME:-$HOME/.hermes}/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="${HERMES_HOME:-$HOME/.hermes}/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; elif [ -f "${CURSOR_CONFIG_DIR:-$HOME/.cursor}/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="${CURSOR_CONFIG_DIR:-$HOME/.cursor}/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; elif [ -f "${CODEX_HOME:-$HOME/.codex}/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="${CODEX_HOME:-$HOME/.codex}/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; elif [ -f "${GEMINI_CONFIG_DIR:-$HOME/.gemini}/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="${GEMINI_CONFIG_DIR:-$HOME/.gemini}/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; elif [ -f "${COPILOT_CONFIG_DIR:-$HOME/.copilot}/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="${COPILOT_CONFIG_DIR:-$HOME/.copilot}/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; elif [ -f "${WINDSURF_CONFIG_DIR:-$HOME/.codeium/windsurf}/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="${WINDSURF_CONFIG_DIR:-$HOME/.codeium/windsurf}/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; elif [ -f "${AUGMENT_CONFIG_DIR:-$HOME/.augment}/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="${AUGMENT_CONFIG_DIR:-$HOME/.augment}/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; elif [ -f "${TRAE_CONFIG_DIR:-$HOME/.trae}/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="${TRAE_CONFIG_DIR:-$HOME/.trae}/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; elif [ -f "${QWEN_CONFIG_DIR:-$HOME/.qwen}/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="${QWEN_CONFIG_DIR:-$HOME/.qwen}/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; elif [ -f "${CODEBUDDY_CONFIG_DIR:-$HOME/.codebuddy}/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="${CODEBUDDY_CONFIG_DIR:-$HOME/.codebuddy}/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; elif [ -f "${CLINE_CONFIG_DIR:-$HOME/.cline}/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="${CLINE_CONFIG_DIR:-$HOME/.cline}/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; elif [ -f "${GROK_AGENTS_HOME:-$HOME/.agents}/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="${GROK_AGENTS_HOME:-$HOME/.agents}/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; elif [ -f "${ANTIGRAVITY_CONFIG_DIR:-$HOME/.gemini/antigravity}/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="${ANTIGRAVITY_CONFIG_DIR:-$HOME/.gemini/antigravity}/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; elif [ -f "${OPENCODE_CONFIG_DIR:-${XDG_CONFIG_HOME:-$HOME/.config}/opencode}/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="${OPENCODE_CONFIG_DIR:-${XDG_CONFIG_HOME:-$HOME/.config}/opencode}/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; elif [ -f "${KILO_CONFIG_DIR:-${XDG_CONFIG_HOME:-$HOME/.config}/kilo}/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="${KILO_CONFIG_DIR:-${XDG_CONFIG_HOME:-$HOME/.config}/kilo}/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; else echo "ERROR: gsd-tools.cjs not found at $GSD_TOOLS and gsd-tools is not on PATH. Run: npx -y @opengsd/gsd-core@latest --claude --local" >&2; exit 1; fi
|
||||||
|
gsd_run graphify status
|
||||||
|
```
|
||||||
|
|
||||||
|
Parse the JSON output and display:
|
||||||
|
- If `exists: false`, display the message field
|
||||||
|
- Otherwise show last build time, node/edge/hyperedge counts, and STALE or FRESH indicator
|
||||||
|
- If `built_at_commit` is non-null, also display a `Source commit:` line:
|
||||||
|
- `commit_stale === false` (rebuilt at HEAD): `Source commit: <built_at_commit> (current)`
|
||||||
|
- `commit_stale === true` (graph behind HEAD): `Source commit: <built_at_commit> (<commits_behind> commits behind HEAD)`
|
||||||
|
- `commit_stale === null` (unreachable commit / no git): `Source commit: <built_at_commit> (freshness unknown)`
|
||||||
|
- If `built_at_commit` is null (pre-graphify-v0.7 graph), omit the source-commit line entirely — do not render "Source commit: unknown"
|
||||||
|
|
||||||
|
The mtime-based STALE/FRESH flag and the commit-based `commit_stale` measure
|
||||||
|
different things and can disagree (e.g., a CI-built graph rebuilt minutes ago
|
||||||
|
against an old checkout reads as FRESH on mtime but `commit_stale: true`).
|
||||||
|
Surface both so the agent can choose.
|
||||||
|
|
||||||
|
**STOP** after displaying status. Do not spawn an agent.
|
||||||
|
|
||||||
|
### Step 2c -- Diff
|
||||||
|
|
||||||
|
Run:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
_GSD_SHIM_NAME="gsd-tools.cjs"; _GSD_RUNTIME_ROOT="${RUNTIME_DIR:-$(git rev-parse --show-toplevel 2>/dev/null || pwd)}"; GSD_TOOLS="${_GSD_RUNTIME_ROOT}/gsd-core/bin/${_GSD_SHIM_NAME}"; if [ -f "$GSD_TOOLS" ]; then gsd_run() { node "$GSD_TOOLS" "$@"; }; elif [ -f "${_GSD_RUNTIME_ROOT}/.claude/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="${_GSD_RUNTIME_ROOT}/.claude/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; elif command -v gsd-tools >/dev/null 2>&1; then GSD_TOOLS="$(command -v gsd-tools)"; gsd_run() { "$GSD_TOOLS" "$@"; }; elif [ -f "$HOME/.claude/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="$HOME/.claude/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; elif [ -f "${HERMES_HOME:-$HOME/.hermes}/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="${HERMES_HOME:-$HOME/.hermes}/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; elif [ -f "${CURSOR_CONFIG_DIR:-$HOME/.cursor}/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="${CURSOR_CONFIG_DIR:-$HOME/.cursor}/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; elif [ -f "${CODEX_HOME:-$HOME/.codex}/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="${CODEX_HOME:-$HOME/.codex}/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; elif [ -f "${GEMINI_CONFIG_DIR:-$HOME/.gemini}/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="${GEMINI_CONFIG_DIR:-$HOME/.gemini}/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; elif [ -f "${COPILOT_CONFIG_DIR:-$HOME/.copilot}/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="${COPILOT_CONFIG_DIR:-$HOME/.copilot}/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; elif [ -f "${WINDSURF_CONFIG_DIR:-$HOME/.codeium/windsurf}/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="${WINDSURF_CONFIG_DIR:-$HOME/.codeium/windsurf}/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; elif [ -f "${AUGMENT_CONFIG_DIR:-$HOME/.augment}/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="${AUGMENT_CONFIG_DIR:-$HOME/.augment}/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; elif [ -f "${TRAE_CONFIG_DIR:-$HOME/.trae}/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="${TRAE_CONFIG_DIR:-$HOME/.trae}/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; elif [ -f "${QWEN_CONFIG_DIR:-$HOME/.qwen}/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="${QWEN_CONFIG_DIR:-$HOME/.qwen}/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; elif [ -f "${CODEBUDDY_CONFIG_DIR:-$HOME/.codebuddy}/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="${CODEBUDDY_CONFIG_DIR:-$HOME/.codebuddy}/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; elif [ -f "${CLINE_CONFIG_DIR:-$HOME/.cline}/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="${CLINE_CONFIG_DIR:-$HOME/.cline}/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; elif [ -f "${GROK_AGENTS_HOME:-$HOME/.agents}/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="${GROK_AGENTS_HOME:-$HOME/.agents}/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; elif [ -f "${ANTIGRAVITY_CONFIG_DIR:-$HOME/.gemini/antigravity}/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="${ANTIGRAVITY_CONFIG_DIR:-$HOME/.gemini/antigravity}/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; elif [ -f "${OPENCODE_CONFIG_DIR:-${XDG_CONFIG_HOME:-$HOME/.config}/opencode}/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="${OPENCODE_CONFIG_DIR:-${XDG_CONFIG_HOME:-$HOME/.config}/opencode}/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; elif [ -f "${KILO_CONFIG_DIR:-${XDG_CONFIG_HOME:-$HOME/.config}/kilo}/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="${KILO_CONFIG_DIR:-${XDG_CONFIG_HOME:-$HOME/.config}/kilo}/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; else echo "ERROR: gsd-tools.cjs not found at $GSD_TOOLS and gsd-tools is not on PATH. Run: npx -y @opengsd/gsd-core@latest --claude --local" >&2; exit 1; fi
|
||||||
|
gsd_run graphify diff
|
||||||
|
```
|
||||||
|
|
||||||
|
Parse the JSON output and display:
|
||||||
|
- If `no_baseline: true`, display the message field
|
||||||
|
- Otherwise show node and edge change counts (added/removed/changed)
|
||||||
|
|
||||||
|
If no snapshot exists, suggest running `build` twice (first to create, second to generate a diff baseline).
|
||||||
|
|
||||||
|
**STOP** after displaying diff. Do not spawn an agent.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Step 3 -- Build (Inline)
|
||||||
|
|
||||||
|
Run the pre-flight check first:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
_GSD_SHIM_NAME="gsd-tools.cjs"; _GSD_RUNTIME_ROOT="${RUNTIME_DIR:-$(git rev-parse --show-toplevel 2>/dev/null || pwd)}"; GSD_TOOLS="${_GSD_RUNTIME_ROOT}/gsd-core/bin/${_GSD_SHIM_NAME}"; if [ -f "$GSD_TOOLS" ]; then gsd_run() { node "$GSD_TOOLS" "$@"; }; elif [ -f "${_GSD_RUNTIME_ROOT}/.claude/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="${_GSD_RUNTIME_ROOT}/.claude/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; elif command -v gsd-tools >/dev/null 2>&1; then GSD_TOOLS="$(command -v gsd-tools)"; gsd_run() { "$GSD_TOOLS" "$@"; }; elif [ -f "$HOME/.claude/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="$HOME/.claude/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; elif [ -f "${HERMES_HOME:-$HOME/.hermes}/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="${HERMES_HOME:-$HOME/.hermes}/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; elif [ -f "${CURSOR_CONFIG_DIR:-$HOME/.cursor}/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="${CURSOR_CONFIG_DIR:-$HOME/.cursor}/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; elif [ -f "${CODEX_HOME:-$HOME/.codex}/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="${CODEX_HOME:-$HOME/.codex}/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; elif [ -f "${GEMINI_CONFIG_DIR:-$HOME/.gemini}/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="${GEMINI_CONFIG_DIR:-$HOME/.gemini}/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; elif [ -f "${COPILOT_CONFIG_DIR:-$HOME/.copilot}/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="${COPILOT_CONFIG_DIR:-$HOME/.copilot}/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; elif [ -f "${WINDSURF_CONFIG_DIR:-$HOME/.codeium/windsurf}/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="${WINDSURF_CONFIG_DIR:-$HOME/.codeium/windsurf}/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; elif [ -f "${AUGMENT_CONFIG_DIR:-$HOME/.augment}/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="${AUGMENT_CONFIG_DIR:-$HOME/.augment}/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; elif [ -f "${TRAE_CONFIG_DIR:-$HOME/.trae}/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="${TRAE_CONFIG_DIR:-$HOME/.trae}/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; elif [ -f "${QWEN_CONFIG_DIR:-$HOME/.qwen}/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="${QWEN_CONFIG_DIR:-$HOME/.qwen}/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; elif [ -f "${CODEBUDDY_CONFIG_DIR:-$HOME/.codebuddy}/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="${CODEBUDDY_CONFIG_DIR:-$HOME/.codebuddy}/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; elif [ -f "${CLINE_CONFIG_DIR:-$HOME/.cline}/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="${CLINE_CONFIG_DIR:-$HOME/.cline}/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; elif [ -f "${GROK_AGENTS_HOME:-$HOME/.agents}/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="${GROK_AGENTS_HOME:-$HOME/.agents}/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; elif [ -f "${ANTIGRAVITY_CONFIG_DIR:-$HOME/.gemini/antigravity}/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="${ANTIGRAVITY_CONFIG_DIR:-$HOME/.gemini/antigravity}/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; elif [ -f "${OPENCODE_CONFIG_DIR:-${XDG_CONFIG_HOME:-$HOME/.config}/opencode}/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="${OPENCODE_CONFIG_DIR:-${XDG_CONFIG_HOME:-$HOME/.config}/opencode}/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; elif [ -f "${KILO_CONFIG_DIR:-${XDG_CONFIG_HOME:-$HOME/.config}/kilo}/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="${KILO_CONFIG_DIR:-${XDG_CONFIG_HOME:-$HOME/.config}/kilo}/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; else echo "ERROR: gsd-tools.cjs not found at $GSD_TOOLS and gsd-tools is not on PATH. Run: npx -y @opengsd/gsd-core@latest --claude --local" >&2; exit 1; fi
|
||||||
|
gsd_run graphify build
|
||||||
|
```
|
||||||
|
|
||||||
|
Parse the JSON output:
|
||||||
|
- If `disabled: true`: display the disabled message from Step 1 and **STOP**
|
||||||
|
- If `error`: display the error message and **STOP**
|
||||||
|
- If `action: "spawn_agent"`: pre-flight passed -- proceed with the inline build below
|
||||||
|
|
||||||
|
(The `spawn_agent` action name is historical. The skill now performs the build inline because graphify v0.7+ split the build into a fast AST-extraction phase and a separate clustering + report-write phase. Sub-agent isolation kept the cached extraction phase alive but SIGTERM'd the post-extraction phase when the agent exited, leaving the cache populated but no `graph.json` artifacts written. The CLI still emits the `spawn_agent` signal so external callers and tests keep working.)
|
||||||
|
|
||||||
|
Display:
|
||||||
|
|
||||||
|
```text
|
||||||
|
GSD > Building knowledge graph...
|
||||||
|
```
|
||||||
|
|
||||||
|
Run the build, copy artifacts, write the diff snapshot, and report the summary in a single foreground Bash call so the whole pipeline survives to completion. Use a `timeout` of `600000` ms (10 minutes), which covers the `graphify.build_timeout` ceiling (default 300 s) with margin:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
_GSD_SHIM_NAME="gsd-tools.cjs"; _GSD_RUNTIME_ROOT="${RUNTIME_DIR:-$(git rev-parse --show-toplevel 2>/dev/null || pwd)}"; GSD_TOOLS="${_GSD_RUNTIME_ROOT}/gsd-core/bin/${_GSD_SHIM_NAME}"; if [ -f "$GSD_TOOLS" ]; then gsd_run() { node "$GSD_TOOLS" "$@"; }; elif [ -f "${_GSD_RUNTIME_ROOT}/.claude/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="${_GSD_RUNTIME_ROOT}/.claude/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; elif command -v gsd-tools >/dev/null 2>&1; then GSD_TOOLS="$(command -v gsd-tools)"; gsd_run() { "$GSD_TOOLS" "$@"; }; elif [ -f "$HOME/.claude/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="$HOME/.claude/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; elif [ -f "${HERMES_HOME:-$HOME/.hermes}/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="${HERMES_HOME:-$HOME/.hermes}/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; elif [ -f "${CURSOR_CONFIG_DIR:-$HOME/.cursor}/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="${CURSOR_CONFIG_DIR:-$HOME/.cursor}/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; elif [ -f "${CODEX_HOME:-$HOME/.codex}/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="${CODEX_HOME:-$HOME/.codex}/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; elif [ -f "${GEMINI_CONFIG_DIR:-$HOME/.gemini}/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="${GEMINI_CONFIG_DIR:-$HOME/.gemini}/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; elif [ -f "${COPILOT_CONFIG_DIR:-$HOME/.copilot}/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="${COPILOT_CONFIG_DIR:-$HOME/.copilot}/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; elif [ -f "${WINDSURF_CONFIG_DIR:-$HOME/.codeium/windsurf}/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="${WINDSURF_CONFIG_DIR:-$HOME/.codeium/windsurf}/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; elif [ -f "${AUGMENT_CONFIG_DIR:-$HOME/.augment}/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="${AUGMENT_CONFIG_DIR:-$HOME/.augment}/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; elif [ -f "${TRAE_CONFIG_DIR:-$HOME/.trae}/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="${TRAE_CONFIG_DIR:-$HOME/.trae}/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; elif [ -f "${QWEN_CONFIG_DIR:-$HOME/.qwen}/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="${QWEN_CONFIG_DIR:-$HOME/.qwen}/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; elif [ -f "${CODEBUDDY_CONFIG_DIR:-$HOME/.codebuddy}/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="${CODEBUDDY_CONFIG_DIR:-$HOME/.codebuddy}/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; elif [ -f "${CLINE_CONFIG_DIR:-$HOME/.cline}/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="${CLINE_CONFIG_DIR:-$HOME/.cline}/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; elif [ -f "${GROK_AGENTS_HOME:-$HOME/.agents}/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="${GROK_AGENTS_HOME:-$HOME/.agents}/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; elif [ -f "${ANTIGRAVITY_CONFIG_DIR:-$HOME/.gemini/antigravity}/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="${ANTIGRAVITY_CONFIG_DIR:-$HOME/.gemini/antigravity}/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; elif [ -f "${OPENCODE_CONFIG_DIR:-${XDG_CONFIG_HOME:-$HOME/.config}/opencode}/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="${OPENCODE_CONFIG_DIR:-${XDG_CONFIG_HOME:-$HOME/.config}/opencode}/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; elif [ -f "${KILO_CONFIG_DIR:-${XDG_CONFIG_HOME:-$HOME/.config}/kilo}/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="${KILO_CONFIG_DIR:-${XDG_CONFIG_HOME:-$HOME/.config}/kilo}/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; else echo "ERROR: gsd-tools.cjs not found at $GSD_TOOLS and gsd-tools is not on PATH. Run: npx -y @opengsd/gsd-core@latest --claude --local" >&2; exit 1; fi
|
||||||
|
graphify update . \
|
||||||
|
&& cp graphify-out/graph.json .planning/graphs/graph.json \
|
||||||
|
&& { [ -f graphify-out/graph.html ] && cp graphify-out/graph.html .planning/graphs/graph.html || true; } \
|
||||||
|
&& cp graphify-out/GRAPH_REPORT.md .planning/graphs/GRAPH_REPORT.md \
|
||||||
|
&& gsd_run graphify build snapshot \
|
||||||
|
&& gsd_run graphify status
|
||||||
|
```
|
||||||
|
|
||||||
|
Do NOT pass `run_in_background: true`. Typical builds complete in 15-60 seconds and the entire chain must run foreground.
|
||||||
|
|
||||||
|
If the chain fails (non-zero exit):
|
||||||
|
- Display: `## GRAPHIFY BUILD FAILED` followed by the captured stderr
|
||||||
|
- Do NOT delete `.planning/graphs/` -- the prior valid graph remains available
|
||||||
|
- **STOP**
|
||||||
|
|
||||||
|
If the chain succeeds:
|
||||||
|
- Parse the trailing `graphify status` JSON
|
||||||
|
- Display: `## GRAPHIFY BUILD COMPLETE` with the node, edge, and hyperedge counts
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## MVP-Mode Node Rendering
|
||||||
|
|
||||||
|
**MVP-mode rendering.** When a phase has `**Mode:** mvp` in ROADMAP.md (resolved via `gsd-tools query roadmap.get-phase --pick mode`), render its graph node with two distinct visual signals:
|
||||||
|
|
||||||
|
1. **Distinct fill color.** Use `#22c55e` (green) for MVP-mode phase nodes. Standard phases keep the default fill color. Two-channel signaling (color + label) handles color-blind and grayscale renders.
|
||||||
|
2. **`MVP` label suffix.** Append ` (MVP)` to the node's label text. Example: a phase originally labeled `Phase 1: User Auth` renders as `Phase 1: User Auth (MVP)`.
|
||||||
|
|
||||||
|
Both signals fire together — never just one. Per PRD Q5 decision, the goal is unambiguous visual distinction in any render context.
|
||||||
|
|
||||||
|
When the phase mode is null/absent, render with the standard color and label — no behavioral change for non-MVP phases.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Anti-Patterns
|
||||||
|
|
||||||
|
1. DO NOT spawn an agent for any operation -- build, query, status, and diff all run inline. Sub-agent isolation terminates background bash when the agent exits, which previously truncated graphify builds mid-write and left only the cache populated (#3166).
|
||||||
|
2. DO NOT pass `run_in_background: true` for the build chain -- the operation is fast and must complete in the foreground.
|
||||||
|
3. DO NOT modify graph files directly -- always go through `graphify update .` and the snapshot CLI.
|
||||||
|
4. DO NOT skip the config gate check.
|
||||||
|
5. DO NOT use `gsd-tools config get-value` for the config gate -- it exits on missing keys.
|
||||||
31
skills/gsd-health/SKILL.md
Normal file
31
skills/gsd-health/SKILL.md
Normal file
@@ -0,0 +1,31 @@
|
|||||||
|
---
|
||||||
|
name: gsd-health
|
||||||
|
description: "Diagnose planning directory health and optionally repair issues"
|
||||||
|
argument-hint: "[--repair] [--context]"
|
||||||
|
allowed-tools:
|
||||||
|
- Read
|
||||||
|
- Bash
|
||||||
|
- Write
|
||||||
|
- AskUserQuestion
|
||||||
|
---
|
||||||
|
|
||||||
|
<objective>
|
||||||
|
Validate `.planning/` directory integrity and report actionable issues. Checks for missing files, invalid configurations, inconsistent state, and orphaned plans.
|
||||||
|
|
||||||
|
`--context` runs an orthogonal check: the running session's context utilization. The workflow asks for the model's tokensUsed + contextWindow, calls `gsd-tools query validate.context`, and renders one of three states:
|
||||||
|
|
||||||
|
| Utilization | State | Action |
|
||||||
|
|-------------|----------|-------------------------------------------------------|
|
||||||
|
| < 60% | healthy | no action — context is comfortable |
|
||||||
|
| 60% – 70% | warning | recommend `/gsd-thread` to start fresh |
|
||||||
|
| ≥ 70% | critical | reasoning quality may degrade past the fracture point |
|
||||||
|
</objective>
|
||||||
|
|
||||||
|
<execution_context>
|
||||||
|
@~/.claude/gsd-core/workflows/health.md
|
||||||
|
</execution_context>
|
||||||
|
|
||||||
|
<process>
|
||||||
|
Execute end-to-end.
|
||||||
|
Parse `--repair` and `--context` flags from arguments and pass to workflow.
|
||||||
|
</process>
|
||||||
29
skills/gsd-help/SKILL.md
Normal file
29
skills/gsd-help/SKILL.md
Normal file
@@ -0,0 +1,29 @@
|
|||||||
|
---
|
||||||
|
name: gsd-help
|
||||||
|
description: "Show available GSD commands and usage guide"
|
||||||
|
argument-hint: "[--brief | --full | <topic> | --brief <topic>]"
|
||||||
|
allowed-tools:
|
||||||
|
- Read
|
||||||
|
---
|
||||||
|
|
||||||
|
<objective>
|
||||||
|
Display GSD help at the tier the user asked for: brief (one-line refresher), default (one-page tour), full (complete reference), a single topic section, or a compact scoped lookup of one topic (`--brief <topic>`: signature + one-line summary).
|
||||||
|
|
||||||
|
Output ONLY the reference content of the chosen tier. Do NOT add:
|
||||||
|
- Project-specific analysis
|
||||||
|
- Git status or file context
|
||||||
|
- Next-step suggestions
|
||||||
|
- Any commentary beyond the reference
|
||||||
|
</objective>
|
||||||
|
|
||||||
|
<execution_context>
|
||||||
|
@~/.claude/gsd-core/workflows/help.md
|
||||||
|
</execution_context>
|
||||||
|
|
||||||
|
<context>
|
||||||
|
Arguments: $ARGUMENTS
|
||||||
|
</context>
|
||||||
|
|
||||||
|
<process>
|
||||||
|
Follow ~/.claude/gsd-core/workflows/help.md with $ARGUMENTS.
|
||||||
|
</process>
|
||||||
46
skills/gsd-import/SKILL.md
Normal file
46
skills/gsd-import/SKILL.md
Normal file
@@ -0,0 +1,46 @@
|
|||||||
|
---
|
||||||
|
name: gsd-import
|
||||||
|
description: "Ingest external plans with conflict detection against project decisions before writing anything."
|
||||||
|
argument-hint: "--from <filepath> | --from-gsd2"
|
||||||
|
allowed-tools:
|
||||||
|
- Read
|
||||||
|
- Write
|
||||||
|
- Edit
|
||||||
|
- Bash
|
||||||
|
- Glob
|
||||||
|
- Grep
|
||||||
|
- AskUserQuestion
|
||||||
|
- Agent
|
||||||
|
---
|
||||||
|
|
||||||
|
|
||||||
|
<objective>
|
||||||
|
Import external plan files into the GSD planning system with conflict detection against PROJECT.md decisions.
|
||||||
|
|
||||||
|
- **--from**: Import an external plan file, detect conflicts, write as GSD PLAN.md, validate via gsd-plan-checker.
|
||||||
|
- **--from-gsd2**: Reverse-migrate a GSD-2 project (`.gsd/` directory) back to GSD v1 (`.planning/`) format. Runs `gsd-tools.cjs from-gsd2`. Pass `--path <dir>` to migrate a project at a different path.
|
||||||
|
</objective>
|
||||||
|
|
||||||
|
<execution_context>
|
||||||
|
@~/.claude/gsd-core/workflows/import.md
|
||||||
|
@~/.claude/gsd-core/references/ui-brand.md
|
||||||
|
@~/.claude/gsd-core/references/gate-prompts.md
|
||||||
|
@~/.claude/gsd-core/references/doc-conflict-engine.md
|
||||||
|
</execution_context>
|
||||||
|
|
||||||
|
<context>
|
||||||
|
$ARGUMENTS
|
||||||
|
</context>
|
||||||
|
|
||||||
|
<process>
|
||||||
|
If `--from-gsd2` is in $ARGUMENTS:
|
||||||
|
Run the reverse-migration (append `--path <dir>` if provided):
|
||||||
|
```bash
|
||||||
|
_GSD_SHIM_NAME="gsd-tools.cjs"; _GSD_RUNTIME_ROOT="${RUNTIME_DIR:-$(git rev-parse --show-toplevel 2>/dev/null || pwd)}"; GSD_TOOLS="${_GSD_RUNTIME_ROOT}/gsd-core/bin/${_GSD_SHIM_NAME}"; if [ -f "$GSD_TOOLS" ]; then gsd_run() { node "$GSD_TOOLS" "$@"; }; elif [ -f "${_GSD_RUNTIME_ROOT}/.claude/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="${_GSD_RUNTIME_ROOT}/.claude/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; elif command -v gsd-tools >/dev/null 2>&1; then GSD_TOOLS="$(command -v gsd-tools)"; gsd_run() { "$GSD_TOOLS" "$@"; }; elif [ -f "$HOME/.claude/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="$HOME/.claude/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; elif [ -f "${HERMES_HOME:-$HOME/.hermes}/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="${HERMES_HOME:-$HOME/.hermes}/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; elif [ -f "${CURSOR_CONFIG_DIR:-$HOME/.cursor}/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="${CURSOR_CONFIG_DIR:-$HOME/.cursor}/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; elif [ -f "${CODEX_HOME:-$HOME/.codex}/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="${CODEX_HOME:-$HOME/.codex}/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; elif [ -f "${GEMINI_CONFIG_DIR:-$HOME/.gemini}/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="${GEMINI_CONFIG_DIR:-$HOME/.gemini}/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; elif [ -f "${COPILOT_CONFIG_DIR:-$HOME/.copilot}/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="${COPILOT_CONFIG_DIR:-$HOME/.copilot}/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; elif [ -f "${WINDSURF_CONFIG_DIR:-$HOME/.codeium/windsurf}/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="${WINDSURF_CONFIG_DIR:-$HOME/.codeium/windsurf}/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; elif [ -f "${AUGMENT_CONFIG_DIR:-$HOME/.augment}/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="${AUGMENT_CONFIG_DIR:-$HOME/.augment}/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; elif [ -f "${TRAE_CONFIG_DIR:-$HOME/.trae}/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="${TRAE_CONFIG_DIR:-$HOME/.trae}/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; elif [ -f "${QWEN_CONFIG_DIR:-$HOME/.qwen}/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="${QWEN_CONFIG_DIR:-$HOME/.qwen}/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; elif [ -f "${CODEBUDDY_CONFIG_DIR:-$HOME/.codebuddy}/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="${CODEBUDDY_CONFIG_DIR:-$HOME/.codebuddy}/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; elif [ -f "${CLINE_CONFIG_DIR:-$HOME/.cline}/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="${CLINE_CONFIG_DIR:-$HOME/.cline}/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; elif [ -f "${GROK_AGENTS_HOME:-$HOME/.agents}/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="${GROK_AGENTS_HOME:-$HOME/.agents}/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; elif [ -f "${ANTIGRAVITY_CONFIG_DIR:-$HOME/.gemini/antigravity}/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="${ANTIGRAVITY_CONFIG_DIR:-$HOME/.gemini/antigravity}/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; elif [ -f "${OPENCODE_CONFIG_DIR:-${XDG_CONFIG_HOME:-$HOME/.config}/opencode}/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="${OPENCODE_CONFIG_DIR:-${XDG_CONFIG_HOME:-$HOME/.config}/opencode}/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; elif [ -f "${KILO_CONFIG_DIR:-${XDG_CONFIG_HOME:-$HOME/.config}/kilo}/gsd-core/bin/${_GSD_SHIM_NAME}" ]; then GSD_TOOLS="${KILO_CONFIG_DIR:-${XDG_CONFIG_HOME:-$HOME/.config}/kilo}/gsd-core/bin/${_GSD_SHIM_NAME}"; gsd_run() { node "$GSD_TOOLS" "$@"; }; else echo "ERROR: gsd-tools.cjs not found at $GSD_TOOLS and gsd-tools is not on PATH. Run: npx -y @opengsd/gsd-core@latest --claude --local" >&2; exit 1; fi
|
||||||
|
gsd_run from-gsd2
|
||||||
|
```
|
||||||
|
Present the migration result to the user.
|
||||||
|
Stop here (do not run the standard import workflow).
|
||||||
|
|
||||||
|
Otherwise, execute the import workflow end-to-end.
|
||||||
|
</process>
|
||||||
39
skills/gsd-inbox/SKILL.md
Normal file
39
skills/gsd-inbox/SKILL.md
Normal file
@@ -0,0 +1,39 @@
|
|||||||
|
---
|
||||||
|
name: gsd-inbox
|
||||||
|
description: "Triage and review open GitHub issues and PRs against project templates and contribution guidelines."
|
||||||
|
argument-hint: "[--issues] [--prs] [--label] [--close-incomplete] [--repo owner/repo]"
|
||||||
|
allowed-tools:
|
||||||
|
- Read
|
||||||
|
- Bash
|
||||||
|
- Write
|
||||||
|
- Grep
|
||||||
|
- Glob
|
||||||
|
- AskUserQuestion
|
||||||
|
---
|
||||||
|
|
||||||
|
<objective>
|
||||||
|
One-command triage of the project's GitHub inbox. Fetches all open issues and PRs,
|
||||||
|
reviews each against the corresponding template requirements (feature, enhancement,
|
||||||
|
bug, chore, fix PR, enhancement PR, feature PR), reports completeness and compliance,
|
||||||
|
and optionally applies labels or closes non-compliant submissions.
|
||||||
|
|
||||||
|
**Flow:** Detect repo → Fetch open issues + PRs → Classify each by type → Review against template → Report findings → Optionally act (label, comment, close)
|
||||||
|
</objective>
|
||||||
|
|
||||||
|
<execution_context>
|
||||||
|
@~/.claude/gsd-core/workflows/inbox.md
|
||||||
|
</execution_context>
|
||||||
|
|
||||||
|
<context>
|
||||||
|
**Flags:**
|
||||||
|
- `--issues` — Review only issues (skip PRs)
|
||||||
|
- `--prs` — Review only PRs (skip issues)
|
||||||
|
- `--label` — Auto-apply recommended labels after review
|
||||||
|
- `--close-incomplete` — Close issues/PRs that fail template compliance (with comment explaining why)
|
||||||
|
- `--repo owner/repo` — Override auto-detected repository (defaults to current git remote)
|
||||||
|
</context>
|
||||||
|
|
||||||
|
<process>
|
||||||
|
Execute end-to-end.
|
||||||
|
Parse flags from arguments and pass to workflow.
|
||||||
|
</process>
|
||||||
43
skills/gsd-ingest-docs/SKILL.md
Normal file
43
skills/gsd-ingest-docs/SKILL.md
Normal file
@@ -0,0 +1,43 @@
|
|||||||
|
---
|
||||||
|
name: gsd-ingest-docs
|
||||||
|
description: "Bootstrap or merge a .planning/ setup from existing ADRs, PRDs, SPECs, and docs in a repo."
|
||||||
|
argument-hint: "[path] [--mode new|merge] [--manifest <file>] [--resolve auto|interactive]"
|
||||||
|
allowed-tools:
|
||||||
|
- Read
|
||||||
|
- Write
|
||||||
|
- Edit
|
||||||
|
- Bash
|
||||||
|
- Glob
|
||||||
|
- Grep
|
||||||
|
- AskUserQuestion
|
||||||
|
- Agent
|
||||||
|
---
|
||||||
|
|
||||||
|
|
||||||
|
<objective>
|
||||||
|
Build the full `.planning/` setup (or merge into an existing one) from multiple pre-existing planning documents — ADRs, PRDs, SPECs, DOCs — in one pass.
|
||||||
|
|
||||||
|
- **Net-new bootstrap** (`--mode new`, default when `.planning/` is absent): produces PROJECT.md + REQUIREMENTS.md + ROADMAP.md + STATE.md from synthesized doc content, delegating final generation to `gsd-roadmapper`.
|
||||||
|
- **Merge into existing** (`--mode merge`, default when `.planning/` is present): appends phases and requirements derived from the ingested docs; hard-blocks any contradiction with existing locked decisions.
|
||||||
|
|
||||||
|
Auto-synthesizes most conflicts using the precedence rule `ADR > SPEC > PRD > DOC` (overridable via manifest). Surfaces unresolved cases in `.planning/INGEST-CONFLICTS.md` with three buckets: auto-resolved, competing-variants, unresolved-blockers. The BLOCKER gate from the shared conflict engine prevents any destination file from being written when unresolved contradictions exist.
|
||||||
|
|
||||||
|
**Inputs:** directory-convention discovery (`docs/adr/`, `docs/prd/`, `docs/specs/`, `docs/rfc/`, root-level `{ADR,PRD,SPEC,RFC}-*.md`), or an explicit `--manifest <file>` YAML listing `{path, type, precedence?}` per doc.
|
||||||
|
|
||||||
|
**v1 constraints:** hard cap of 50 docs per invocation; `--resolve interactive` is reserved for a future release.
|
||||||
|
</objective>
|
||||||
|
|
||||||
|
<execution_context>
|
||||||
|
@~/.claude/gsd-core/workflows/ingest-docs.md
|
||||||
|
@~/.claude/gsd-core/references/ui-brand.md
|
||||||
|
@~/.claude/gsd-core/references/gate-prompts.md
|
||||||
|
@~/.claude/gsd-core/references/doc-conflict-engine.md
|
||||||
|
</execution_context>
|
||||||
|
|
||||||
|
<context>
|
||||||
|
$ARGUMENTS
|
||||||
|
</context>
|
||||||
|
|
||||||
|
<process>
|
||||||
|
Execute the ingest-docs workflow end-to-end. Preserve all approval gates (discovery, conflict report, routing) and the BLOCKER safety rule.
|
||||||
|
</process>
|
||||||
45
skills/gsd-manager/SKILL.md
Normal file
45
skills/gsd-manager/SKILL.md
Normal file
@@ -0,0 +1,45 @@
|
|||||||
|
---
|
||||||
|
name: gsd-manager
|
||||||
|
description: "Interactive command center for managing multiple phases from one terminal"
|
||||||
|
argument-hint: "[--analyze-deps]"
|
||||||
|
allowed-tools:
|
||||||
|
- Read
|
||||||
|
- Write
|
||||||
|
- Bash
|
||||||
|
- Glob
|
||||||
|
- Grep
|
||||||
|
- AskUserQuestion
|
||||||
|
- Skill
|
||||||
|
- Agent
|
||||||
|
---
|
||||||
|
|
||||||
|
<objective>
|
||||||
|
Single-terminal command center for managing a milestone. Shows a dashboard of all phases with visual status indicators, recommends optimal next actions, and dispatches work — discuss runs inline, plan/execute run as background agents.
|
||||||
|
|
||||||
|
Designed for power users who want to parallelize work across phases from one terminal: discuss a phase while another plans or executes in the background.
|
||||||
|
|
||||||
|
**Creates/Updates:**
|
||||||
|
- No files created directly — dispatches to existing GSD commands via Skill() and background Task agents.
|
||||||
|
- Reads `.planning/STATE.md`, `.planning/ROADMAP.md`, phase directories for status.
|
||||||
|
|
||||||
|
**After:** User exits when done managing, or all phases complete and milestone lifecycle is suggested.
|
||||||
|
</objective>
|
||||||
|
|
||||||
|
<execution_context>
|
||||||
|
@~/.claude/gsd-core/workflows/manager.md
|
||||||
|
@~/.claude/gsd-core/references/ui-brand.md
|
||||||
|
</execution_context>
|
||||||
|
|
||||||
|
<context>
|
||||||
|
No arguments required. Requires an active milestone with ROADMAP.md and STATE.md.
|
||||||
|
|
||||||
|
Project context, phase list, dependencies, and recommendations are resolved inside the workflow using `gsd-tools query init.manager`. No upfront context loading needed.
|
||||||
|
</context>
|
||||||
|
|
||||||
|
<process>
|
||||||
|
If `--analyze-deps` is in $ARGUMENTS:
|
||||||
|
Read and execute `~/.claude/gsd-core/workflows/analyze-dependencies.md` end-to-end.
|
||||||
|
|
||||||
|
Execute end-to-end.
|
||||||
|
Maintain the dashboard refresh loop until the user exits or all phases complete.
|
||||||
|
</process>
|
||||||
83
skills/gsd-map-codebase/SKILL.md
Normal file
83
skills/gsd-map-codebase/SKILL.md
Normal file
@@ -0,0 +1,83 @@
|
|||||||
|
---
|
||||||
|
name: gsd-map-codebase
|
||||||
|
description: "Analyze codebase with parallel mapper agents to produce .planning/codebase/ documents"
|
||||||
|
argument-hint: "[--fast [--focus tech|arch|quality|concerns]] [--query <term>|status|diff|refresh] [area]"
|
||||||
|
allowed-tools:
|
||||||
|
- Read
|
||||||
|
- Bash
|
||||||
|
- Glob
|
||||||
|
- Grep
|
||||||
|
- Write
|
||||||
|
- Agent
|
||||||
|
---
|
||||||
|
|
||||||
|
|
||||||
|
<objective>
|
||||||
|
Analyze existing codebase using parallel gsd-codebase-mapper agents to produce structured codebase documents.
|
||||||
|
|
||||||
|
Each mapper agent explores a focus area and **writes documents directly** to `.planning/codebase/`. The orchestrator only receives confirmations, keeping context usage minimal.
|
||||||
|
|
||||||
|
Output: .planning/codebase/ folder with 7 structured documents about the codebase state.
|
||||||
|
</objective>
|
||||||
|
|
||||||
|
<execution_context>
|
||||||
|
@~/.claude/gsd-core/workflows/map-codebase.md
|
||||||
|
</execution_context>
|
||||||
|
|
||||||
|
<flags>
|
||||||
|
- **--fast**: Lightweight scan mode — spawns one mapper agent instead of four. Accepts an optional `--focus` value: `tech`, `arch`, `quality`, `concerns`, or `tech+arch` (default). Faster and lower-context than the full map.
|
||||||
|
- **--query**: Codebase intelligence query mode. Sub-commands: `query <term>`, `status`, `diff`, `refresh`. Requires intel to be enabled in config (`intel.enabled: true`). Runs inline for query/status/diff; spawns an agent for refresh.
|
||||||
|
- **(no flag)**: Full parallel map — spawns 4 mapper agents to produce all 7 codebase documents.
|
||||||
|
</flags>
|
||||||
|
|
||||||
|
<context>
|
||||||
|
Arguments: $ARGUMENTS
|
||||||
|
|
||||||
|
Parse the first token of $ARGUMENTS:
|
||||||
|
- If it is `--fast`: strip the flag, run the scan workflow (passing remaining args including optional --focus).
|
||||||
|
- If it is `--query`: strip the flag, run the intel workflow (passing remaining args as the subcommand).
|
||||||
|
- Otherwise: pass all of $ARGUMENTS as focus area to the map-codebase workflow.
|
||||||
|
|
||||||
|
**Load project state if exists:**
|
||||||
|
Check for .planning/STATE.md - loads context if project already initialized
|
||||||
|
|
||||||
|
**This command can run:**
|
||||||
|
- Before /gsd-new-project (brownfield codebases) - creates codebase map first
|
||||||
|
- After /gsd-new-project (greenfield codebases) - updates codebase map as code evolves
|
||||||
|
- Anytime to refresh codebase understanding
|
||||||
|
</context>
|
||||||
|
|
||||||
|
<when_to_use>
|
||||||
|
**Use map-codebase for:**
|
||||||
|
- Brownfield projects before initialization (understand existing code first)
|
||||||
|
- Refreshing codebase map after significant changes
|
||||||
|
- Onboarding to an unfamiliar codebase
|
||||||
|
- Before major refactoring (understand current state)
|
||||||
|
- When STATE.md references outdated codebase info
|
||||||
|
|
||||||
|
**Skip map-codebase for:**
|
||||||
|
- Greenfield projects with no code yet (nothing to map)
|
||||||
|
- Trivial codebases (<5 files)
|
||||||
|
</when_to_use>
|
||||||
|
|
||||||
|
<process>
|
||||||
|
1. Check if .planning/codebase/ already exists (offer to refresh or skip)
|
||||||
|
2. Create .planning/codebase/ directory structure
|
||||||
|
3. Spawn 4 parallel gsd-codebase-mapper agents:
|
||||||
|
- Agent 1: tech focus → writes STACK.md, INTEGRATIONS.md
|
||||||
|
- Agent 2: arch focus → writes ARCHITECTURE.md, STRUCTURE.md
|
||||||
|
- Agent 3: quality focus → writes CONVENTIONS.md, TESTING.md
|
||||||
|
- Agent 4: concerns focus → writes CONCERNS.md
|
||||||
|
4. Wait for agents to complete, collect confirmations (NOT document contents)
|
||||||
|
5. Verify all 7 documents exist with line counts
|
||||||
|
6. Commit codebase map
|
||||||
|
7. Offer next steps (typically: /gsd-new-project or /gsd-plan-phase)
|
||||||
|
</process>
|
||||||
|
|
||||||
|
<success_criteria>
|
||||||
|
- [ ] .planning/codebase/ directory created
|
||||||
|
- [ ] All 7 codebase documents written by mapper agents
|
||||||
|
- [ ] Documents follow template structure
|
||||||
|
- [ ] Parallel agents completed without errors
|
||||||
|
- [ ] User knows next steps
|
||||||
|
</success_criteria>
|
||||||
71
skills/gsd-mempalace-capture/SKILL.md
Normal file
71
skills/gsd-mempalace-capture/SKILL.md
Normal file
@@ -0,0 +1,71 @@
|
|||||||
|
---
|
||||||
|
name: gsd-mempalace-capture
|
||||||
|
description: "File a phase artifact into MemPalace; mirror decision facts into its temporal KG"
|
||||||
|
argument-hint: "[CONTEXT.md|PLAN.md|SUMMARY.md]"
|
||||||
|
allowed-tools:
|
||||||
|
- Read
|
||||||
|
- Bash
|
||||||
|
---
|
||||||
|
|
||||||
|
|
||||||
|
**STOP -- DO NOT READ THIS FILE. You are already reading it. This prompt was injected into your context by the command system. Using the Read tool on this file wastes tokens. Begin executing Step 0 immediately.**
|
||||||
|
|
||||||
|
## Step 0 -- Banner
|
||||||
|
|
||||||
|
**Before ANY tool calls**, display this banner:
|
||||||
|
|
||||||
|
```
|
||||||
|
GSD > MEMPALACE CAPTURE
|
||||||
|
```
|
||||||
|
|
||||||
|
Then proceed to Step 1.
|
||||||
|
|
||||||
|
## Step 1 -- Config Gate
|
||||||
|
|
||||||
|
Check whether the MemPalace capability is enabled by reading `.planning/config.json` directly with the Read tool.
|
||||||
|
|
||||||
|
1. Read `.planning/config.json` with the Read tool.
|
||||||
|
2. If the file does not exist, or `config.mempalace` is absent, or `config.mempalace.enabled !== true`, or `config.mempalace.capture_artifacts !== true`: display the disabled message and **STOP**.
|
||||||
|
3. Otherwise proceed to Step 2.
|
||||||
|
|
||||||
|
**Disabled message:**
|
||||||
|
|
||||||
|
```
|
||||||
|
GSD > MEMPALACE CAPTURE
|
||||||
|
|
||||||
|
MemPalace capture is disabled (mempalace.enabled / mempalace.capture_artifacts).
|
||||||
|
Nothing was filed; the loop proceeds normally.
|
||||||
|
```
|
||||||
|
|
||||||
|
This step is `onError: skip` at `discuss:post` / `plan:post` / `verify:post` -- capture never fails a phase.
|
||||||
|
|
||||||
|
## Step 2 -- Resolve target
|
||||||
|
|
||||||
|
1. **Artifact.** Take the artifact from `$ARGUMENTS`. If absent, infer from the loop point: `discuss:post` → `CONTEXT.md`, `plan:post` → `PLAN.md`, `verify:post` → `SUMMARY.md`.
|
||||||
|
2. **Room.** Map artifact → room:
|
||||||
|
- `CONTEXT.md` → `decisions`
|
||||||
|
- `PLAN.md` → `planning`
|
||||||
|
- `SUMMARY.md` → `milestones`
|
||||||
|
(Confirmed problem→fix pairs go to `problems` — see the `capture-problems` fragment used at `execute:wave:post`.)
|
||||||
|
3. **Wing.** `config.mempalace.wing` if non-empty, else `config.project_code`, else the repo directory name.
|
||||||
|
4. **Mode / transport.** Read `config.mempalace.memory_mode`. Prefer MCP (`mempalace_*`) when your MemPalace MCP server is registered and your runtime permits those tools; otherwise use the `mempalace` CLI (covered by this skill's `Bash` allow-tool), as in `mempalace-recall`.
|
||||||
|
|
||||||
|
## Step 3 -- File verbatim (idempotent)
|
||||||
|
|
||||||
|
On any error or timeout, stop and let the phase continue -- capture is best-effort.
|
||||||
|
|
||||||
|
1. **Dedup first.** Interactive: `mempalace_check_duplicate` on the artifact's deterministic drawer id. Headless: rely on `mempalace mine`'s content-hash idempotency.
|
||||||
|
2. **Add the drawer (verbatim).** File the exact artifact text into `room: <room>` of `wing: <wing>` with provenance (`source_file`, phase id). Interactive: `mempalace_add_drawer`. Headless: `mempalace mine <path> --wing <wing> --room <room>`.
|
||||||
|
3. **Mirror KG facts** when `config.mempalace.mirror_kg` is true: extract decision/delivery facts and `mempalace_kg_add` them with `valid_from` = the phase date (e.g. `(<project>, decided, <decision>)` from CONTEXT; `(<phase>, delivered, <capability>)` from SUMMARY). Only `augment` is currently wired, so these are an *additive* mirror of `.planning/graphs/`. (`kg_backend`/`replace` are forward-declared and behave as `augment` today.)
|
||||||
|
4. Re-running a phase MUST NOT create duplicate drawers (deterministic ids + `check_duplicate`).
|
||||||
|
|
||||||
|
## Step 4 -- Report
|
||||||
|
|
||||||
|
Print a one-line summary: `Filed <artifact> → <wing>/<room> (<n> KG facts)` or `MemPalace unavailable — capture skipped`.
|
||||||
|
|
||||||
|
## Anti-Patterns
|
||||||
|
|
||||||
|
1. DO NOT let any MemPalace error fail the step -- capture is `onError: skip`.
|
||||||
|
2. DO NOT write lossy summaries -- store the verbatim artifact text (AAAK compression is a separate, optional index).
|
||||||
|
3. DO NOT prune or delete drawers here -- pruning (`sync --apply`) is the curator agent's job at `ship:post`, wing-scoped only.
|
||||||
|
4. DO NOT skip the config gate or the dedup check.
|
||||||
102
skills/gsd-mempalace-recall/SKILL.md
Normal file
102
skills/gsd-mempalace-recall/SKILL.md
Normal file
@@ -0,0 +1,102 @@
|
|||||||
|
---
|
||||||
|
name: gsd-mempalace-recall
|
||||||
|
description: "Recall decisions, patterns, and surprises from MemPalace before planning"
|
||||||
|
argument-hint: "[phase-slug]"
|
||||||
|
allowed-tools:
|
||||||
|
- Read
|
||||||
|
- Write
|
||||||
|
- Bash
|
||||||
|
---
|
||||||
|
|
||||||
|
|
||||||
|
**STOP -- DO NOT READ THIS FILE. You are already reading it. This prompt was injected into your context by the command system. Using the Read tool on this file wastes tokens. Begin executing Step 0 immediately.**
|
||||||
|
|
||||||
|
## Step 0 -- Banner
|
||||||
|
|
||||||
|
**Before ANY tool calls**, display this banner:
|
||||||
|
|
||||||
|
```
|
||||||
|
GSD > MEMPALACE RECALL
|
||||||
|
```
|
||||||
|
|
||||||
|
Then proceed to Step 1.
|
||||||
|
|
||||||
|
## Step 1 -- Config Gate
|
||||||
|
|
||||||
|
Check whether the MemPalace capability is enabled by reading `.planning/config.json` directly with the Read tool.
|
||||||
|
|
||||||
|
**DO NOT use `gsd-tools config get-value`** -- it hard-exits on missing keys.
|
||||||
|
|
||||||
|
1. Read `.planning/config.json` with the Read tool.
|
||||||
|
2. If the file does not exist: write the "unavailable" stub (Step 4) and **STOP**.
|
||||||
|
3. Parse the JSON. Proceed to Step 2 only if `config.mempalace && config.mempalace.enabled === true` **and** `config.mempalace.recall_on_plan !== false`. Otherwise display the disabled message and **STOP** (`recall_on_plan: false` turns plan-time recall off while leaving the rest of the capability enabled).
|
||||||
|
|
||||||
|
**Disabled message:**
|
||||||
|
|
||||||
|
```
|
||||||
|
GSD > MEMPALACE RECALL
|
||||||
|
|
||||||
|
MemPalace memory is disabled. To activate:
|
||||||
|
|
||||||
|
node <runtime-home>/gsd-core/bin/gsd-tools.cjs config-set mempalace.enabled true
|
||||||
|
|
||||||
|
Recall is opt-in; the loop proceeds normally without it.
|
||||||
|
```
|
||||||
|
|
||||||
|
This step is `onError: skip` at `plan:pre` -- recall never blocks planning.
|
||||||
|
|
||||||
|
## Step 2 -- Resolve wing, mode, and transport
|
||||||
|
|
||||||
|
1. **Wing.** Use `config.mempalace.wing` if non-empty; otherwise derive from `config.project_code`; otherwise fall back to the repository directory name.
|
||||||
|
2. **Mode.** Read `config.mempalace.memory_mode` (`augment` | `kg_backend` | `replace`, default `augment`). Only `augment` is wired today, so recall always treats the palace as additive; `kg_backend`/`replace` are forward-declared and behave as `augment`.
|
||||||
|
3. **Transport.** Prefer the **MCP tools** (`mempalace_*`) in interactive runs *when your MemPalace MCP server is registered and your runtime permits those tools*. Otherwise — headless/cron/autonomous runs, or runtimes that don't grant the MemPalace MCP tools — use the **CLI** (`mempalace wake-up`, `mempalace search`), which this skill's `Bash` allow-tool always covers. If neither is reachable, go to Step 4.
|
||||||
|
4. **Topic.** Read the phase `CONTEXT.md` (the consumed artifact). Derive a short search query from its title, goal, and key decisions.
|
||||||
|
|
||||||
|
## Step 3 -- Retrieve (read-only)
|
||||||
|
|
||||||
|
All calls in this step are side-effect-free. On any error or timeout, stop retrieving and write whatever was gathered (or the stub) -- never raise.
|
||||||
|
|
||||||
|
1. **Wake up** (cheap, ~600--900 tokens):
|
||||||
|
- Interactive: read the wing identity/summary, then `mempalace_search`.
|
||||||
|
- Headless: `mempalace wake-up --wing <wing>`.
|
||||||
|
2. **Targeted search:**
|
||||||
|
- Interactive: `mempalace_search(query=<topic>, wing=<wing>)`.
|
||||||
|
- Headless: `mempalace search "<topic>" --wing <wing>`.
|
||||||
|
3. **Knowledge-graph facts** (when `config.mempalace.mirror_kg` is true): `mempalace_kg_query` / `mempalace_kg_timeline` for decisions relevant to the topic and their validity windows. Only `augment` is currently wired, so the palace KG *supplements* GSD's native `.planning/graphs/` — do not treat it as the sole source. (`kg_backend`/`replace` are forward-declared and behave as `augment` today.)
|
||||||
|
4. **Dedup** the returned drawers/facts; keep the top results.
|
||||||
|
|
||||||
|
## Step 4 -- Write MEMORY-RECALL.md
|
||||||
|
|
||||||
|
Write `MEMORY-RECALL.md` in the current phase directory. The planner consumes it.
|
||||||
|
|
||||||
|
When recall succeeded, structure it as:
|
||||||
|
|
||||||
|
```markdown
|
||||||
|
# Memory Recall (MemPalace)
|
||||||
|
|
||||||
|
_Wing: <wing> · Mode: <mode> · Transport: <mcp|cli>_
|
||||||
|
|
||||||
|
## Prior decisions
|
||||||
|
- <decision> — <provenance: drawer id / kg fact, valid_from>
|
||||||
|
|
||||||
|
## Patterns
|
||||||
|
- <pattern> — <provenance>
|
||||||
|
|
||||||
|
## Surprises / gotchas
|
||||||
|
- <surprise> — <provenance>
|
||||||
|
```
|
||||||
|
|
||||||
|
When MemPalace is unreachable, write the stub and continue:
|
||||||
|
|
||||||
|
```markdown
|
||||||
|
# Memory Recall (MemPalace)
|
||||||
|
|
||||||
|
_MemPalace unavailable at recall time — proceeding without recalled memory._
|
||||||
|
```
|
||||||
|
|
||||||
|
## Anti-Patterns
|
||||||
|
|
||||||
|
1. DO NOT let any MemPalace error fail the step -- recall is `onError: skip`.
|
||||||
|
2. DO NOT write to the palace from this skill -- recall is read-only; capture is a separate skill.
|
||||||
|
3. DO NOT paste raw search output into the file -- distil to decisions/patterns/surprises with provenance.
|
||||||
|
4. DO NOT skip the config gate.
|
||||||
51
skills/gsd-milestone-summary/SKILL.md
Normal file
51
skills/gsd-milestone-summary/SKILL.md
Normal file
@@ -0,0 +1,51 @@
|
|||||||
|
---
|
||||||
|
name: gsd-milestone-summary
|
||||||
|
description: "Generate a comprehensive project summary from milestone artifacts for team onboarding and review"
|
||||||
|
argument-hint: "[version]"
|
||||||
|
allowed-tools:
|
||||||
|
- Read
|
||||||
|
- Write
|
||||||
|
- Bash
|
||||||
|
- Grep
|
||||||
|
- Glob
|
||||||
|
---
|
||||||
|
|
||||||
|
|
||||||
|
<objective>
|
||||||
|
Generate a structured milestone summary for team onboarding and project review. Reads completed milestone artifacts (ROADMAP, REQUIREMENTS, CONTEXT, SUMMARY, VERIFICATION files) and produces a human-friendly overview of what was built, how, and why.
|
||||||
|
|
||||||
|
Purpose: Enable new team members to understand a completed project by reading one document and asking follow-up questions.
|
||||||
|
Output: MILESTONE_SUMMARY written to `.planning/reports/`, presented inline, optional interactive Q&A.
|
||||||
|
</objective>
|
||||||
|
|
||||||
|
<execution_context>
|
||||||
|
@~/.claude/gsd-core/workflows/milestone-summary.md
|
||||||
|
</execution_context>
|
||||||
|
|
||||||
|
<context>
|
||||||
|
**Project files:**
|
||||||
|
- `.planning/ROADMAP.md`
|
||||||
|
- `.planning/PROJECT.md`
|
||||||
|
- `.planning/STATE.md`
|
||||||
|
- `.planning/RETROSPECTIVE.md`
|
||||||
|
- `.planning/milestones/v{version}-ROADMAP.md` (if archived)
|
||||||
|
- `.planning/milestones/v{version}-REQUIREMENTS.md` (if archived)
|
||||||
|
- `.planning/phases/*-*/` (SUMMARY.md, VERIFICATION.md, CONTEXT.md, RESEARCH.md)
|
||||||
|
|
||||||
|
**User input:**
|
||||||
|
- Version: $ARGUMENTS (optional — defaults to current/latest milestone)
|
||||||
|
</context>
|
||||||
|
|
||||||
|
<process>
|
||||||
|
Execute end-to-end.
|
||||||
|
</process>
|
||||||
|
|
||||||
|
<success_criteria>
|
||||||
|
- Milestone version resolved (from args, STATE.md, or archive scan)
|
||||||
|
- All available artifacts read (ROADMAP, REQUIREMENTS, CONTEXT, SUMMARY, VERIFICATION, RESEARCH, RETROSPECTIVE)
|
||||||
|
- Summary document written to `.planning/reports/MILESTONE_SUMMARY-v{version}.md`
|
||||||
|
- All 7 sections generated (Overview, Architecture, Phases, Decisions, Requirements, Tech Debt, Getting Started)
|
||||||
|
- Summary presented inline to user
|
||||||
|
- Interactive Q&A offered
|
||||||
|
- STATE.md updated
|
||||||
|
</success_criteria>
|
||||||
45
skills/gsd-mvp-phase/SKILL.md
Normal file
45
skills/gsd-mvp-phase/SKILL.md
Normal file
@@ -0,0 +1,45 @@
|
|||||||
|
---
|
||||||
|
name: gsd-mvp-phase
|
||||||
|
description: "Plan a phase as a vertical MVP slice — user story, SPIDR splitting, then plan-phase"
|
||||||
|
argument-hint: "<phase-number>"
|
||||||
|
allowed-tools:
|
||||||
|
- Read
|
||||||
|
- Write
|
||||||
|
- Bash
|
||||||
|
- Glob
|
||||||
|
- Grep
|
||||||
|
- Agent
|
||||||
|
- AskUserQuestion
|
||||||
|
---
|
||||||
|
|
||||||
|
<objective>
|
||||||
|
Guide the user through MVP-mode planning for a phase. The command:
|
||||||
|
|
||||||
|
1. Prompts for an "As a / I want to / So that" user story (three structured questions)
|
||||||
|
2. Runs SPIDR splitting check — if the story is too large, walks through Spike/Paths/Interfaces/Data/Rules and offers to split into multiple phases
|
||||||
|
3. Writes `**Mode:** mvp` and the reformatted `**Goal:**` to the phase's ROADMAP.md section
|
||||||
|
4. Delegates to `/gsd plan-phase <N>` which auto-detects MVP mode via the roadmap field
|
||||||
|
|
||||||
|
Phase 1 of the vertical-mvp-slice PRD shipped the planner-side machinery; this command is the user entry point for it.
|
||||||
|
</objective>
|
||||||
|
|
||||||
|
<execution_context>
|
||||||
|
@~/.claude/gsd-core/workflows/mvp-phase.md
|
||||||
|
@~/.claude/gsd-core/references/spidr-splitting.md
|
||||||
|
@~/.claude/gsd-core/references/user-story-template.md
|
||||||
|
</execution_context>
|
||||||
|
|
||||||
|
<runtime_note>
|
||||||
|
**Copilot (VS Code):** Use `vscode_askquestions` wherever this workflow calls `AskUserQuestion`. Equivalent API.
|
||||||
|
</runtime_note>
|
||||||
|
|
||||||
|
<context>
|
||||||
|
Phase number: $ARGUMENTS (required — integer or decimal like `2.1`)
|
||||||
|
|
||||||
|
The phase must already exist in ROADMAP.md (created via `/gsd new-project`, `/gsd add-phase`, or `/gsd insert-phase`). This command does not create new phases — it converts an existing phase to MVP mode.
|
||||||
|
</context>
|
||||||
|
|
||||||
|
<process>
|
||||||
|
Execute the mvp-phase workflow from @~/.claude/gsd-core/workflows/mvp-phase.md end-to-end.
|
||||||
|
Preserve all gates: phase existence, status guard (refuse in_progress/completed), user-story format validation, SPIDR splitting check, ROADMAP write confirmation, plan-phase delegation.
|
||||||
|
</process>
|
||||||
45
skills/gsd-new-milestone/SKILL.md
Normal file
45
skills/gsd-new-milestone/SKILL.md
Normal file
@@ -0,0 +1,45 @@
|
|||||||
|
---
|
||||||
|
name: gsd-new-milestone
|
||||||
|
description: "Start a new milestone cycle — update PROJECT.md and route to requirements"
|
||||||
|
argument-hint: "[milestone name, e.g., 'v1.1 Notifications']"
|
||||||
|
allowed-tools:
|
||||||
|
- Read
|
||||||
|
- Write
|
||||||
|
- Bash
|
||||||
|
- Agent
|
||||||
|
- AskUserQuestion
|
||||||
|
---
|
||||||
|
|
||||||
|
<objective>
|
||||||
|
Start a new milestone: questioning → research (optional) → requirements → roadmap.
|
||||||
|
|
||||||
|
Brownfield equivalent of new-project. Project exists, PROJECT.md has history. Gathers "what's next", updates PROJECT.md, then runs requirements → roadmap cycle.
|
||||||
|
|
||||||
|
**Creates/Updates:**
|
||||||
|
- `.planning/PROJECT.md` — updated with new milestone goals
|
||||||
|
- `.planning/research/` — domain research (optional, NEW features only)
|
||||||
|
- `.planning/REQUIREMENTS.md` — scoped requirements for this milestone
|
||||||
|
- `.planning/ROADMAP.md` — phase structure (continues numbering)
|
||||||
|
- `.planning/STATE.md` — reset for new milestone
|
||||||
|
|
||||||
|
**After:** `/gsd-plan-phase [N]` to start execution.
|
||||||
|
</objective>
|
||||||
|
|
||||||
|
<execution_context>
|
||||||
|
@~/.claude/gsd-core/workflows/new-milestone.md
|
||||||
|
@~/.claude/gsd-core/references/questioning.md
|
||||||
|
@~/.claude/gsd-core/references/ui-brand.md
|
||||||
|
@~/.claude/gsd-core/templates/project.md
|
||||||
|
@~/.claude/gsd-core/templates/requirements.md
|
||||||
|
</execution_context>
|
||||||
|
|
||||||
|
<context>
|
||||||
|
Milestone name: $ARGUMENTS (optional - will prompt if not provided)
|
||||||
|
|
||||||
|
Project and milestone context files are resolved inside the workflow (`init new-milestone`) and delegated via `<files_to_read>` blocks where subagents are used.
|
||||||
|
</context>
|
||||||
|
|
||||||
|
<process>
|
||||||
|
Execute end-to-end.
|
||||||
|
Preserve all workflow gates (validation, questioning, research, requirements, roadmap approval, commits).
|
||||||
|
</process>
|
||||||
47
skills/gsd-new-project/SKILL.md
Normal file
47
skills/gsd-new-project/SKILL.md
Normal file
@@ -0,0 +1,47 @@
|
|||||||
|
---
|
||||||
|
name: gsd-new-project
|
||||||
|
description: "Initialize a new project with deep context gathering and PROJECT.md"
|
||||||
|
argument-hint: "[--auto]"
|
||||||
|
allowed-tools:
|
||||||
|
- Read
|
||||||
|
- Bash
|
||||||
|
- Write
|
||||||
|
- Agent
|
||||||
|
- AskUserQuestion
|
||||||
|
---
|
||||||
|
|
||||||
|
<runtime_note>
|
||||||
|
**Copilot (VS Code):** Use `vscode_askquestions` wherever this workflow calls `AskUserQuestion`. They are equivalent — `vscode_askquestions` is the VS Code Copilot implementation of the same interactive question API.
|
||||||
|
</runtime_note>
|
||||||
|
|
||||||
|
<context>
|
||||||
|
**Flags:**
|
||||||
|
- `--auto` — Automatic mode. After config questions, runs research → requirements → roadmap without further interaction. Expects idea document via @ reference.
|
||||||
|
</context>
|
||||||
|
|
||||||
|
<objective>
|
||||||
|
Initialize a new project through unified flow: questioning → research (optional) → requirements → roadmap.
|
||||||
|
|
||||||
|
**Creates:**
|
||||||
|
- `.planning/PROJECT.md` — project context
|
||||||
|
- `.planning/config.json` — workflow preferences
|
||||||
|
- `.planning/research/` — domain research (optional)
|
||||||
|
- `.planning/REQUIREMENTS.md` — scoped requirements
|
||||||
|
- `.planning/ROADMAP.md` — phase structure
|
||||||
|
- `.planning/STATE.md` — project memory
|
||||||
|
|
||||||
|
**After this command:** Run `/gsd-plan-phase 1` to start execution.
|
||||||
|
</objective>
|
||||||
|
|
||||||
|
<execution_context>
|
||||||
|
@~/.claude/gsd-core/workflows/new-project.md
|
||||||
|
@~/.claude/gsd-core/references/questioning.md
|
||||||
|
@~/.claude/gsd-core/references/ui-brand.md
|
||||||
|
@~/.claude/gsd-core/templates/project.md
|
||||||
|
@~/.claude/gsd-core/templates/requirements.md
|
||||||
|
</execution_context>
|
||||||
|
|
||||||
|
<process>
|
||||||
|
Execute end-to-end.
|
||||||
|
Preserve all workflow gates (validation, approvals, commits, routing).
|
||||||
|
</process>
|
||||||
24
skills/gsd-ns-context/SKILL.md
Normal file
24
skills/gsd-ns-context/SKILL.md
Normal file
@@ -0,0 +1,24 @@
|
|||||||
|
---
|
||||||
|
name: gsd-ns-context
|
||||||
|
description: "codebase intel | map graphify docs learnings mempalace"
|
||||||
|
allowed-tools:
|
||||||
|
- Read
|
||||||
|
- Skill
|
||||||
|
---
|
||||||
|
|
||||||
|
|
||||||
|
Route to the appropriate codebase-intelligence skill based on the user's intent.
|
||||||
|
`gsd-scan` and `gsd-intel` were folded into `gsd-map-codebase` flags by #2790.
|
||||||
|
|
||||||
|
| User wants | Invoke |
|
||||||
|
|---|---|
|
||||||
|
| Map the full codebase structure | gsd-map-codebase |
|
||||||
|
| Quick lightweight codebase scan | gsd-map-codebase --fast |
|
||||||
|
| Query mapped intelligence files | gsd-map-codebase --query |
|
||||||
|
| Generate a knowledge graph | gsd-graphify |
|
||||||
|
| Update project documentation | gsd-docs-update |
|
||||||
|
| Extract learnings from a completed phase | gsd-extract-learnings |
|
||||||
|
| Recall prior decisions and patterns before planning | gsd-mempalace-recall |
|
||||||
|
| File a phase artifact into MemPalace | gsd-mempalace-capture |
|
||||||
|
|
||||||
|
Invoke the matched skill directly using the Skill tool.
|
||||||
23
skills/gsd-ns-ideate/SKILL.md
Normal file
23
skills/gsd-ns-ideate/SKILL.md
Normal file
@@ -0,0 +1,23 @@
|
|||||||
|
---
|
||||||
|
name: gsd-ns-ideate
|
||||||
|
description: "exploration capture | explore sketch spike spec capture"
|
||||||
|
allowed-tools:
|
||||||
|
- Read
|
||||||
|
- Skill
|
||||||
|
---
|
||||||
|
|
||||||
|
|
||||||
|
Route to the appropriate exploration / capture skill based on the user's intent.
|
||||||
|
`gsd-note`, `gsd-add-todo`, `gsd-add-backlog`, and `gsd-plant-seed` were folded
|
||||||
|
into `gsd-capture` (with `--note`, default, `--backlog`, `--seed` modes) by
|
||||||
|
#2790. The capture target lists pending todos via `--list`.
|
||||||
|
|
||||||
|
| User wants | Invoke |
|
||||||
|
|---|---|
|
||||||
|
| Explore an idea or opportunity | gsd-explore |
|
||||||
|
| Sketch out a rough design or plan | gsd-sketch |
|
||||||
|
| Time-boxed technical spike | gsd-spike |
|
||||||
|
| Write a spec for a phase | gsd-spec-phase |
|
||||||
|
| Capture a thought (todo / note / backlog / seed) | gsd-capture |
|
||||||
|
|
||||||
|
Invoke the matched skill directly using the Skill tool.
|
||||||
35
skills/gsd-ns-manage/SKILL.md
Normal file
35
skills/gsd-ns-manage/SKILL.md
Normal file
@@ -0,0 +1,35 @@
|
|||||||
|
---
|
||||||
|
name: gsd-ns-manage
|
||||||
|
description: "config workspace | workstreams thread update ship inbox"
|
||||||
|
allowed-tools:
|
||||||
|
- Read
|
||||||
|
- Skill
|
||||||
|
---
|
||||||
|
|
||||||
|
|
||||||
|
Route to the appropriate management skill based on the user's intent.
|
||||||
|
`gsd-config` (settings + advanced + integrations + profile) and `gsd-workspace`
|
||||||
|
(new + list + remove) are post-#2790 consolidated entries.
|
||||||
|
|
||||||
|
| User wants | Invoke |
|
||||||
|
|---|---|
|
||||||
|
| Configure GSD settings (basic / advanced / integrations / profile) | gsd-config |
|
||||||
|
| Manage workspaces (create / list / remove) | gsd-workspace |
|
||||||
|
| Manage parallel workstreams | gsd-workstreams |
|
||||||
|
| Continue work in a fresh context thread | gsd-thread |
|
||||||
|
| Pause current work | gsd-pause-work |
|
||||||
|
| Resume paused work | gsd-resume-work |
|
||||||
|
| Update the GSD installation | gsd-update |
|
||||||
|
| Ship completed work | gsd-ship |
|
||||||
|
| Process inbox items | gsd-inbox |
|
||||||
|
| Create a clean PR branch | gsd-pr-branch |
|
||||||
|
| Undo the last GSD action | gsd-undo |
|
||||||
|
| Archive accumulated phase directories | gsd-cleanup |
|
||||||
|
| Diagnose planning directory health | gsd-health |
|
||||||
|
| Open the interactive command center | gsd-manager |
|
||||||
|
| Configure workflow toggles and model profile | gsd-settings |
|
||||||
|
| Show project statistics | gsd-stats |
|
||||||
|
| Toggle which skills are surfaced | gsd-surface |
|
||||||
|
| Show the GSD command guide | gsd-help |
|
||||||
|
|
||||||
|
Invoke the matched skill directly using the Skill tool.
|
||||||
26
skills/gsd-ns-project/SKILL.md
Normal file
26
skills/gsd-ns-project/SKILL.md
Normal file
@@ -0,0 +1,26 @@
|
|||||||
|
---
|
||||||
|
name: gsd-ns-project
|
||||||
|
description: "project lifecycle | milestones audits summary"
|
||||||
|
allowed-tools:
|
||||||
|
- Read
|
||||||
|
- Skill
|
||||||
|
---
|
||||||
|
|
||||||
|
|
||||||
|
Route to the appropriate project / milestone skill based on the user's intent.
|
||||||
|
`gsd-plan-milestone-gaps` was deleted by #2790 — gap planning now happens
|
||||||
|
inline as part of `gsd-audit-milestone`'s output.
|
||||||
|
|
||||||
|
| User wants | Invoke |
|
||||||
|
|---|---|
|
||||||
|
| Start a new project | gsd-new-project |
|
||||||
|
| Create a new milestone | gsd-new-milestone |
|
||||||
|
| Complete the current milestone | gsd-complete-milestone |
|
||||||
|
| Audit a milestone for issues | gsd-audit-milestone |
|
||||||
|
| Summarize milestone status | gsd-milestone-summary |
|
||||||
|
| Import an external plan | gsd-import |
|
||||||
|
| Bootstrap planning from existing docs | gsd-ingest-docs |
|
||||||
|
| Generate a developer profile | gsd-profile-user |
|
||||||
|
| Review and promote backlog items | gsd-review-backlog |
|
||||||
|
|
||||||
|
Invoke the matched skill directly using the Skill tool.
|
||||||
28
skills/gsd-ns-review/SKILL.md
Normal file
28
skills/gsd-ns-review/SKILL.md
Normal file
@@ -0,0 +1,28 @@
|
|||||||
|
---
|
||||||
|
name: gsd-ns-review
|
||||||
|
description: "quality gates | code review debug audit security eval ui"
|
||||||
|
allowed-tools:
|
||||||
|
- Read
|
||||||
|
- Skill
|
||||||
|
---
|
||||||
|
|
||||||
|
|
||||||
|
Route to the appropriate quality / review skill based on the user's intent.
|
||||||
|
`gsd-code-review-fix` was absorbed by `gsd-code-review --fix` in #2790.
|
||||||
|
|
||||||
|
| User wants | Invoke |
|
||||||
|
|---|---|
|
||||||
|
| Review code for quality and correctness | gsd-code-review |
|
||||||
|
| Auto-fix code review findings | gsd-code-review --fix |
|
||||||
|
| Audit UAT / acceptance testing | gsd-audit-uat |
|
||||||
|
| Security review of a phase | gsd-secure-phase |
|
||||||
|
| Evaluate AI response quality | gsd-eval-review |
|
||||||
|
| Review UI for design and accessibility | gsd-ui-review |
|
||||||
|
| Validate phase outputs | gsd-validate-phase |
|
||||||
|
| Debug a failing feature or error | gsd-debug |
|
||||||
|
| Forensic investigation of a broken system | gsd-forensics |
|
||||||
|
| Autonomous audit-to-fix pipeline | gsd-audit-fix |
|
||||||
|
| Cross-AI peer review of plans | gsd-review |
|
||||||
|
| Generate a UI design contract | gsd-ui-phase |
|
||||||
|
|
||||||
|
Invoke the matched skill directly using the Skill tool.
|
||||||
33
skills/gsd-ns-workflow/SKILL.md
Normal file
33
skills/gsd-ns-workflow/SKILL.md
Normal file
@@ -0,0 +1,33 @@
|
|||||||
|
---
|
||||||
|
name: gsd-ns-workflow
|
||||||
|
description: "workflow | discuss plan execute verify phase progress"
|
||||||
|
allowed-tools:
|
||||||
|
- Read
|
||||||
|
- Skill
|
||||||
|
---
|
||||||
|
|
||||||
|
|
||||||
|
Route to the appropriate phase-pipeline skill based on the user's intent.
|
||||||
|
Sub-skill names below are post-#2790 consolidated targets — `gsd-phase`
|
||||||
|
absorbs the former add/insert/remove/edit-phase commands and `gsd-progress`
|
||||||
|
absorbs the former next/do commands.
|
||||||
|
|
||||||
|
| User wants | Invoke |
|
||||||
|
|---|---|
|
||||||
|
| Gather context before planning | gsd-discuss-phase |
|
||||||
|
| Clarify what a phase delivers | gsd-spec-phase |
|
||||||
|
| Create a PLAN.md | gsd-plan-phase |
|
||||||
|
| Execute plans in a phase | gsd-execute-phase |
|
||||||
|
| Verify built features through UAT | gsd-verify-work |
|
||||||
|
| Add / insert / remove / edit a phase | gsd-phase |
|
||||||
|
| Advance to the next logical step | gsd-progress |
|
||||||
|
| Offload planning to the ultraplan cloud | gsd-ultraplan-phase |
|
||||||
|
| Cross-AI plan review convergence loop | gsd-plan-review-convergence |
|
||||||
|
| Generate tests for a completed phase | gsd-add-tests |
|
||||||
|
| Design an AI-integration phase | gsd-ai-integration-phase |
|
||||||
|
| Run all remaining phases autonomously | gsd-autonomous |
|
||||||
|
| Execute a trivial task inline | gsd-fast |
|
||||||
|
| Plan a phase as a vertical MVP slice | gsd-mvp-phase |
|
||||||
|
| Execute a quick task with GSD guarantees | gsd-quick |
|
||||||
|
|
||||||
|
Invoke the matched skill directly using the Skill tool.
|
||||||
43
skills/gsd-pause-work/SKILL.md
Normal file
43
skills/gsd-pause-work/SKILL.md
Normal file
@@ -0,0 +1,43 @@
|
|||||||
|
---
|
||||||
|
name: gsd-pause-work
|
||||||
|
description: "Create context handoff when pausing work mid-phase"
|
||||||
|
argument-hint: "[--report]"
|
||||||
|
allowed-tools:
|
||||||
|
- Read
|
||||||
|
- Write
|
||||||
|
- Bash
|
||||||
|
---
|
||||||
|
|
||||||
|
|
||||||
|
<objective>
|
||||||
|
Create `.continue-here.md` handoff file to preserve complete work state across sessions.
|
||||||
|
|
||||||
|
Routes to the pause-work workflow which handles:
|
||||||
|
- Current phase detection from recent files
|
||||||
|
- Complete state gathering (position, completed work, remaining work, decisions, blockers)
|
||||||
|
- Handoff file creation with all context sections
|
||||||
|
- Git commit as WIP
|
||||||
|
- Resume instructions
|
||||||
|
</objective>
|
||||||
|
|
||||||
|
<execution_context>
|
||||||
|
@~/.claude/gsd-core/workflows/pause-work.md
|
||||||
|
</execution_context>
|
||||||
|
|
||||||
|
<context>
|
||||||
|
State and phase progress are gathered in-workflow with targeted reads.
|
||||||
|
</context>
|
||||||
|
|
||||||
|
<process>
|
||||||
|
If `--report` is in $ARGUMENTS:
|
||||||
|
Read and execute `~/.claude/gsd-core/workflows/session-report.md` end-to-end.
|
||||||
|
|
||||||
|
**Follow the pause-work workflow**.
|
||||||
|
|
||||||
|
The workflow handles all logic including:
|
||||||
|
1. Phase directory detection
|
||||||
|
2. State gathering with user clarifications
|
||||||
|
3. Handoff file writing with timestamp
|
||||||
|
4. Git commit
|
||||||
|
5. Confirmation with resume instructions
|
||||||
|
</process>
|
||||||
57
skills/gsd-phase/SKILL.md
Normal file
57
skills/gsd-phase/SKILL.md
Normal file
@@ -0,0 +1,57 @@
|
|||||||
|
---
|
||||||
|
name: gsd-phase
|
||||||
|
description: "CRUD for phases in ROADMAP.md — add, insert, remove, or edit phases"
|
||||||
|
argument-hint: "[--insert | --remove | --edit] <phase-name-or-number>"
|
||||||
|
allowed-tools:
|
||||||
|
- Read
|
||||||
|
- Write
|
||||||
|
- Bash
|
||||||
|
- Glob
|
||||||
|
---
|
||||||
|
|
||||||
|
|
||||||
|
<objective>
|
||||||
|
Manage phases in ROADMAP.md with a single consolidated command.
|
||||||
|
|
||||||
|
Mode routing:
|
||||||
|
- **default** (no flag): Add a new integer phase to the end of the current milestone → add-phase workflow
|
||||||
|
- **--insert**: Insert urgent work as a decimal phase (e.g., 72.1) between existing phases → insert-phase workflow
|
||||||
|
- **--remove**: Remove a future phase and renumber subsequent phases → remove-phase workflow
|
||||||
|
- **--edit**: Edit any field of an existing phase in place → edit-phase workflow
|
||||||
|
</objective>
|
||||||
|
|
||||||
|
<routing>
|
||||||
|
|
||||||
|
| Flag | Action | Workflow |
|
||||||
|
|------|--------|----------|
|
||||||
|
| (none) | Add new integer phase at end of milestone | add-phase |
|
||||||
|
| --insert | Insert decimal phase (e.g., 72.1) after specified phase | insert-phase |
|
||||||
|
| --remove | Remove future phase, renumber subsequent | remove-phase |
|
||||||
|
| --edit | Edit fields of existing phase in place | edit-phase |
|
||||||
|
|
||||||
|
</routing>
|
||||||
|
|
||||||
|
<execution_context>
|
||||||
|
@~/.claude/gsd-core/workflows/add-phase.md
|
||||||
|
@~/.claude/gsd-core/workflows/insert-phase.md
|
||||||
|
@~/.claude/gsd-core/workflows/remove-phase.md
|
||||||
|
@~/.claude/gsd-core/workflows/edit-phase.md
|
||||||
|
</execution_context>
|
||||||
|
|
||||||
|
<context>
|
||||||
|
Arguments: $ARGUMENTS
|
||||||
|
|
||||||
|
Parse the first token of $ARGUMENTS:
|
||||||
|
- If it is `--insert`: strip the flag, pass remainder (format: <after-phase-number> <description>) to insert-phase workflow
|
||||||
|
- If it is `--remove`: strip the flag, pass remainder (phase number) to remove-phase workflow
|
||||||
|
- If it is `--edit`: strip the flag, pass remainder (phase-number [--force]) to edit-phase workflow
|
||||||
|
- Otherwise: pass all of $ARGUMENTS (phase description) to add-phase workflow
|
||||||
|
|
||||||
|
Roadmap and state are resolved in-workflow via `init phase-op` and targeted reads.
|
||||||
|
</context>
|
||||||
|
|
||||||
|
<process>
|
||||||
|
1. Parse the leading flag (if any) from $ARGUMENTS.
|
||||||
|
2. Load and execute the appropriate workflow end-to-end based on the routing table above.
|
||||||
|
3. Preserve all validation gates from the target workflow.
|
||||||
|
</process>
|
||||||
63
skills/gsd-plan-phase/SKILL.md
Normal file
63
skills/gsd-plan-phase/SKILL.md
Normal file
@@ -0,0 +1,63 @@
|
|||||||
|
---
|
||||||
|
name: gsd-plan-phase
|
||||||
|
description: "Create detailed phase plan (PLAN.md) with verification loop"
|
||||||
|
argument-hint: "[phase] [--auto] [--research] [--skip-research] [--research-phase <N>] [--view] [--gaps] [--skip-verify] [--prd <file>] [--ingest <path-or-glob>] [--ingest-format <auto|nygard|madr|narrative>] [--reviews] [--text] [--tdd] [--mvp]"
|
||||||
|
effort: max
|
||||||
|
allowed-tools:
|
||||||
|
- Read
|
||||||
|
- Write
|
||||||
|
- Bash
|
||||||
|
- Glob
|
||||||
|
- Grep
|
||||||
|
- Agent
|
||||||
|
- AskUserQuestion
|
||||||
|
- WebFetch
|
||||||
|
- mcp__context7__*
|
||||||
|
---
|
||||||
|
|
||||||
|
<objective>
|
||||||
|
Create executable phase prompts (PLAN.md files) for a roadmap phase with integrated research and verification.
|
||||||
|
|
||||||
|
**Default flow:** Research (if needed) → Plan → Verify → Done
|
||||||
|
|
||||||
|
**Research-only mode (`--research-phase <N>`):** Spawn `gsd-phase-researcher` for phase `N`, write `RESEARCH.md`, then exit before the planner runs. Useful for cross-phase research, doc review before committing to a planning approach, and correction-without-replanning loops where iterating on research alone is dramatically cheaper than re-spawning the planner. Replaces the deleted research-phase command (#3042).
|
||||||
|
|
||||||
|
**Research-only modifiers:**
|
||||||
|
- **No flag** — when `RESEARCH.md` already exists, auto-uses it: emits a one-line notice and exits cleanly, no prompt.
|
||||||
|
- **`--research`** — force-refresh: re-spawn the researcher unconditionally, no prompt. Bypasses the existing-RESEARCH.md auto-use path.
|
||||||
|
- **`--view`** — view-only: print existing `RESEARCH.md` to stdout. Does not spawn the researcher. Cheapest mode for the correction-without-replanning loop. If no `RESEARCH.md` exists yet, errors with a hint to drop `--view`.
|
||||||
|
|
||||||
|
**Orchestrator role:** Parse arguments, validate phase, research domain (unless skipped), spawn gsd-planner, verify with gsd-plan-checker, iterate until pass or max iterations, present results.
|
||||||
|
</objective>
|
||||||
|
|
||||||
|
<execution_context>
|
||||||
|
@~/.claude/gsd-core/workflows/plan-phase.md
|
||||||
|
@~/.claude/gsd-core/references/ui-brand.md
|
||||||
|
</execution_context>
|
||||||
|
|
||||||
|
<runtime_note>
|
||||||
|
**Copilot (VS Code):** Use `vscode_askquestions` wherever this workflow calls `AskUserQuestion`. They are equivalent — `vscode_askquestions` is the VS Code Copilot implementation of the same interactive question API. Do not skip questioning steps because `AskUserQuestion` appears unavailable; use `vscode_askquestions` instead.
|
||||||
|
</runtime_note>
|
||||||
|
|
||||||
|
<context>
|
||||||
|
Phase number: $ARGUMENTS (optional — auto-detects next unplanned phase if omitted)
|
||||||
|
|
||||||
|
**Flags:**
|
||||||
|
- `--research` — Force re-research even if RESEARCH.md exists
|
||||||
|
- `--skip-research` — Skip research, go straight to planning
|
||||||
|
- `--gaps` — Gap closure mode (reads VERIFICATION.md, skips research)
|
||||||
|
- `--skip-verify` — Skip verification loop
|
||||||
|
- `--prd <file>` — Use a PRD/acceptance criteria file instead of discuss-phase. Parses requirements into CONTEXT.md automatically. Skips discuss-phase entirely.
|
||||||
|
- `--ingest <path-or-glob>` — Use one or more ADR files instead of discuss-phase. Parses locked decisions + scope fences into CONTEXT.md automatically. Skips discuss-phase entirely.
|
||||||
|
- `--ingest-format <auto|nygard|madr|narrative>` — Optional ADR parser format override (`auto` default).
|
||||||
|
- `--reviews` — Replan incorporating cross-AI review feedback from REVIEWS.md (produced by `/gsd-review`)
|
||||||
|
- `--text` — Use plain-text numbered lists instead of TUI menus (required for `/rc` remote sessions)
|
||||||
|
- `--mvp` — Vertical MVP mode. Planner organizes tasks as feature slices (UI→API→DB) instead of horizontal layers. On Phase 1 of a new project, also emits `SKELETON.md` (Walking Skeleton). Can be persisted on a phase via `**Mode:** mvp` in ROADMAP.md.
|
||||||
|
|
||||||
|
Normalize phase input in step 2 before any directory lookups.
|
||||||
|
</context>
|
||||||
|
|
||||||
|
<process>
|
||||||
|
Execute end-to-end.
|
||||||
|
Preserve all workflow gates (validation, research, planning, verification loop, routing).
|
||||||
|
</process>
|
||||||
60
skills/gsd-plan-review-convergence/SKILL.md
Normal file
60
skills/gsd-plan-review-convergence/SKILL.md
Normal file
@@ -0,0 +1,60 @@
|
|||||||
|
---
|
||||||
|
name: gsd-plan-review-convergence
|
||||||
|
description: "Cross-AI plan convergence - replan until review concerns are resolved."
|
||||||
|
argument-hint: "<phase> [--codex] [--gemini] [--claude] [--opencode] [--ollama] [--lm-studio] [--llama-cpp] [--text] [--ws <name>] [--all] [--max-cycles N]"
|
||||||
|
allowed-tools:
|
||||||
|
- Read
|
||||||
|
- Write
|
||||||
|
- Bash
|
||||||
|
- Glob
|
||||||
|
- Grep
|
||||||
|
- Agent
|
||||||
|
- Skill
|
||||||
|
- AskUserQuestion
|
||||||
|
---
|
||||||
|
|
||||||
|
|
||||||
|
<objective>
|
||||||
|
Cross-AI plan convergence loop — an outer revision gate around gsd-review and gsd-planner.
|
||||||
|
Repeatedly: review plans with external AI CLIs → if HIGH or actionable non-HIGH concerns remain → replan with --reviews feedback → re-review. Stops when no unresolved HIGH concerns or actionable MEDIUM/LOW findings remain outside PLAN.md, or when max cycles is reached.
|
||||||
|
|
||||||
|
**Flow:** Skill("gsd-plan-phase") → Agent→Skill("gsd-review") → check unresolved HIGH + actionable non-HIGH → Skill("gsd-plan-phase --reviews") → Agent→Skill("gsd-review") → ... → Converge or escalate
|
||||||
|
|
||||||
|
Replaces gsd-plan-phase's internal gsd-plan-checker with external AI reviewers (codex, gemini, etc.). Plan-phase runs **inline** (bare Skill at depth 0) so it can spawn gsd-planner/gsd-plan-checker at depth 1. Review runs inside an isolated Agent (gsd-review is a Bash leaf — no sub-agents needed). Orchestrator only does loop control.
|
||||||
|
|
||||||
|
**Orchestrator role:** Parse arguments, validate phase, run plan-phase inline (Skill at depth 0), spawn an Agent for gsd-review, check unresolved HIGH and actionable non-HIGH counts, stall detection, escalation gate.
|
||||||
|
</objective>
|
||||||
|
|
||||||
|
<execution_context>
|
||||||
|
@$HOME/.claude/gsd-core/workflows/plan-review-convergence.md
|
||||||
|
@$HOME/.claude/gsd-core/references/revision-loop.md
|
||||||
|
@$HOME/.claude/gsd-core/references/gates.md
|
||||||
|
@$HOME/.claude/gsd-core/references/agent-contracts.md
|
||||||
|
</execution_context>
|
||||||
|
|
||||||
|
<runtime_note>
|
||||||
|
**Copilot (VS Code):** Use `vscode_askquestions` wherever this workflow calls `AskUserQuestion`. They are equivalent — `vscode_askquestions` is the VS Code Copilot implementation of the same interactive question API. Do not skip questioning steps because `AskUserQuestion` appears unavailable; use `vscode_askquestions` instead.
|
||||||
|
</runtime_note>
|
||||||
|
|
||||||
|
<context>
|
||||||
|
Phase number: extracted from $ARGUMENTS (required)
|
||||||
|
|
||||||
|
**Flags:**
|
||||||
|
- `--codex` — Use Codex CLI as reviewer (default if no reviewer specified)
|
||||||
|
- `--gemini` — Use Gemini CLI as reviewer
|
||||||
|
- `--claude` — Use Claude CLI as reviewer (separate session)
|
||||||
|
- `--opencode` — Use OpenCode as reviewer
|
||||||
|
- `--ollama` — Use local Ollama server as reviewer (OpenAI-compatible, default host `http://localhost:11434`; configure model via `review.models.ollama`)
|
||||||
|
- `--lm-studio` — Use local LM Studio server as reviewer (OpenAI-compatible, default host `http://localhost:1234`; configure model via `review.models.lm_studio`)
|
||||||
|
- `--llama-cpp` — Use local llama.cpp server as reviewer (OpenAI-compatible, default host `http://localhost:8080`; configure model via `review.models.llama_cpp`)
|
||||||
|
- `--all` — Use all available CLIs and running local model servers
|
||||||
|
- `--max-cycles N` — Maximum replan→review cycles (default: 3)
|
||||||
|
|
||||||
|
**Feature gate:** This command requires `workflow.plan_review_convergence=true`. Enable with:
|
||||||
|
`gsd config-set workflow.plan_review_convergence true`
|
||||||
|
</context>
|
||||||
|
|
||||||
|
<process>
|
||||||
|
Execute end-to-end.
|
||||||
|
Preserve all workflow gates (pre-flight, revision loop, stall detection, escalation).
|
||||||
|
</process>
|
||||||
26
skills/gsd-pr-branch/SKILL.md
Normal file
26
skills/gsd-pr-branch/SKILL.md
Normal file
@@ -0,0 +1,26 @@
|
|||||||
|
---
|
||||||
|
name: gsd-pr-branch
|
||||||
|
description: "Create a clean PR branch by filtering out .planning/ commits — ready for code review"
|
||||||
|
argument-hint: "[target branch, default: main]"
|
||||||
|
allowed-tools:
|
||||||
|
- Bash
|
||||||
|
- Read
|
||||||
|
- AskUserQuestion
|
||||||
|
---
|
||||||
|
|
||||||
|
|
||||||
|
<objective>
|
||||||
|
Create a clean branch suitable for pull requests by filtering out .planning/ commits
|
||||||
|
from the current branch. Reviewers see only code changes, not GSD planning artifacts.
|
||||||
|
|
||||||
|
This solves the problem of PR diffs being cluttered with PLAN.md, SUMMARY.md, STATE.md
|
||||||
|
changes that are irrelevant to code review.
|
||||||
|
</objective>
|
||||||
|
|
||||||
|
<execution_context>
|
||||||
|
@~/.claude/gsd-core/workflows/pr-branch.md
|
||||||
|
</execution_context>
|
||||||
|
|
||||||
|
<process>
|
||||||
|
Execute end-to-end.
|
||||||
|
</process>
|
||||||
47
skills/gsd-profile-user/SKILL.md
Normal file
47
skills/gsd-profile-user/SKILL.md
Normal file
@@ -0,0 +1,47 @@
|
|||||||
|
---
|
||||||
|
name: gsd-profile-user
|
||||||
|
description: "Generate developer behavioral profile and create Claude-discoverable artifacts"
|
||||||
|
argument-hint: "[--questionnaire] [--refresh]"
|
||||||
|
allowed-tools:
|
||||||
|
- Read
|
||||||
|
- Write
|
||||||
|
- Bash
|
||||||
|
- Glob
|
||||||
|
- Grep
|
||||||
|
- AskUserQuestion
|
||||||
|
- Agent
|
||||||
|
---
|
||||||
|
|
||||||
|
|
||||||
|
<objective>
|
||||||
|
Generate a developer behavioral profile from session analysis (or questionnaire) and produce artifacts (USER-PROFILE.md, `gsd-dev-preferences` skill config, CLAUDE.md section) that personalize Claude's responses.
|
||||||
|
|
||||||
|
Routes to the profile-user workflow which orchestrates the full flow: consent gate, session analysis or questionnaire fallback, profile generation, result display, and artifact selection.
|
||||||
|
</objective>
|
||||||
|
|
||||||
|
<execution_context>
|
||||||
|
@~/.claude/gsd-core/workflows/profile-user.md
|
||||||
|
@~/.claude/gsd-core/references/ui-brand.md
|
||||||
|
</execution_context>
|
||||||
|
|
||||||
|
<context>
|
||||||
|
Flags from $ARGUMENTS:
|
||||||
|
- `--questionnaire` -- Skip session analysis entirely, use questionnaire-only path
|
||||||
|
- `--refresh` -- Rebuild profile even when one exists, backup old profile, show dimension diff
|
||||||
|
</context>
|
||||||
|
|
||||||
|
<process>
|
||||||
|
Execute the profile-user workflow end-to-end.
|
||||||
|
|
||||||
|
The workflow handles all logic including:
|
||||||
|
1. Initialization and existing profile detection
|
||||||
|
2. Consent gate before session analysis
|
||||||
|
3. Session scanning and data sufficiency checks
|
||||||
|
4. Session analysis (profiler agent) or questionnaire fallback
|
||||||
|
5. Cross-project split resolution
|
||||||
|
6. Profile writing to USER-PROFILE.md
|
||||||
|
7. Result display with report card and highlights
|
||||||
|
8. Artifact selection (dev-preferences, CLAUDE.md sections)
|
||||||
|
9. Sequential artifact generation
|
||||||
|
10. Summary with refresh diff (if applicable)
|
||||||
|
</process>
|
||||||
49
skills/gsd-progress/SKILL.md
Normal file
49
skills/gsd-progress/SKILL.md
Normal file
@@ -0,0 +1,49 @@
|
|||||||
|
---
|
||||||
|
name: gsd-progress
|
||||||
|
description: "Check progress, advance workflow, or dispatch freeform intent — the unified GSD situational command"
|
||||||
|
argument-hint: "[--forensic | --next [--auto] [--converge] | --do \\\"task description\\\"]"
|
||||||
|
effort: low
|
||||||
|
allowed-tools:
|
||||||
|
- Read
|
||||||
|
- Bash
|
||||||
|
- Grep
|
||||||
|
- Glob
|
||||||
|
- SlashCommand
|
||||||
|
- AskUserQuestion
|
||||||
|
---
|
||||||
|
|
||||||
|
<objective>
|
||||||
|
Check project progress, summarize recent work and what's ahead, then intelligently route to the next action.
|
||||||
|
|
||||||
|
Three modes:
|
||||||
|
- **default**: Show progress report + intelligently route to the next action (execute or plan). Provides situational awareness before continuing work.
|
||||||
|
- **--next**: Automatically advance to the next logical step without manual route selection. Reads STATE.md, ROADMAP.md, and phase directories. Supports `--force` to bypass safety gates.
|
||||||
|
- **--do "task description"**: Analyze freeform natural language and dispatch to the most appropriate GSD command. Never does the work itself — matches intent, confirms, hands off.
|
||||||
|
- **--forensic**: Append a 6-check integrity audit after the standard progress report.
|
||||||
|
</objective>
|
||||||
|
|
||||||
|
<flags>
|
||||||
|
- **--next**: Detect current project state and automatically invoke the next logical GSD workflow step. Scans all prior phases for incomplete work before routing. `--next --force` bypasses safety gates.
|
||||||
|
- **--next --auto**: Like `--next`, but after the determined step completes, automatically re-invokes `/gsd-progress --next --auto` to continue chaining steps until completion or a blocking decision. Enables hands-free plan→execute→verify→complete progression.
|
||||||
|
- **--next --converge**: When the next action is planning (Route 3), route it through the plan-review **convergence** loop instead of the standard planner. Requires `workflow.plan_review_convergence=true` (enable with `gsd config-set workflow.plan_review_convergence true`). `--cross-ai` is an alias. Reviewer flags (`--codex`, `--gemini`, `--claude`, `--opencode`, `--ollama`, `--lm-studio`, `--llama-cpp`, `--all`) and `--max-cycles N` are forwarded to the convergence loop.
|
||||||
|
- **--do "..."**: Smart dispatcher — match freeform intent to the best GSD command using routing rules, confirm the match, then hand off.
|
||||||
|
- **--forensic**: Run 6-check integrity audit after the standard progress report.
|
||||||
|
- **(no flag)**: Standard progress check + intelligent routing (Routes A through F).
|
||||||
|
</flags>
|
||||||
|
|
||||||
|
<execution_context>
|
||||||
|
@~/.claude/gsd-core/workflows/progress.md
|
||||||
|
@~/.claude/gsd-core/workflows/next.md
|
||||||
|
@~/.claude/gsd-core/workflows/do.md
|
||||||
|
@~/.claude/gsd-core/references/ui-brand.md
|
||||||
|
</execution_context>
|
||||||
|
|
||||||
|
<process>
|
||||||
|
Arguments provided: "$ARGUMENTS"
|
||||||
|
Parse the first token from the provided arguments:
|
||||||
|
- If it is `--next`: strip the flag, execute the next workflow (passing remaining args e.g. --force, --auto).
|
||||||
|
- If it is `--do`: strip the flag, pass remainder as freeform intent to the do workflow.
|
||||||
|
- Otherwise: execute the progress workflow end-to-end (pass --forensic through if present).
|
||||||
|
|
||||||
|
Preserve all routing logic from the target workflow.
|
||||||
|
</process>
|
||||||
174
skills/gsd-quick/SKILL.md
Normal file
174
skills/gsd-quick/SKILL.md
Normal file
@@ -0,0 +1,174 @@
|
|||||||
|
---
|
||||||
|
name: gsd-quick
|
||||||
|
description: "Execute a quick task with GSD guarantees (atomic commits, state tracking) but skip optional agents"
|
||||||
|
argument-hint: "[list | status <slug> | resume <slug> | --full] [--validate] [--discuss] [--research] [task description]"
|
||||||
|
allowed-tools:
|
||||||
|
- Read
|
||||||
|
- Write
|
||||||
|
- Edit
|
||||||
|
- Glob
|
||||||
|
- Grep
|
||||||
|
- Bash
|
||||||
|
- Agent
|
||||||
|
- AskUserQuestion
|
||||||
|
---
|
||||||
|
|
||||||
|
<objective>
|
||||||
|
Execute small, ad-hoc tasks with GSD guarantees (atomic commits, STATE.md tracking).
|
||||||
|
|
||||||
|
Quick mode is the same system with a shorter path:
|
||||||
|
- Spawns gsd-planner (quick mode) + gsd-executor(s)
|
||||||
|
- Quick tasks live in `.planning/quick/` separate from planned phases
|
||||||
|
- Updates STATE.md "Quick Tasks Completed" table (NOT ROADMAP.md)
|
||||||
|
|
||||||
|
**Default:** Skips research, discussion, plan-checker, verifier. Use when you know exactly what to do.
|
||||||
|
|
||||||
|
**`--discuss` flag:** Lightweight discussion phase before planning. Surfaces assumptions, clarifies gray areas, captures decisions in CONTEXT.md. Use when the task has ambiguity worth resolving upfront.
|
||||||
|
|
||||||
|
**`--full` flag:** Enables the complete quality pipeline — discussion + research + plan-checking + verification. One flag for everything.
|
||||||
|
|
||||||
|
**`--validate` flag:** Enables plan-checking (max 2 iterations) and post-execution verification only. Use when you want quality guarantees without discussion or research.
|
||||||
|
|
||||||
|
**`--research` flag:** Spawns a focused research agent before planning. Investigates implementation approaches, library options, and pitfalls for the task. Use when you're unsure of the best approach.
|
||||||
|
|
||||||
|
Granular flags are composable: `--discuss --research --validate` gives the same result as `--full`.
|
||||||
|
|
||||||
|
**Subcommands:**
|
||||||
|
- `list` — List all quick tasks with status
|
||||||
|
- `status <slug>` — Show status of a specific quick task
|
||||||
|
- `resume <slug>` — Resume a specific quick task by slug
|
||||||
|
</objective>
|
||||||
|
|
||||||
|
<execution_context>
|
||||||
|
@~/.claude/gsd-core/workflows/quick.md
|
||||||
|
</execution_context>
|
||||||
|
|
||||||
|
<context>
|
||||||
|
$ARGUMENTS
|
||||||
|
|
||||||
|
Context files are resolved inside the workflow (`init quick`) and delegated via `<files_to_read>` blocks.
|
||||||
|
</context>
|
||||||
|
|
||||||
|
<process>
|
||||||
|
|
||||||
|
**Parse $ARGUMENTS for subcommands FIRST:**
|
||||||
|
|
||||||
|
- If $ARGUMENTS starts with "list": SUBCMD=list
|
||||||
|
- If $ARGUMENTS starts with "status ": SUBCMD=status, SLUG=remainder (strip whitespace, sanitize)
|
||||||
|
- If $ARGUMENTS starts with "resume ": SUBCMD=resume, SLUG=remainder (strip whitespace, sanitize)
|
||||||
|
- Otherwise: SUBCMD=run, pass full $ARGUMENTS to the quick workflow as-is
|
||||||
|
|
||||||
|
**Slug sanitization (for status and resume):** Strip any characters not matching `[a-z0-9-]`. Reject slugs longer than 60 chars or containing `..` or `/`. If invalid, output "Invalid session slug." and stop.
|
||||||
|
|
||||||
|
## LIST subcommand
|
||||||
|
|
||||||
|
When SUBCMD=list:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
ls -d .planning/quick/*/ 2>/dev/null
|
||||||
|
```
|
||||||
|
|
||||||
|
For each directory found:
|
||||||
|
- Check if PLAN.md exists
|
||||||
|
- Check if SUMMARY.md exists; if so, read `status` from its frontmatter via:
|
||||||
|
```bash
|
||||||
|
gsd-tools query frontmatter.get .planning/quick/{dir}/SUMMARY.md status
|
||||||
|
```
|
||||||
|
- Determine directory creation date: `stat -f "%SB" -t "%Y-%m-%d"` (macOS) or `stat -c "%w"` (Linux); fall back to the date prefix in the directory name (format: `YYYYMMDD-` prefix)
|
||||||
|
- Derive display status:
|
||||||
|
- SUMMARY.md exists, frontmatter status=complete → `complete ✓`
|
||||||
|
- SUMMARY.md exists, frontmatter status=incomplete OR status missing → `incomplete`
|
||||||
|
- SUMMARY.md missing, dir created <7 days ago → `in-progress`
|
||||||
|
- SUMMARY.md missing, dir created ≥7 days ago → `abandoned? (>7 days, no summary)`
|
||||||
|
|
||||||
|
**SECURITY:** Directory names are read from the filesystem. Before displaying any slug, sanitize: strip non-printable characters, ANSI escape sequences, and path separators using: `name.replace(/[^\x20-\x7E]/g, '').replace(/[/\\]/g, '')`. Never pass raw directory names to shell commands via string interpolation.
|
||||||
|
|
||||||
|
Display format:
|
||||||
|
```
|
||||||
|
Quick Tasks
|
||||||
|
────────────────────────────────────────────────────────────
|
||||||
|
slug date status
|
||||||
|
backup-s3-policy 2026-04-10 in-progress
|
||||||
|
auth-token-refresh-fix 2026-04-09 complete ✓
|
||||||
|
update-node-deps 2026-04-08 abandoned? (>7 days, no summary)
|
||||||
|
────────────────────────────────────────────────────────────
|
||||||
|
3 tasks (1 complete, 2 incomplete/in-progress)
|
||||||
|
```
|
||||||
|
|
||||||
|
If no directories found: print `No quick tasks found.` and stop.
|
||||||
|
|
||||||
|
STOP after displaying the list. Do NOT proceed to further steps.
|
||||||
|
|
||||||
|
## STATUS subcommand
|
||||||
|
|
||||||
|
When SUBCMD=status and SLUG is set (already sanitized):
|
||||||
|
|
||||||
|
Find directory matching `*-{SLUG}` pattern:
|
||||||
|
```bash
|
||||||
|
dir=$(ls -d .planning/quick/*-{SLUG}/ 2>/dev/null | head -1)
|
||||||
|
```
|
||||||
|
|
||||||
|
If no directory found, print `No quick task found with slug: {SLUG}` and stop.
|
||||||
|
|
||||||
|
Read PLAN.md and SUMMARY.md (if exists) for the given slug. Display:
|
||||||
|
```
|
||||||
|
Quick Task: {slug}
|
||||||
|
─────────────────────────────────────
|
||||||
|
Plan file: .planning/quick/{dir}/PLAN.md
|
||||||
|
Status: {status from SUMMARY.md frontmatter, or "no summary yet"}
|
||||||
|
Description: {first non-empty line from PLAN.md after frontmatter}
|
||||||
|
Last action: {last meaningful line of SUMMARY.md, or "none"}
|
||||||
|
─────────────────────────────────────
|
||||||
|
Resume with: /gsd-quick resume {slug}
|
||||||
|
```
|
||||||
|
|
||||||
|
No agent spawn. STOP after printing.
|
||||||
|
|
||||||
|
## RESUME subcommand
|
||||||
|
|
||||||
|
When SUBCMD=resume and SLUG is set (already sanitized):
|
||||||
|
|
||||||
|
1. Find the directory matching `*-{SLUG}` pattern:
|
||||||
|
```bash
|
||||||
|
dir=$(ls -d .planning/quick/*-{SLUG}/ 2>/dev/null | head -1)
|
||||||
|
```
|
||||||
|
2. If no directory found, print `No quick task found with slug: {SLUG}` and stop.
|
||||||
|
|
||||||
|
3. Read PLAN.md to extract description and SUMMARY.md (if exists) to extract status.
|
||||||
|
|
||||||
|
4. Print before spawning:
|
||||||
|
```
|
||||||
|
[quick] Resuming: .planning/quick/{dir}/
|
||||||
|
[quick] Plan: {description from PLAN.md}
|
||||||
|
[quick] Status: {status from SUMMARY.md, or "in-progress"}
|
||||||
|
```
|
||||||
|
|
||||||
|
5. Load context via:
|
||||||
|
```bash
|
||||||
|
gsd-tools query init.quick
|
||||||
|
```
|
||||||
|
|
||||||
|
6. Proceed to execute the quick workflow with resume context, passing the slug and plan directory so the executor picks up where it left off.
|
||||||
|
|
||||||
|
## RUN subcommand (default)
|
||||||
|
|
||||||
|
When SUBCMD=run:
|
||||||
|
|
||||||
|
Execute end-to-end.
|
||||||
|
Preserve all workflow gates (validation, task description, planning, execution, state updates, commits).
|
||||||
|
|
||||||
|
</process>
|
||||||
|
|
||||||
|
<notes>
|
||||||
|
- Quick tasks live in `.planning/quick/` — separate from phases, not tracked in ROADMAP.md
|
||||||
|
- Each quick task gets a `YYYYMMDD-{slug}/` directory with PLAN.md and eventually SUMMARY.md
|
||||||
|
- STATE.md "Quick Tasks Completed" table is updated on completion
|
||||||
|
- Use `list` to audit accumulated tasks; use `resume` to continue in-progress work
|
||||||
|
</notes>
|
||||||
|
|
||||||
|
<security_notes>
|
||||||
|
- Slugs from $ARGUMENTS are sanitized before use in file paths: only [a-z0-9-] allowed, max 60 chars, reject ".." and "/"
|
||||||
|
- File names from readdir/ls are sanitized before display: strip non-printable chars and ANSI sequences
|
||||||
|
- Artifact content (plan descriptions, task titles) rendered as plain text only — never executed or passed to agent prompts without DATA_START/DATA_END boundaries
|
||||||
|
- Status fields read via `gsd-tools query frontmatter.get` — never eval'd or shell-expanded
|
||||||
|
</security_notes>
|
||||||
31
skills/gsd-resume-work/SKILL.md
Normal file
31
skills/gsd-resume-work/SKILL.md
Normal file
@@ -0,0 +1,31 @@
|
|||||||
|
---
|
||||||
|
name: gsd-resume-work
|
||||||
|
description: "Resume work from previous session with full context restoration"
|
||||||
|
allowed-tools:
|
||||||
|
- Read
|
||||||
|
- Bash
|
||||||
|
- Write
|
||||||
|
- AskUserQuestion
|
||||||
|
- SlashCommand
|
||||||
|
---
|
||||||
|
|
||||||
|
|
||||||
|
<objective>
|
||||||
|
Restore complete project context and resume work seamlessly from previous session.
|
||||||
|
|
||||||
|
Routes to the resume-project workflow which handles:
|
||||||
|
|
||||||
|
- STATE.md loading (or reconstruction if missing)
|
||||||
|
- Checkpoint detection (.continue-here files)
|
||||||
|
- Incomplete work detection (PLAN without SUMMARY)
|
||||||
|
- Status presentation
|
||||||
|
- Context-aware next action routing
|
||||||
|
</objective>
|
||||||
|
|
||||||
|
<execution_context>
|
||||||
|
@~/.claude/gsd-core/workflows/resume-project.md
|
||||||
|
</execution_context>
|
||||||
|
|
||||||
|
<process>
|
||||||
|
Execute end-to-end.
|
||||||
|
</process>
|
||||||
63
skills/gsd-review-backlog/SKILL.md
Normal file
63
skills/gsd-review-backlog/SKILL.md
Normal file
@@ -0,0 +1,63 @@
|
|||||||
|
---
|
||||||
|
name: gsd-review-backlog
|
||||||
|
description: "Review and promote backlog items to active milestone"
|
||||||
|
allowed-tools:
|
||||||
|
- Read
|
||||||
|
- Write
|
||||||
|
- Bash
|
||||||
|
- AskUserQuestion
|
||||||
|
---
|
||||||
|
|
||||||
|
|
||||||
|
<objective>
|
||||||
|
Review all 999.x backlog items and optionally promote them into the active
|
||||||
|
milestone sequence or remove stale entries.
|
||||||
|
</objective>
|
||||||
|
|
||||||
|
<process>
|
||||||
|
|
||||||
|
1. **List backlog items:**
|
||||||
|
```bash
|
||||||
|
ls -d .planning/phases/999* 2>/dev/null || echo "No backlog items found"
|
||||||
|
```
|
||||||
|
|
||||||
|
2. **Read ROADMAP.md** and extract all 999.x phase entries:
|
||||||
|
```bash
|
||||||
|
cat .planning/ROADMAP.md
|
||||||
|
```
|
||||||
|
Show each backlog item with its description, any accumulated context (CONTEXT.md, RESEARCH.md), and creation date.
|
||||||
|
|
||||||
|
3. **Present the list to the user** via AskUserQuestion:
|
||||||
|
- For each backlog item, show: phase number, description, accumulated artifacts
|
||||||
|
- Options per item: **Promote** (move to active), **Keep** (leave in backlog), **Remove** (delete)
|
||||||
|
|
||||||
|
4. **For items to PROMOTE:**
|
||||||
|
- Find the next sequential phase number in the active milestone
|
||||||
|
- Rename the directory from `999.x-slug` to `{new_num}-slug`:
|
||||||
|
```bash
|
||||||
|
NEW_NUM=$(gsd-tools query phase.add "${DESCRIPTION}" --raw)
|
||||||
|
```
|
||||||
|
- Move accumulated artifacts to the new phase directory
|
||||||
|
- Update ROADMAP.md: move the entry from `## Backlog` section to the active phase list
|
||||||
|
- Remove `(BACKLOG)` marker
|
||||||
|
- Add appropriate `**Depends on:**` field
|
||||||
|
|
||||||
|
5. **For items to REMOVE:**
|
||||||
|
- Delete the phase directory
|
||||||
|
- Remove the entry from ROADMAP.md `## Backlog` section
|
||||||
|
|
||||||
|
6. **Commit changes:**
|
||||||
|
```bash
|
||||||
|
gsd-tools query commit "docs: review backlog — promoted N, removed M" --files .planning/ROADMAP.md
|
||||||
|
```
|
||||||
|
|
||||||
|
7. **Report summary:**
|
||||||
|
```
|
||||||
|
## 📋 Backlog Review Complete
|
||||||
|
|
||||||
|
Promoted: {list of promoted items with new phase numbers}
|
||||||
|
Kept: {list of items remaining in backlog}
|
||||||
|
Removed: {list of deleted items}
|
||||||
|
```
|
||||||
|
|
||||||
|
</process>
|
||||||
42
skills/gsd-review/SKILL.md
Normal file
42
skills/gsd-review/SKILL.md
Normal file
@@ -0,0 +1,42 @@
|
|||||||
|
---
|
||||||
|
name: gsd-review
|
||||||
|
description: "Request cross-AI peer review of phase plans from external AI CLIs"
|
||||||
|
argument-hint: "--phase N [--gemini] [--claude] [--codex] [--opencode] [--qwen] [--cursor] [--agy] [--all]"
|
||||||
|
allowed-tools:
|
||||||
|
- Read
|
||||||
|
- Write
|
||||||
|
- Bash
|
||||||
|
- Glob
|
||||||
|
- Grep
|
||||||
|
---
|
||||||
|
|
||||||
|
|
||||||
|
<objective>
|
||||||
|
Invoke external AI CLIs (Gemini, Claude, Codex, OpenCode, Qwen Code, Cursor) to independently review phase plans.
|
||||||
|
Produces a structured REVIEWS.md with per-reviewer feedback that can be fed back into
|
||||||
|
planning via /gsd-plan-phase --reviews.
|
||||||
|
|
||||||
|
**Flow:** Detect CLIs → Build review prompt → Invoke each CLI → Collect responses → Write REVIEWS.md
|
||||||
|
</objective>
|
||||||
|
|
||||||
|
<execution_context>
|
||||||
|
@~/.claude/gsd-core/workflows/review.md
|
||||||
|
</execution_context>
|
||||||
|
|
||||||
|
<context>
|
||||||
|
Phase number: extracted from $ARGUMENTS (required)
|
||||||
|
|
||||||
|
**Flags:**
|
||||||
|
- `--gemini` — Include Gemini CLI review
|
||||||
|
- `--claude` — Include Claude CLI review (uses separate session)
|
||||||
|
- `--codex` — Include Codex CLI review
|
||||||
|
- `--opencode` — Include OpenCode review (uses model from user's OpenCode config)
|
||||||
|
- `--qwen` — Include Qwen Code review (Alibaba Qwen models)
|
||||||
|
- `--cursor` — Include Cursor agent review
|
||||||
|
- `--agy` / `--antigravity` — Include Antigravity CLI review
|
||||||
|
- `--all` — Include all available CLIs
|
||||||
|
</context>
|
||||||
|
|
||||||
|
<process>
|
||||||
|
Execute end-to-end.
|
||||||
|
</process>
|
||||||
36
skills/gsd-secure-phase/SKILL.md
Normal file
36
skills/gsd-secure-phase/SKILL.md
Normal file
@@ -0,0 +1,36 @@
|
|||||||
|
---
|
||||||
|
name: gsd-secure-phase
|
||||||
|
description: "Retroactively verify threat mitigations for a completed phase"
|
||||||
|
argument-hint: "[phase number]"
|
||||||
|
allowed-tools:
|
||||||
|
- Read
|
||||||
|
- Write
|
||||||
|
- Edit
|
||||||
|
- Bash
|
||||||
|
- Glob
|
||||||
|
- Grep
|
||||||
|
- Agent
|
||||||
|
- AskUserQuestion
|
||||||
|
---
|
||||||
|
|
||||||
|
<objective>
|
||||||
|
Verify threat mitigations for a completed phase. Three states:
|
||||||
|
- (A) SECURITY.md exists — audit and verify mitigations
|
||||||
|
- (B) No SECURITY.md, PLAN.md with threat model exists — run from artifacts
|
||||||
|
- (C) Phase not executed — exit with guidance
|
||||||
|
|
||||||
|
Output: updated SECURITY.md.
|
||||||
|
</objective>
|
||||||
|
|
||||||
|
<execution_context>
|
||||||
|
@~/.claude/gsd-core/workflows/secure-phase.md
|
||||||
|
</execution_context>
|
||||||
|
|
||||||
|
<context>
|
||||||
|
Phase: $ARGUMENTS — optional, defaults to last completed phase.
|
||||||
|
</context>
|
||||||
|
|
||||||
|
<process>
|
||||||
|
Execute end-to-end.
|
||||||
|
Preserve all workflow gates.
|
||||||
|
</process>
|
||||||
29
skills/gsd-settings/SKILL.md
Normal file
29
skills/gsd-settings/SKILL.md
Normal file
@@ -0,0 +1,29 @@
|
|||||||
|
---
|
||||||
|
name: gsd-settings
|
||||||
|
description: "Configure GSD workflow toggles and model profile"
|
||||||
|
allowed-tools:
|
||||||
|
- Read
|
||||||
|
- Write
|
||||||
|
- Bash
|
||||||
|
- AskUserQuestion
|
||||||
|
---
|
||||||
|
|
||||||
|
|
||||||
|
<objective>
|
||||||
|
Interactive configuration of GSD workflow agents and model profile via multi-question prompt.
|
||||||
|
|
||||||
|
Routes to the settings workflow which handles:
|
||||||
|
- Config existence ensuring
|
||||||
|
- Current settings reading and parsing
|
||||||
|
- Interactive 5-question prompt (model, research, plan_check, verifier, branching)
|
||||||
|
- Config merging and writing
|
||||||
|
- Confirmation display with quick command references
|
||||||
|
</objective>
|
||||||
|
|
||||||
|
<execution_context>
|
||||||
|
@~/.claude/gsd-core/workflows/settings.md
|
||||||
|
</execution_context>
|
||||||
|
|
||||||
|
<process>
|
||||||
|
Execute end-to-end.
|
||||||
|
</process>
|
||||||
24
skills/gsd-ship/SKILL.md
Normal file
24
skills/gsd-ship/SKILL.md
Normal file
@@ -0,0 +1,24 @@
|
|||||||
|
---
|
||||||
|
name: gsd-ship
|
||||||
|
description: "Create PR, run review, and prepare for merge after verification passes"
|
||||||
|
argument-hint: "[phase number or milestone, e.g., '4' or 'v1.0']"
|
||||||
|
allowed-tools:
|
||||||
|
- Read
|
||||||
|
- Bash
|
||||||
|
- Grep
|
||||||
|
- Glob
|
||||||
|
- Write
|
||||||
|
- AskUserQuestion
|
||||||
|
---
|
||||||
|
|
||||||
|
<objective>
|
||||||
|
Bridge local completion → merged PR. After /gsd-verify-work passes, ship the work: push branch, create PR with auto-generated body, optionally trigger review, and track the merge.
|
||||||
|
|
||||||
|
Closes the plan → execute → verify → ship loop.
|
||||||
|
</objective>
|
||||||
|
|
||||||
|
<execution_context>
|
||||||
|
@~/.claude/gsd-core/workflows/ship.md
|
||||||
|
</execution_context>
|
||||||
|
|
||||||
|
Execute the ship workflow from @~/.claude/gsd-core/workflows/ship.md end-to-end.
|
||||||
60
skills/gsd-sketch/SKILL.md
Normal file
60
skills/gsd-sketch/SKILL.md
Normal file
@@ -0,0 +1,60 @@
|
|||||||
|
---
|
||||||
|
name: gsd-sketch
|
||||||
|
description: "Sketch UI/design ideas with throwaway HTML mockups, or propose what to sketch next (frontier mode)"
|
||||||
|
argument-hint: "[design idea to explore] [--quick] [--text] [--wrap-up] or [frontier]"
|
||||||
|
allowed-tools:
|
||||||
|
- Read
|
||||||
|
- Write
|
||||||
|
- Edit
|
||||||
|
- Bash
|
||||||
|
- Grep
|
||||||
|
- Glob
|
||||||
|
- AskUserQuestion
|
||||||
|
- WebSearch
|
||||||
|
- WebFetch
|
||||||
|
- mcp__context7__resolve-library-id
|
||||||
|
- mcp__context7__query-docs
|
||||||
|
---
|
||||||
|
|
||||||
|
<objective>
|
||||||
|
Explore design directions through throwaway HTML mockups before committing to implementation.
|
||||||
|
Each sketch produces 2-3 variants for comparison. Sketches live in `.planning/sketches/` and
|
||||||
|
integrate with GSD commit patterns, state tracking, and handoff workflows. Loads spike
|
||||||
|
findings to ground mockups in real data shapes and validated interaction patterns.
|
||||||
|
|
||||||
|
Two modes:
|
||||||
|
- **Idea mode** (default) — describe a design idea to sketch
|
||||||
|
- **Frontier mode** (no argument or "frontier") — analyzes existing sketch landscape and proposes consistency and frontier sketches
|
||||||
|
|
||||||
|
Does not require prior new-project setup — auto-creates `.planning/sketches/` if needed.
|
||||||
|
</objective>
|
||||||
|
|
||||||
|
<execution_context>
|
||||||
|
@~/.claude/gsd-core/workflows/sketch.md
|
||||||
|
@~/.claude/gsd-core/workflows/sketch-wrap-up.md
|
||||||
|
@~/.claude/gsd-core/references/ui-brand.md
|
||||||
|
@~/.claude/gsd-core/references/sketch-theme-system.md
|
||||||
|
@~/.claude/gsd-core/references/sketch-interactivity.md
|
||||||
|
@~/.claude/gsd-core/references/sketch-tooling.md
|
||||||
|
@~/.claude/gsd-core/references/sketch-variant-patterns.md
|
||||||
|
</execution_context>
|
||||||
|
|
||||||
|
<runtime_note>
|
||||||
|
**Copilot (VS Code):** Use `vscode_askquestions` wherever this workflow calls `AskUserQuestion`.
|
||||||
|
</runtime_note>
|
||||||
|
|
||||||
|
<context>
|
||||||
|
Design idea: $ARGUMENTS
|
||||||
|
|
||||||
|
**Available flags:**
|
||||||
|
- `--quick` — Skip mood/direction intake, jump straight to decomposition and building. Use when the design direction is already clear.
|
||||||
|
- `--wrap-up` — Package sketch design findings into a persistent project skill for future build conversations. Runs the sketch-wrap-up workflow.
|
||||||
|
</context>
|
||||||
|
|
||||||
|
<process>
|
||||||
|
Parse the first token of $ARGUMENTS:
|
||||||
|
- If it is `--wrap-up`: strip the flag, execute the sketch-wrap-up workflow end-to-end.
|
||||||
|
- Otherwise: execute the sketch workflow end-to-end.
|
||||||
|
|
||||||
|
Preserve all workflow gates (intake, decomposition, target stack research, variant evaluation, MANIFEST updates, commit patterns).
|
||||||
|
</process>
|
||||||
63
skills/gsd-spec-phase/SKILL.md
Normal file
63
skills/gsd-spec-phase/SKILL.md
Normal file
@@ -0,0 +1,63 @@
|
|||||||
|
---
|
||||||
|
name: gsd-spec-phase
|
||||||
|
description: "Clarify WHAT a phase delivers with ambiguity scoring; produces a SPEC.md before discuss-phase."
|
||||||
|
argument-hint: "<phase> [--auto] [--text]"
|
||||||
|
allowed-tools:
|
||||||
|
- Read
|
||||||
|
- Write
|
||||||
|
- Bash
|
||||||
|
- Glob
|
||||||
|
- Grep
|
||||||
|
- AskUserQuestion
|
||||||
|
---
|
||||||
|
|
||||||
|
|
||||||
|
<objective>
|
||||||
|
Clarify phase requirements through structured Socratic questioning with quantitative ambiguity scoring.
|
||||||
|
|
||||||
|
**Position in workflow:** `spec-phase → discuss-phase → plan-phase → execute-phase → verify`
|
||||||
|
|
||||||
|
**How it works:**
|
||||||
|
1. Load phase context (PROJECT.md, REQUIREMENTS.md, ROADMAP.md, STATE.md)
|
||||||
|
2. Scout the codebase — understand current state before asking questions
|
||||||
|
3. Run Socratic interview loop (up to 6 rounds, rotating perspectives)
|
||||||
|
4. Score ambiguity across 4 weighted dimensions after each round
|
||||||
|
5. Gate: ambiguity ≤ 0.20 AND all dimensions meet minimums → write SPEC.md
|
||||||
|
6. Commit SPEC.md — discuss-phase picks it up automatically on next run
|
||||||
|
|
||||||
|
**Output:** `{phase_dir}/{padded_phase}-SPEC.md` — falsifiable requirements that lock "what/why" before discuss-phase handles "how"
|
||||||
|
</objective>
|
||||||
|
|
||||||
|
<execution_context>
|
||||||
|
@~/.claude/gsd-core/workflows/spec-phase.md
|
||||||
|
@~/.claude/gsd-core/templates/spec.md
|
||||||
|
</execution_context>
|
||||||
|
|
||||||
|
<runtime_note>
|
||||||
|
**Copilot (VS Code):** Use `vscode_askquestions` wherever this workflow calls `AskUserQuestion`. They are equivalent.
|
||||||
|
</runtime_note>
|
||||||
|
|
||||||
|
<context>
|
||||||
|
Phase number: $ARGUMENTS (required)
|
||||||
|
|
||||||
|
**Flags:**
|
||||||
|
- `--auto` — Skip interactive questions; Claude selects recommended defaults and writes SPEC.md
|
||||||
|
- `--text` — Use plain-text numbered lists instead of TUI menus (required for `/rc` remote sessions)
|
||||||
|
|
||||||
|
Context files are resolved in-workflow using `init phase-op`.
|
||||||
|
</context>
|
||||||
|
|
||||||
|
<process>
|
||||||
|
Execute end-to-end.
|
||||||
|
|
||||||
|
**MANDATORY:** Read the workflow file BEFORE taking any action. The workflow contains the complete step-by-step process including the Socratic interview loop, ambiguity scoring gate, and SPEC.md generation. Do not improvise from the objective summary above.
|
||||||
|
</process>
|
||||||
|
|
||||||
|
<success_criteria>
|
||||||
|
- Codebase scouted for current state before questioning begins
|
||||||
|
- All 4 ambiguity dimensions scored after each interview round
|
||||||
|
- Gate passed: ambiguity ≤ 0.20 AND all dimension minimums met
|
||||||
|
- SPEC.md written with falsifiable requirements, explicit boundaries, and acceptance criteria
|
||||||
|
- SPEC.md committed atomically
|
||||||
|
- User knows they can now run /gsd-discuss-phase which will load SPEC.md automatically
|
||||||
|
</success_criteria>
|
||||||
57
skills/gsd-spike/SKILL.md
Normal file
57
skills/gsd-spike/SKILL.md
Normal file
@@ -0,0 +1,57 @@
|
|||||||
|
---
|
||||||
|
name: gsd-spike
|
||||||
|
description: "Spike an idea through experiential exploration, or propose what to spike next (frontier mode)"
|
||||||
|
argument-hint: "[idea to validate] [--quick] [--text] [--wrap-up] or [frontier]"
|
||||||
|
allowed-tools:
|
||||||
|
- Read
|
||||||
|
- Write
|
||||||
|
- Edit
|
||||||
|
- Bash
|
||||||
|
- Grep
|
||||||
|
- Glob
|
||||||
|
- AskUserQuestion
|
||||||
|
- WebSearch
|
||||||
|
- WebFetch
|
||||||
|
- mcp__context7__resolve-library-id
|
||||||
|
- mcp__context7__query-docs
|
||||||
|
---
|
||||||
|
|
||||||
|
<objective>
|
||||||
|
Spike an idea through experiential exploration — build focused experiments to feel the pieces
|
||||||
|
of a future app, validate feasibility, and produce verified knowledge for the real build.
|
||||||
|
Spikes live in `.planning/spikes/` and integrate with GSD commit patterns, state tracking,
|
||||||
|
and handoff workflows.
|
||||||
|
|
||||||
|
Two modes:
|
||||||
|
- **Idea mode** (default) — describe an idea to spike
|
||||||
|
- **Frontier mode** (no argument or "frontier") — analyzes existing spike landscape and proposes integration and frontier spikes
|
||||||
|
|
||||||
|
Does not require prior new-project setup — auto-creates `.planning/spikes/` if needed.
|
||||||
|
</objective>
|
||||||
|
|
||||||
|
<execution_context>
|
||||||
|
@~/.claude/gsd-core/workflows/spike.md
|
||||||
|
@~/.claude/gsd-core/workflows/spike-wrap-up.md
|
||||||
|
@~/.claude/gsd-core/references/ui-brand.md
|
||||||
|
</execution_context>
|
||||||
|
|
||||||
|
<runtime_note>
|
||||||
|
**Copilot (VS Code):** Use `vscode_askquestions` wherever this workflow calls `AskUserQuestion`.
|
||||||
|
</runtime_note>
|
||||||
|
|
||||||
|
<context>
|
||||||
|
Idea: $ARGUMENTS
|
||||||
|
|
||||||
|
**Available flags:**
|
||||||
|
- `--quick` — Skip decomposition/alignment, jump straight to building. Use when you already know what to spike.
|
||||||
|
- `--text` — Use plain-text numbered lists instead of AskUserQuestion (for non-Claude runtimes).
|
||||||
|
- `--wrap-up` — Package spike findings into a persistent project skill for future build conversations. Runs the spike-wrap-up workflow.
|
||||||
|
</context>
|
||||||
|
|
||||||
|
<process>
|
||||||
|
Parse the first token of $ARGUMENTS:
|
||||||
|
- If it is `--wrap-up`: strip the flag, execute the spike-wrap-up workflow
|
||||||
|
- Otherwise: pass all of $ARGUMENTS as the idea to the spike workflow end-to-end.
|
||||||
|
|
||||||
|
Preserve all workflow gates (prior spike check, decomposition, research, risk ordering, observability assessment, verification, MANIFEST updates, commit patterns).
|
||||||
|
</process>
|
||||||
20
skills/gsd-stats/SKILL.md
Normal file
20
skills/gsd-stats/SKILL.md
Normal file
@@ -0,0 +1,20 @@
|
|||||||
|
---
|
||||||
|
name: gsd-stats
|
||||||
|
description: "Display project statistics — phases, plans, requirements, git metrics, and timeline"
|
||||||
|
effort: low
|
||||||
|
allowed-tools:
|
||||||
|
- Read
|
||||||
|
- Bash
|
||||||
|
---
|
||||||
|
|
||||||
|
<objective>
|
||||||
|
Display comprehensive project statistics including phase progress, plan execution metrics, requirements completion, git history stats, and project timeline.
|
||||||
|
</objective>
|
||||||
|
|
||||||
|
<execution_context>
|
||||||
|
@~/.claude/gsd-core/workflows/stats.md
|
||||||
|
</execution_context>
|
||||||
|
|
||||||
|
<process>
|
||||||
|
Execute end-to-end.
|
||||||
|
</process>
|
||||||
162
skills/gsd-surface/SKILL.md
Normal file
162
skills/gsd-surface/SKILL.md
Normal file
@@ -0,0 +1,162 @@
|
|||||||
|
---
|
||||||
|
name: gsd-surface
|
||||||
|
description: "Toggle which skills are surfaced — apply a profile, list, or disable a cluster without reinstall"
|
||||||
|
argument-hint: "[list|status|profile <name>|disable <cluster>|enable <cluster>|reset]"
|
||||||
|
allowed-tools:
|
||||||
|
- Read
|
||||||
|
- Write
|
||||||
|
- Bash
|
||||||
|
---
|
||||||
|
|
||||||
|
|
||||||
|
<objective>
|
||||||
|
Manage the runtime skill surface without reinstall. Reads/writes `~/.claude/.gsd-surface.json`
|
||||||
|
(sibling to `~/.claude/.gsd-profile`) and re-stages the active skills directory in place.
|
||||||
|
Skill dirs live at `~/.claude/skills/gsd-*/`.
|
||||||
|
|
||||||
|
Sub-commands: list · status · profile · disable · enable · reset
|
||||||
|
</objective>
|
||||||
|
|
||||||
|
## Sub-command routing
|
||||||
|
|
||||||
|
Parse the first token of $ARGUMENTS:
|
||||||
|
|
||||||
|
| Token | Action |
|
||||||
|
|---|---|
|
||||||
|
| `list` | Show enabled + disabled clusters and skills |
|
||||||
|
| `status` | Alias for `list` plus token cost summary |
|
||||||
|
| `profile <name>` | Write `baseProfile` and re-stage |
|
||||||
|
| `profile <n1>,<n2>` | Composed profiles (comma-separated, no spaces) |
|
||||||
|
| `disable <cluster>` | Add cluster to `disabledClusters`, re-stage |
|
||||||
|
| `enable <cluster>` | Remove cluster from `disabledClusters`, re-stage |
|
||||||
|
| `reset` | Delete `.gsd-surface.json`, return to install-time profile |
|
||||||
|
| *(none)* | Treat as `list` |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## list / status
|
||||||
|
|
||||||
|
Load the capability registry and call `listSurface(runtimeConfigDir, manifest, CLUSTERS, registry)` from
|
||||||
|
`gsd-core/bin/lib/surface.cjs`. The registry is loaded via:
|
||||||
|
```js
|
||||||
|
const registry = require('gsd-core/bin/lib/capability-registry.cjs');
|
||||||
|
```
|
||||||
|
Display:
|
||||||
|
|
||||||
|
```
|
||||||
|
Enabled (N skills, ~T tokens):
|
||||||
|
core_loop: new-project discuss-phase plan-phase execute-phase help update
|
||||||
|
audit_review: …
|
||||||
|
…
|
||||||
|
|
||||||
|
Disabled:
|
||||||
|
utility: health stats settings …
|
||||||
|
|
||||||
|
Token cost: ~T (budget cap ~500 tokens for 200k context @ 1%)
|
||||||
|
```
|
||||||
|
|
||||||
|
For `status` also append:
|
||||||
|
|
||||||
|
```
|
||||||
|
Base profile: standard (from .gsd-surface.json)
|
||||||
|
Install profile: standard (from .gsd-profile)
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## profile \<name\>
|
||||||
|
|
||||||
|
1. Read current surface: `readSurface(runtimeConfigDir)` → if null, seed from `readActiveProfile(runtimeConfigDir)`.
|
||||||
|
2. Set `surfaceState.baseProfile = name`.
|
||||||
|
3. `writeSurface(runtimeConfigDir, surfaceState)`.
|
||||||
|
4. Resolve and re-apply:
|
||||||
|
```js
|
||||||
|
const registry = require('gsd-core/bin/lib/capability-registry.cjs');
|
||||||
|
const layout = resolveRuntimeArtifactLayout(runtime, runtimeConfigDir, scope);
|
||||||
|
applySurface(runtimeConfigDir, layout, manifest, CLUSTERS, registry);
|
||||||
|
```
|
||||||
|
5. Confirm: "Surface updated to profile `<name>`. N skills enabled."
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## disable \<cluster\>
|
||||||
|
|
||||||
|
Valid cluster names: `core_loop`, `audit_review`, `milestone`, `research_ideate`,
|
||||||
|
`workspace_state`, `docs`, `ui`, `ai_eval`, `ns_meta`, `utility`.
|
||||||
|
|
||||||
|
1. Validate cluster name against `Object.keys(CLUSTERS)`.
|
||||||
|
2. Read or initialize surface state.
|
||||||
|
3. Add cluster to `surfaceState.disabledClusters` (deduplicate).
|
||||||
|
4. `writeSurface` → resolve layout → `applySurface`:
|
||||||
|
```js
|
||||||
|
const registry = require('gsd-core/bin/lib/capability-registry.cjs');
|
||||||
|
const layout = resolveRuntimeArtifactLayout(runtime, runtimeConfigDir, scope);
|
||||||
|
applySurface(runtimeConfigDir, layout, manifest, CLUSTERS, registry);
|
||||||
|
```
|
||||||
|
5. Confirm: "Disabled cluster `<cluster>`. N skills removed from surface."
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## enable \<cluster\>
|
||||||
|
|
||||||
|
1. Read surface state; if null, nothing to enable — print "No surface delta active."
|
||||||
|
2. Remove cluster from `surfaceState.disabledClusters`.
|
||||||
|
3. `writeSurface` → resolve layout → `applySurface`:
|
||||||
|
```js
|
||||||
|
const registry = require('gsd-core/bin/lib/capability-registry.cjs');
|
||||||
|
const layout = resolveRuntimeArtifactLayout(runtime, runtimeConfigDir, scope);
|
||||||
|
applySurface(runtimeConfigDir, layout, manifest, CLUSTERS, registry);
|
||||||
|
```
|
||||||
|
4. Confirm: "Enabled cluster `<cluster>`. N skills added back to surface."
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## reset
|
||||||
|
|
||||||
|
1. Check if `.gsd-surface.json` exists.
|
||||||
|
2. Delete it.
|
||||||
|
3. Re-apply using only `readActiveProfile(runtimeConfigDir)` (install-time profile).
|
||||||
|
4. Confirm: "Surface reset to install-time profile `<name>`."
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## runtimeConfigDir resolution
|
||||||
|
|
||||||
|
The `runtimeConfigDir` for `applySurface` is the **base Claude config directory**
|
||||||
|
(`~/.claude`), NOT the skills sub-directory (`~/.claude/skills`).
|
||||||
|
|
||||||
|
This matches `installRuntimeArtifacts` and `uninstallRuntimeArtifacts`, which also
|
||||||
|
receive `~/.claude` as `configDir`. The skill dirs themselves live at
|
||||||
|
`~/.claude/skills/gsd-*/` because the `claude global` layout has `destSubpath =
|
||||||
|
'skills'` — they are derived from `configDir`, not the root for it.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Claude Code — global install
|
||||||
|
RUNTIME_CONFIG_DIR="${CLAUDE_CONFIG_DIR:-$HOME/.claude}"
|
||||||
|
SCOPE="global"
|
||||||
|
|
||||||
|
# Artifact destinations are derived from runtime layout
|
||||||
|
# via resolveRuntimeArtifactLayout(runtime, RUNTIME_CONFIG_DIR, SCOPE)
|
||||||
|
# then applySurface(RUNTIME_CONFIG_DIR, layout, manifest, CLUSTERS)
|
||||||
|
```
|
||||||
|
|
||||||
|
Surface state is stored at `${RUNTIME_CONFIG_DIR}/.gsd-surface.json`
|
||||||
|
(i.e. `~/.claude/.gsd-surface.json`).
|
||||||
|
|
||||||
|
All paths can be overridden by reading the `CLAUDE_CONFIG_DIR` env var if set.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Error handling
|
||||||
|
|
||||||
|
- Unknown cluster name → list valid cluster names, exit without writing.
|
||||||
|
- Unknown profile name → list known profiles (`core`, `standard`, `full`), exit.
|
||||||
|
- Missing `surface.cjs` → prompt: "Run `npm i -g gsd-core` to reinstall GSD."
|
||||||
|
|
||||||
|
<execution_context>
|
||||||
|
Surface state file: `~/.claude/.gsd-surface.json`
|
||||||
|
Install profile marker: `~/.claude/.gsd-profile`
|
||||||
|
Skill dirs: `~/.claude/skills/gsd-*/`
|
||||||
|
Engine module: `~/.claude/gsd-core/bin/lib/surface.cjs`
|
||||||
|
Cluster definitions: `~/.claude/gsd-core/bin/lib/clusters.cjs`
|
||||||
|
</execution_context>
|
||||||
24
skills/gsd-thread/SKILL.md
Normal file
24
skills/gsd-thread/SKILL.md
Normal file
@@ -0,0 +1,24 @@
|
|||||||
|
---
|
||||||
|
name: gsd-thread
|
||||||
|
description: "Manage persistent context threads for cross-session work"
|
||||||
|
argument-hint: "[list [--open | --resolved] | close <slug> | status <slug> | name | description]"
|
||||||
|
allowed-tools:
|
||||||
|
- Read
|
||||||
|
- Write
|
||||||
|
- Bash
|
||||||
|
---
|
||||||
|
|
||||||
|
|
||||||
|
<objective>
|
||||||
|
Create, list, close, or resume persistent context threads. Threads are lightweight
|
||||||
|
cross-session knowledge stores for work that spans multiple sessions but
|
||||||
|
doesn't belong to any specific phase.
|
||||||
|
</objective>
|
||||||
|
|
||||||
|
<execution_context>
|
||||||
|
@~/.claude/gsd-core/workflows/thread.md
|
||||||
|
</execution_context>
|
||||||
|
|
||||||
|
<process>
|
||||||
|
Execute end-to-end.
|
||||||
|
</process>
|
||||||
35
skills/gsd-ui-phase/SKILL.md
Normal file
35
skills/gsd-ui-phase/SKILL.md
Normal file
@@ -0,0 +1,35 @@
|
|||||||
|
---
|
||||||
|
name: gsd-ui-phase
|
||||||
|
description: "Generate UI design contract (UI-SPEC.md) for frontend phases"
|
||||||
|
argument-hint: "[phase]"
|
||||||
|
allowed-tools:
|
||||||
|
- Read
|
||||||
|
- Write
|
||||||
|
- Bash
|
||||||
|
- Glob
|
||||||
|
- Grep
|
||||||
|
- Agent
|
||||||
|
- WebFetch
|
||||||
|
- AskUserQuestion
|
||||||
|
- mcp__context7__*
|
||||||
|
---
|
||||||
|
|
||||||
|
<objective>
|
||||||
|
Create a UI design contract (UI-SPEC.md) for a frontend phase.
|
||||||
|
Orchestrates gsd-ui-researcher and gsd-ui-checker.
|
||||||
|
Flow: Validate → Research UI → Verify UI-SPEC → Done
|
||||||
|
</objective>
|
||||||
|
|
||||||
|
<execution_context>
|
||||||
|
@~/.claude/gsd-core/workflows/ui-phase.md
|
||||||
|
@~/.claude/gsd-core/references/ui-brand.md
|
||||||
|
</execution_context>
|
||||||
|
|
||||||
|
<context>
|
||||||
|
Phase number: $ARGUMENTS — optional, auto-detects next unplanned phase if omitted.
|
||||||
|
</context>
|
||||||
|
|
||||||
|
<process>
|
||||||
|
Execute end-to-end.
|
||||||
|
Preserve all workflow gates.
|
||||||
|
</process>
|
||||||
33
skills/gsd-ui-review/SKILL.md
Normal file
33
skills/gsd-ui-review/SKILL.md
Normal file
@@ -0,0 +1,33 @@
|
|||||||
|
---
|
||||||
|
name: gsd-ui-review
|
||||||
|
description: "Retroactive 6-pillar visual audit of implemented frontend code"
|
||||||
|
argument-hint: "[phase]"
|
||||||
|
allowed-tools:
|
||||||
|
- Read
|
||||||
|
- Write
|
||||||
|
- Bash
|
||||||
|
- Glob
|
||||||
|
- Grep
|
||||||
|
- Agent
|
||||||
|
- AskUserQuestion
|
||||||
|
---
|
||||||
|
|
||||||
|
<objective>
|
||||||
|
Conduct a retroactive 6-pillar visual audit. Produces UI-REVIEW.md with
|
||||||
|
graded assessment (1-4 per pillar). Works on any project.
|
||||||
|
Output: {phase_num}-UI-REVIEW.md
|
||||||
|
</objective>
|
||||||
|
|
||||||
|
<execution_context>
|
||||||
|
@~/.claude/gsd-core/workflows/ui-review.md
|
||||||
|
@~/.claude/gsd-core/references/ui-brand.md
|
||||||
|
</execution_context>
|
||||||
|
|
||||||
|
<context>
|
||||||
|
Phase: $ARGUMENTS — optional, defaults to last completed phase.
|
||||||
|
</context>
|
||||||
|
|
||||||
|
<process>
|
||||||
|
Execute end-to-end.
|
||||||
|
Preserve all workflow gates.
|
||||||
|
</process>
|
||||||
34
skills/gsd-ultraplan-phase/SKILL.md
Normal file
34
skills/gsd-ultraplan-phase/SKILL.md
Normal file
@@ -0,0 +1,34 @@
|
|||||||
|
---
|
||||||
|
name: gsd-ultraplan-phase
|
||||||
|
description: "[BETA] Offload plan phase to Claude Code's ultraplan cloud; review in browser and import back."
|
||||||
|
argument-hint: "[phase-number]"
|
||||||
|
allowed-tools:
|
||||||
|
- Read
|
||||||
|
- Bash
|
||||||
|
- Glob
|
||||||
|
- Grep
|
||||||
|
---
|
||||||
|
|
||||||
|
|
||||||
|
<objective>
|
||||||
|
Offload GSD's plan phase to Claude Code's ultraplan cloud infrastructure.
|
||||||
|
|
||||||
|
Ultraplan drafts the plan in a remote cloud session while your terminal stays free.
|
||||||
|
Review and comment on the plan in your browser, then import it back via /gsd-import --from.
|
||||||
|
|
||||||
|
⚠ BETA: ultraplan is in research preview. Use /gsd-plan-phase for stable local planning.
|
||||||
|
Requirements: Claude Code v2.1.91+, claude.ai account, GitHub repository.
|
||||||
|
</objective>
|
||||||
|
|
||||||
|
<execution_context>
|
||||||
|
@~/.claude/gsd-core/workflows/ultraplan-phase.md
|
||||||
|
@~/.claude/gsd-core/references/ui-brand.md
|
||||||
|
</execution_context>
|
||||||
|
|
||||||
|
<context>
|
||||||
|
$ARGUMENTS
|
||||||
|
</context>
|
||||||
|
|
||||||
|
<process>
|
||||||
|
Execute the ultraplan-phase workflow end-to-end.
|
||||||
|
</process>
|
||||||
35
skills/gsd-undo/SKILL.md
Normal file
35
skills/gsd-undo/SKILL.md
Normal file
@@ -0,0 +1,35 @@
|
|||||||
|
---
|
||||||
|
name: gsd-undo
|
||||||
|
description: "Safe git revert. Roll back phase or plan commits using the phase manifest with dependency checks."
|
||||||
|
argument-hint: "--last N | --phase NN | --plan NN-MM"
|
||||||
|
allowed-tools:
|
||||||
|
- Read
|
||||||
|
- Bash
|
||||||
|
- Glob
|
||||||
|
- Grep
|
||||||
|
- AskUserQuestion
|
||||||
|
---
|
||||||
|
|
||||||
|
|
||||||
|
<objective>
|
||||||
|
Safe git revert — roll back GSD phase or plan commits using the phase manifest, with dependency checks and a confirmation gate before execution.
|
||||||
|
|
||||||
|
Three modes:
|
||||||
|
- **--last N**: Show recent GSD commits for interactive selection
|
||||||
|
- **--phase NN**: Revert all commits for a phase (manifest + git log fallback)
|
||||||
|
- **--plan NN-MM**: Revert all commits for a specific plan
|
||||||
|
</objective>
|
||||||
|
|
||||||
|
<execution_context>
|
||||||
|
@~/.claude/gsd-core/workflows/undo.md
|
||||||
|
@~/.claude/gsd-core/references/ui-brand.md
|
||||||
|
@~/.claude/gsd-core/references/gate-prompts.md
|
||||||
|
</execution_context>
|
||||||
|
|
||||||
|
<context>
|
||||||
|
$ARGUMENTS
|
||||||
|
</context>
|
||||||
|
|
||||||
|
<process>
|
||||||
|
Execute end-to-end.
|
||||||
|
</process>
|
||||||
50
skills/gsd-update/SKILL.md
Normal file
50
skills/gsd-update/SKILL.md
Normal file
@@ -0,0 +1,50 @@
|
|||||||
|
---
|
||||||
|
name: gsd-update
|
||||||
|
description: "Update GSD to latest version with changelog display"
|
||||||
|
argument-hint: "[--sync | --reapply | --next | --rc]"
|
||||||
|
allowed-tools:
|
||||||
|
- Read
|
||||||
|
- Write
|
||||||
|
- Edit
|
||||||
|
- Bash
|
||||||
|
- Glob
|
||||||
|
- Grep
|
||||||
|
- AskUserQuestion
|
||||||
|
---
|
||||||
|
|
||||||
|
|
||||||
|
<objective>
|
||||||
|
Check for GSD updates, install if available, and display what changed.
|
||||||
|
|
||||||
|
Routes to the update workflow which handles:
|
||||||
|
- Version detection (local vs global installation)
|
||||||
|
- npm version checking
|
||||||
|
- Changelog fetching and display
|
||||||
|
- User confirmation with clean install warning
|
||||||
|
- Update execution and cache clearing
|
||||||
|
- Restart reminder
|
||||||
|
</objective>
|
||||||
|
|
||||||
|
<execution_context>
|
||||||
|
@~/.claude/gsd-core/workflows/update.md
|
||||||
|
</execution_context>
|
||||||
|
|
||||||
|
<flags>
|
||||||
|
- **--sync**: Sync managed GSD skills across runtime roots so multi-runtime users stay aligned after an update. Runs the sync-skills workflow (--from, --to, --dry-run, --apply flags supported).
|
||||||
|
- **--reapply**: Reapply local modifications after a GSD update. Uses three-way comparison (pristine baseline, user-modified backup, newly installed version) to merge user customizations back. Runs the reapply-patches workflow.
|
||||||
|
- **--next** (alias **--rc**): Target the `@next` RC dist-tag instead of `@latest` so you can install or refresh a release candidate (e.g. `1.4.0-rc.1`) through the normal update flow — scope/runtime detection, changelog preview, custom-file backup, and cache clearing all still apply. Omitting it keeps targeting `@latest` (no change). See ADR #660 for the RC channel.
|
||||||
|
- **(no flag)**: Standard update — check for new version, show changelog, install.
|
||||||
|
</flags>
|
||||||
|
|
||||||
|
<process>
|
||||||
|
Parse the first token of $ARGUMENTS:
|
||||||
|
- If it is `--sync`: strip the flag, execute the sync-skills workflow (passing remaining args for --from/--to/--dry-run/--apply).
|
||||||
|
- If it is `--reapply`: strip the flag, execute the reapply-patches workflow.
|
||||||
|
- Otherwise (including `--next` / `--rc`): execute the update workflow end-to-end, passing `$ARGUMENTS` through so the workflow's parse_update_channel step can select the release channel.
|
||||||
|
|
||||||
|
</process>
|
||||||
|
|
||||||
|
<execution_context_extended>
|
||||||
|
@~/.claude/gsd-core/workflows/sync-skills.md
|
||||||
|
@~/.claude/gsd-core/workflows/reapply-patches.md
|
||||||
|
</execution_context_extended>
|
||||||
36
skills/gsd-validate-phase/SKILL.md
Normal file
36
skills/gsd-validate-phase/SKILL.md
Normal file
@@ -0,0 +1,36 @@
|
|||||||
|
---
|
||||||
|
name: gsd-validate-phase
|
||||||
|
description: "Retroactively audit and fill Nyquist validation gaps for a completed phase"
|
||||||
|
argument-hint: "[phase number]"
|
||||||
|
allowed-tools:
|
||||||
|
- Read
|
||||||
|
- Write
|
||||||
|
- Edit
|
||||||
|
- Bash
|
||||||
|
- Glob
|
||||||
|
- Grep
|
||||||
|
- Agent
|
||||||
|
- AskUserQuestion
|
||||||
|
---
|
||||||
|
|
||||||
|
<objective>
|
||||||
|
Audit Nyquist validation coverage for a completed phase. Three states:
|
||||||
|
- (A) VALIDATION.md exists — audit and fill gaps
|
||||||
|
- (B) No VALIDATION.md, SUMMARY.md exists — reconstruct from artifacts
|
||||||
|
- (C) Phase not executed — exit with guidance
|
||||||
|
|
||||||
|
Output: updated VALIDATION.md + generated test files.
|
||||||
|
</objective>
|
||||||
|
|
||||||
|
<execution_context>
|
||||||
|
@~/.claude/gsd-core/workflows/validate-phase.md
|
||||||
|
</execution_context>
|
||||||
|
|
||||||
|
<context>
|
||||||
|
Phase: $ARGUMENTS — optional, defaults to last completed phase.
|
||||||
|
</context>
|
||||||
|
|
||||||
|
<process>
|
||||||
|
Execute end-to-end.
|
||||||
|
Preserve all workflow gates.
|
||||||
|
</process>
|
||||||
39
skills/gsd-verify-work/SKILL.md
Normal file
39
skills/gsd-verify-work/SKILL.md
Normal file
@@ -0,0 +1,39 @@
|
|||||||
|
---
|
||||||
|
name: gsd-verify-work
|
||||||
|
description: "Validate built features through conversational UAT"
|
||||||
|
argument-hint: "[phase number, e.g., '4'] [--ws <name>]"
|
||||||
|
allowed-tools:
|
||||||
|
- Read
|
||||||
|
- Bash
|
||||||
|
- Glob
|
||||||
|
- Grep
|
||||||
|
- Edit
|
||||||
|
- Write
|
||||||
|
- Agent
|
||||||
|
---
|
||||||
|
|
||||||
|
<objective>
|
||||||
|
Validate built features through conversational testing with persistent state.
|
||||||
|
|
||||||
|
Purpose: Confirm what Claude built actually works from user's perspective. One test at a time, plain text responses, no interrogation. When issues are found, automatically diagnose, plan fixes, and prepare for execution.
|
||||||
|
|
||||||
|
Output: {phase_num}-UAT.md tracking all test results. If issues found: diagnosed gaps, verified fix plans ready for /gsd-execute-phase
|
||||||
|
</objective>
|
||||||
|
|
||||||
|
<execution_context>
|
||||||
|
@~/.claude/gsd-core/workflows/verify-work.md
|
||||||
|
@~/.claude/gsd-core/templates/UAT.md
|
||||||
|
</execution_context>
|
||||||
|
|
||||||
|
<context>
|
||||||
|
Phase: $ARGUMENTS (optional)
|
||||||
|
- If provided: Test specific phase (e.g., "4")
|
||||||
|
- If not provided: Check for active sessions or prompt for phase
|
||||||
|
|
||||||
|
Context files are resolved inside the workflow (`init verify-work`) and delegated via `<files_to_read>` blocks.
|
||||||
|
</context>
|
||||||
|
|
||||||
|
<process>
|
||||||
|
Execute end-to-end.
|
||||||
|
Preserve all workflow gates (session management, test presentation, diagnosis, fix planning, routing).
|
||||||
|
</process>
|
||||||
53
skills/gsd-workspace/SKILL.md
Normal file
53
skills/gsd-workspace/SKILL.md
Normal file
@@ -0,0 +1,53 @@
|
|||||||
|
---
|
||||||
|
name: gsd-workspace
|
||||||
|
description: "Manage GSD workspaces — create, list, or remove isolated workspace environments"
|
||||||
|
argument-hint: "[--new | --list | --remove] [name]"
|
||||||
|
allowed-tools:
|
||||||
|
- Read
|
||||||
|
- Write
|
||||||
|
- Bash
|
||||||
|
- AskUserQuestion
|
||||||
|
---
|
||||||
|
|
||||||
|
|
||||||
|
<objective>
|
||||||
|
Manage GSD workspaces with a single consolidated command.
|
||||||
|
|
||||||
|
Mode routing:
|
||||||
|
- **--new**: Create an isolated workspace with repo copies and independent .planning/ → new-workspace workflow
|
||||||
|
- **--list**: List active GSD workspaces and their status → list-workspaces workflow
|
||||||
|
- **--remove**: Remove a GSD workspace and clean up worktrees → remove-workspace workflow
|
||||||
|
</objective>
|
||||||
|
|
||||||
|
<routing>
|
||||||
|
|
||||||
|
| Flag | Action | Workflow |
|
||||||
|
|------|--------|----------|
|
||||||
|
| --new | Create workspace with worktree/clone strategy | new-workspace |
|
||||||
|
| --list | Scan ~/gsd-workspaces/, show summary table | list-workspaces |
|
||||||
|
| --remove | Confirm and remove workspace directory | remove-workspace |
|
||||||
|
|
||||||
|
</routing>
|
||||||
|
|
||||||
|
<execution_context>
|
||||||
|
@~/.claude/gsd-core/workflows/new-workspace.md
|
||||||
|
@~/.claude/gsd-core/workflows/list-workspaces.md
|
||||||
|
@~/.claude/gsd-core/workflows/remove-workspace.md
|
||||||
|
@~/.claude/gsd-core/references/ui-brand.md
|
||||||
|
</execution_context>
|
||||||
|
|
||||||
|
<context>
|
||||||
|
Arguments: $ARGUMENTS
|
||||||
|
|
||||||
|
Parse the first token of $ARGUMENTS:
|
||||||
|
- If it is `--new`: strip the flag, pass remainder (--name, --repos, --path, --strategy, --branch, --auto flags) to new-workspace workflow
|
||||||
|
- If it is `--list`: execute list-workspaces workflow (no argument needed)
|
||||||
|
- If it is `--remove`: strip the flag, pass remainder (workspace-name) to remove-workspace workflow
|
||||||
|
- Otherwise (no flag): show usage — one of --new, --list, or --remove is required
|
||||||
|
</context>
|
||||||
|
|
||||||
|
<process>
|
||||||
|
1. Parse the leading flag from $ARGUMENTS.
|
||||||
|
2. Load and execute the appropriate workflow end-to-end based on the routing table above.
|
||||||
|
3. Preserve all workflow gates from the target workflow (validation, approvals, commits, routing).
|
||||||
|
</process>
|
||||||
70
skills/gsd-workstreams/SKILL.md
Normal file
70
skills/gsd-workstreams/SKILL.md
Normal file
@@ -0,0 +1,70 @@
|
|||||||
|
---
|
||||||
|
name: gsd-workstreams
|
||||||
|
description: "Manage parallel workstreams — list, create, switch, status, progress, complete, and resume"
|
||||||
|
allowed-tools:
|
||||||
|
- Read
|
||||||
|
- Bash
|
||||||
|
---
|
||||||
|
|
||||||
|
|
||||||
|
# /gsd-workstreams
|
||||||
|
|
||||||
|
Manage parallel workstreams for concurrent milestone work.
|
||||||
|
|
||||||
|
## Usage
|
||||||
|
|
||||||
|
`/gsd-workstreams [subcommand] [args]`
|
||||||
|
|
||||||
|
### Subcommands
|
||||||
|
|
||||||
|
| Command | Description |
|
||||||
|
|---------|-------------|
|
||||||
|
| `list` | List all workstreams with status |
|
||||||
|
| `create <name>` | Create a new workstream |
|
||||||
|
| `status <name>` | Detailed status for one workstream |
|
||||||
|
| `switch <name>` | Set active workstream |
|
||||||
|
| `progress` | Progress summary across all workstreams |
|
||||||
|
| `complete <name>` | Archive a completed workstream |
|
||||||
|
| `resume <name>` | Resume work in a workstream |
|
||||||
|
|
||||||
|
## Step 1: Parse Subcommand
|
||||||
|
|
||||||
|
Parse the user's input to determine which workstream operation to perform.
|
||||||
|
If no subcommand given, default to `list`.
|
||||||
|
|
||||||
|
## Step 2: Execute Operation
|
||||||
|
|
||||||
|
### list
|
||||||
|
Run: `gsd-tools query workstream.list --raw --cwd "$CWD"`
|
||||||
|
Display the workstreams in a table format showing name, status, current phase, and progress.
|
||||||
|
|
||||||
|
### create
|
||||||
|
Run: `gsd-tools query workstream.create <name> --raw --cwd "$CWD"`
|
||||||
|
After creation, display the new workstream path and suggest next steps:
|
||||||
|
- `/gsd-new-milestone --ws <name>` to set up the milestone
|
||||||
|
|
||||||
|
### status
|
||||||
|
Run: `gsd-tools query workstream.status <name> --raw --cwd "$CWD"`
|
||||||
|
Display detailed phase breakdown and state information.
|
||||||
|
|
||||||
|
### switch
|
||||||
|
Run: `gsd-tools query workstream.set <name> --raw --cwd "$CWD"`
|
||||||
|
Also set `GSD_WORKSTREAM` for the current session when the runtime supports it.
|
||||||
|
If the runtime exposes a session identifier, GSD also stores the active workstream
|
||||||
|
session-locally so concurrent sessions do not overwrite each other.
|
||||||
|
|
||||||
|
### progress
|
||||||
|
Run: `gsd-tools query workstream.progress --raw --cwd "$CWD"`
|
||||||
|
Display a progress overview across all workstreams.
|
||||||
|
|
||||||
|
### complete
|
||||||
|
Run: `gsd-tools query workstream.complete <name> --raw --cwd "$CWD"`
|
||||||
|
Archive the workstream to milestones/.
|
||||||
|
|
||||||
|
### resume
|
||||||
|
Set the workstream as active and suggest `/gsd-resume-work --ws <name>`.
|
||||||
|
|
||||||
|
## Step 3: Display Results
|
||||||
|
|
||||||
|
Format the JSON output from gsd-tools query into a human-readable display.
|
||||||
|
Include the `${GSD_WS}` flag in any routing suggestions.
|
||||||
@@ -376,6 +376,7 @@ describe('C: plugin.json schema validation', () => {
|
|||||||
fs.copyFileSync(PLUGIN_JSON_PATH, path.join(pluginRoot, '.claude-plugin', 'plugin.json'));
|
fs.copyFileSync(PLUGIN_JSON_PATH, path.join(pluginRoot, '.claude-plugin', 'plugin.json'));
|
||||||
fs.symlinkSync(path.join(ROOT, 'commands'), path.join(pluginRoot, 'commands'), 'dir');
|
fs.symlinkSync(path.join(ROOT, 'commands'), path.join(pluginRoot, 'commands'), 'dir');
|
||||||
fs.symlinkSync(path.join(ROOT, 'hooks'), path.join(pluginRoot, 'hooks'), 'dir');
|
fs.symlinkSync(path.join(ROOT, 'hooks'), path.join(pluginRoot, 'hooks'), 'dir');
|
||||||
|
fs.symlinkSync(path.join(ROOT, 'skills'), path.join(pluginRoot, 'skills'), 'dir');
|
||||||
|
|
||||||
const result = spawnSync('claude', ['plugin', 'validate', pluginRoot, '--strict'], {
|
const result = spawnSync('claude', ['plugin', 'validate', pluginRoot, '--strict'], {
|
||||||
cwd: ROOT,
|
cwd: ROOT,
|
||||||
@@ -891,3 +892,61 @@ describe('G: #997 ensureCanonicalPath() behavioural regression', () => {
|
|||||||
);
|
);
|
||||||
});
|
});
|
||||||
});
|
});
|
||||||
|
|
||||||
|
// ─── Section H: skills surface projection (#1596 — Phase B-provide) ──────────
|
||||||
|
//
|
||||||
|
// ADR-766 originally projected commands + hooks but NOT skills. Phase B-provide
|
||||||
|
// (#1596) adds a build-generated `skills/` dir + a `skills` manifest field so
|
||||||
|
// plugin-installed GSD exposes `gsd-core:<skill>` the native Claude Code way.
|
||||||
|
// The skills are generated from `commands/gsd/*.md` by
|
||||||
|
// `scripts/gen-plugin-skills.cjs` using `convertClaudeCommandToClaudeSkill`.
|
||||||
|
describe('H: skills surface projection (#1596)', () => {
|
||||||
|
const SKILLS_DIR = path.resolve(ROOT, 'skills');
|
||||||
|
|
||||||
|
test('plugin.json declares skills: "./skills/"', () => {
|
||||||
|
const manifest = JSON.parse(fs.readFileSync(PLUGIN_JSON_PATH, 'utf-8'));
|
||||||
|
assert.equal(
|
||||||
|
manifest.skills, './skills/',
|
||||||
|
'plugin.json must declare "skills": "./skills/" so Claude Code discovers plugin skills (#1596)'
|
||||||
|
);
|
||||||
|
});
|
||||||
|
|
||||||
|
test('skills/ dir exists with at least one gsd-*/SKILL.md', () => {
|
||||||
|
assert.ok(fs.existsSync(SKILLS_DIR), `skills/ dir must exist (run: npm run gen:plugin-skills -- --write): ${SKILLS_DIR}`);
|
||||||
|
const entries = fs.readdirSync(SKILLS_DIR, { withFileTypes: true });
|
||||||
|
const skillDirs = entries.filter(e => e.isDirectory() && e.name.startsWith('gsd-'));
|
||||||
|
assert.ok(skillDirs.length > 0, 'skills/ must contain at least one gsd-*/ directory');
|
||||||
|
// Each must have a SKILL.md
|
||||||
|
for (const dir of skillDirs) {
|
||||||
|
const skillMd = path.join(SKILLS_DIR, dir.name, 'SKILL.md');
|
||||||
|
assert.ok(fs.existsSync(skillMd), `${dir.name}/SKILL.md must exist`);
|
||||||
|
}
|
||||||
|
});
|
||||||
|
|
||||||
|
test('every generated SKILL.md has name: and description: frontmatter', () => {
|
||||||
|
assert.ok(fs.existsSync(SKILLS_DIR), 'skills/ must exist');
|
||||||
|
const skillDirs = fs.readdirSync(SKILLS_DIR, { withFileTypes: true })
|
||||||
|
.filter(e => e.isDirectory() && e.name.startsWith('gsd-'));
|
||||||
|
assert.ok(skillDirs.length > 0, 'must have at least one skill dir');
|
||||||
|
for (const dir of skillDirs) {
|
||||||
|
const raw = fs.readFileSync(path.join(SKILLS_DIR, dir.name, 'SKILL.md'), 'utf-8');
|
||||||
|
const fmMatch = raw.match(/^---\r?\n([\s\S]*?)\r?\n---/);
|
||||||
|
assert.ok(fmMatch, `${dir.name}/SKILL.md must have frontmatter`);
|
||||||
|
const fm = fmMatch[1];
|
||||||
|
assert.ok(/^\s*name:\s*\S/m.test(fm), `${dir.name}/SKILL.md frontmatter must have a name: field`);
|
||||||
|
assert.ok(/^\s*description:\s*\S/m.test(fm), `${dir.name}/SKILL.md frontmatter must have a description: field`);
|
||||||
|
}
|
||||||
|
});
|
||||||
|
|
||||||
|
test('parity: one skill dir per command file (DEFECT.GENERATIVE-FIX)', () => {
|
||||||
|
const commandsDir = path.resolve(ROOT, 'commands', 'gsd');
|
||||||
|
const commandFiles = fs.readdirSync(commandsDir).filter(f => f.endsWith('.md'));
|
||||||
|
const skillDirs = fs.readdirSync(SKILLS_DIR, { withFileTypes: true })
|
||||||
|
.filter(e => e.isDirectory() && e.name.startsWith('gsd-'));
|
||||||
|
assert.equal(
|
||||||
|
skillDirs.length, commandFiles.length,
|
||||||
|
`skills/gsd-*/ count (${skillDirs.length}) must equal commands/gsd/*.md count (${commandFiles.length}). ` +
|
||||||
|
`Run: npm run gen:plugin-skills -- --write`
|
||||||
|
);
|
||||||
|
});
|
||||||
|
});
|
||||||
|
|||||||
Reference in New Issue
Block a user