msd-core/skills/gsd-docs-update/SKILL.md at 697cbb1f05b47a3ea2461ba1d98f0fecf7d1045e

Files

Tom Boucher da4a86d8c1 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

2026-06-22 18:07:35 -04:00

2.1 KiB

Raw Blame History

name, description, argument-hint, allowed-tools

name

description

argument-hint

allowed-tools

gsd-docs-update

Generate or update project documentation verified against the codebase

[--force] [--verify-only]

Read

Write

Edit

Bash

Glob

Grep

Agent

AskUserQuestion

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

<execution_context> @~/.claude/gsd-core/workflows/docs-update.md </execution_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

Execute end-to-end. Preserve all workflow gates (preservation_check, flag handling, wave execution, monorepo dispatch, commit, reporting).

2.1 KiB Raw Blame History

2.1 KiB

Raw Blame History