plan-gate
Lints Longhorn markdown execution plans for required step contract fields. Minimal contract.
Installation
Details
Usage
After installing, this skill will be available to your AI coding assistant.
Verify installation:
npx agent-skills-cli listSkill Instructions
name: plan-gate description: Lints Longhorn markdown execution plans for required step contract fields. Minimal contract. compatibility: opencode
Skill: plan-gate
Purpose
Validate Longhorn planning documents before execution. This gate enforces the presence of required step contract fields.
Usage
bash .opencode/skills/plan-gate/plan_gate.sh [options] [plan_markdown_path]
- If no plan_markdown_path is provided, defaults to
.sisyphus/plans/atlas-governance-p0-p1.md.
Options
--execute: Perform check (default dry-run semantics)--dry-run: Dry-run (default)--json-log: Emit JSON log lines-h, --help: Show help
Contract Checks
The following fields/headings must be present in the plan:
Plan Step ContractAction:Target:Verify Command:Done Criteria:Writing purpose:Global Hard RulesForbidden references
Hotfix Retry Prompt Gate
If the plan contains Hotfix Retry Prompt, each block must contain exactly one line each:
Target file: <path>Change objective: <one sentence>Verify: <single command>
The Verify line must be a single command (no &&, ||, ;, or pipes).
Exit Codes
0: pass2: argument error3: gate failure
More by COLDTURNIP
View allUse when asked how make targets work in Longhorn repos, adding a new build task, debugging a Dapper build failure, or unfamiliar with why Makefiles are so minimal.
Use when the user needs operational guidance from Longhorn docs: installation, upgrade, settings, UI steps, or version-specific troubleshooting. Do NOT use for source code internals or controller behavior.
Use when modifying a CRD schema or gRPC proto definition to assess impact, when a K8s resource is stuck in an unexpected state and the responsible controller is unknown, or when tracing the call chain between Manager and Instance Manager.