What this is
Two MIT-licensed artefacts that make the -AgentSummary / -Json probe pattern installable for Cursor agents — without re-teaching the full convention (that is the Guide linked below).
| Artefact | Role |
|---|---|
spine-agent-probes |
Cursor plugin: public contract doc + skill agents can load |
| spine-automation | PowerShell module (Write-SpineProbeResult / envelope helpers) + copy-in templates for dual-host CI and a lightweight product ShellGuard |
Sibling framework plugins (file-ops, logging, Sphinx/config-gate) live under the same spine-cursor tree; this post focuses on the probe slice.
Why it exists
Cursor agents often need a single allowlisted pwsh -NoProfile -File … call and a human-skimmable success/failure line (PREFIX-OK / PREFIX-FAIL / optional PREFIX-MISS*) instead of $LASTEXITCODE compounds and wall-of-JSON terminals. The Guide explains the pattern; these repos ship the plugin contract and shared PowerShell writers so other workspaces can adopt it without inventing a private dialect.
Install / consume
Plugin (local symlink into Cursor plugins):
New-Item -ItemType SymbolicLink -Force -Path "$env:USERPROFILE\.cursor\plugins\local\spine-agent-probes" -Target "<path-to-clone>\plugins\spine-agent-probes"
Reload the Cursor window; confirm under Settings → Skills. Contract SSOT: plugins/spine-agent-probes/docs/agent-summary-probe-contract.md.
Module (from a clone):
Import-Module ./src/Spine.Automation/Spine.Automation.psd1 -Force
Consumption notes: spine-automation docs/consumption.md.
Templates (copy into other product repos):
| Pack | Role |
|---|---|
templates/ps-dual-host-ci/ |
Dual-host Pester + PS 5.1 smoke GitHub Actions workflow |
templates/ps-product-shellguard/ |
Lightweight project hooks (Safety tier on pwsh -File) |
Pair with the Guide
Deep dive (exit twin, dual stdout, nested helpers, lint enforcement): One-line script outcomes for Cursor agents — -AgentSummary and the PowerShell probe contract.
This Showcase is the “where do I get the bits?” companion — not a second contract essay.
Links
| Link | Role |
|---|---|
| spine-cursor | Framework docs + Marketplace plugins |
| spine-agent-probes | This plugin |
| spine-automation | Module + templates |
| Guide #166775 | Contract how-to |
Maintained by github.com/villepispa. Feedback and PRs welcome on either repo.