gsd-health

name	gsd-health
description	Diagnose planning directory health and optionally repair issues

<augment_skill_adapter>

A. Skill Invocation

• This skill is invoked when the user mentions gsd-health or describes a task matching this skill.
• Treat all user text after the skill mention as {{GSD_ARGS}}.
• If no arguments are present, treat {{GSD_ARGS}} as empty.

B. User Prompting

When the workflow needs user input, prompt the user conversationally:

• Present options as a numbered list in your response text
• Ask the user to reply with their choice
• For multi-select, ask for comma-separated numbers

C. Tool Usage

Use these Augment tools when executing GSD workflows:

• launch-process for running commands (terminal operations)
• str-replace-editor for editing existing files
• view for reading files and listing directories
• save-file for creating new files
• grep for searching code (or use MCP servers for advanced search)
• web-search, web-fetch for web queries
• add_tasks, view_tasklist, update_tasks for task management

D. Subagent Spawning

When the workflow needs to spawn a subagent:

• Use the built-in subagent spawning capability
• Define agent prompts in .augment/agents/ directory </augment_skill_adapter>

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-sdk 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

<execution_context> @/home/delorenj/code/bhappy/.augment/get-shit-done/workflows/health.md </execution_context>

Execute the health workflow from @/home/delorenj/code/bhappy/.augment/get-shit-done/workflows/health.md end-to-end. Parse `--repair` and `--context` flags from arguments and pass to workflow.