Skip to content

chore: add ferry verification skill - #16

Merged
softmaxe merged 1 commit into
mainfrom
t3/create-verification-skill
Nov 16, 2026
Merged

softmaxe merged 1 commit into
mainfrom
t3/create-verification-skill

Conversation

@softmaxe

Copy link
Copy Markdown
Owner

Summary

Add a project-local skill that builds an isolated ferry binary, reuses the existing CLI and live desktop tests, and retains command evidence after cleanup.

.agents/skills/verify-ferry/
├── SKILL.md          # launch, doctor, drive, evidence, and cleanup
├── scripts/verify.sh # executable orchestration and evidence capture
└── features/         # CLI, focused/explicit windows, follow, and Raycast recipes

Evidence

  • Before: CLI and desktop tests existed, but there was no project-local verification skill or maintained feature map.
    After: Generated instructions passed an end-to-end launch → doctor → PTY CLI → cleanup run, plus an independent cold CLI run. Scratch was removed and evidence survived.

  • Existing make test passed all 10 CLI cases and 3 binary checks. The generated helper also checked help aliases and stdout/stderr routing.

  • make test-follow and the generated desktop helper both passed on a local Apple silicon desktop with Accessibility and two normal Spaces:

    ok: background --window moves and follows the selected window
    ok: --window already on the active destination Space
    ok: --no-follow leaves the active Space unchanged
    
  • Skill validation, shell syntax, and whitespace checks passed. Runtime was macOS 27.2.1; supported macOS 26, focused-window selection, and Raycast journeys remain unverified. No screenshots or animation recordings were captured.

Merge Danger

Door: two-way

Blast Radius: verification

Adds documentation and an opt-in helper; ferry runtime behavior is unchanged. Desktop mode switches Spaces using disposable test windows and the existing harness's restoration logic.

@softmaxe
softmaxe merged commit 6795d5c into main Nov 16, 2026
3 checks passed
@softmaxe
softmaxe deleted the t3/create-verification-skill branch November 16, 2026 14:19
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant