Skip to content

skills: correct verify-supacode map from a live maintenance pass - #957

Merged
khoi merged 2 commits into
mainfrom
khoi/maintain-verify-supacode
Nov 19, 2026
Merged

khoi merged 2 commits into
mainfrom
khoi/maintain-verify-supacode

Conversation

@khoi

@khoi khoi commented Nov 19, 2026

Copy link
Copy Markdown
Member

No linked issue. This is maintainer tooling with no user-facing change.

Summary

A scheduled /maintain-verification-skill pass drove every feature file in verify-supacode against a fresh Debug build of main (2edca45). Several recipes were wrong, and others had never been driven. This PR corrects the map to match what the app does today. It changes no product code.

Corrections:

  • Worktrees. The appearance flag is --color, not --tint. The tint colors the title text, and the AX treeitem name joins title and branch (Verify Row verify-wt). Delete also removes the local branch by default, and unarchive drops a pin.
  • Panes. pane split -d accepts only h/v. Zoom and window mode change the AX pane count but not pane list. Adds resize, equalize, and window-mode steps.
  • Repositories. repo open returns before the repo loads, so the recipe now polls repo list. Covers bad paths and the removal entry points that can't be driven headlessly.
  • Settings. The window id survives section changes. Adds Terminal and License, repo and repo-scripts titles, a persistence toggle, and the onboarding card route, which opens Developer.
  • Terminal tabs. Adds tab move and --background.

Additions to SKILL.md:

  • App-side CLI errors leave a modal alert on the main window. The new section covers how to dismiss it. agent-desktop click reports ACTION_FAILED even when the dismissal works.
  • How to build with a specific Xcode when the selected one isn't ready.
  • The run-scoped zmx check.

Type of change

  • Bug fix (the linked issue is a bug report)
  • Feature (the linked issue is a feature request marked ready)
  • Documentation
  • Other (please describe)

How was this tested?

  • make check passes (format + lint)
  • make test passes
  • I built and ran the app to confirm the change works

Docs-only, so make check and make test were not run. make build-app succeeded with Xcode 26.3. Xcode 27.2, the selected one, still needs its license accepted. Run fab914 drove every step written into these files through supacode-verify: doctor passed before and after, teardown exited 0, and UserDefaults matched the launch snapshot. Menu, shortcut, file-panel, and context-menu paths need physical input and were not driven. Two cross-provider reviews (correctness and maintainability) ran on the diff, and their findings are addressed in the second commit.

AI tool disclosure (optional)

  • Model(s): Claude Opus 5.5; reviews by GPT-6.2 Sol
  • Harness / tools: Claude Code in Supaterm

Checklist

  • This pull request is linked to an issue with Closes # above.
  • For a feature, the linked issue is labeled ready.
  • I am the author of this work and accountable for it; no commit is authored or co-authored by an AI agent.
  • I have read the Contributing guide and the Code of Conduct.

khoi added 2 commits November 18, 2026 18:30
A full pass drove every feature file against a fresh Debug build of
main. Several recipes were wrong or untested:

- worktrees: the appearance flag is --color, not --tint; the tint colors
  the title text and the treeitem name joins title and branch; delete
  also removes the branch by default; unarchive drops a pin
- panes: pane split -d only accepts h/v; zoom and window mode change the
  AX pane count but not pane list; add resize, equalize, window steps
- repositories: repo open returns before the repo loads, so poll repo list
- settings: the window id survives section changes; add Terminal and
  License, repo scripts titles, and a proven persistence toggle
- tabs: add tab move and --background

SKILL.md now documents the modal alert that app-side CLI errors leave on
the main window, how to dismiss it, and how to build with a ready Xcode.
Scope zmx checks to the run's ZMX_DIR and poll for teardown, run branch
checks against the seed repo, re-pin before archiving so unarchive proves
the pin is dropped, and drop the subfolder step that could pass before
the app resolved the path. Name the Options menu as a removal entry point,
wait for late alerts before dismissing them, and use feature-ID artifact
names for resize and equalize.
@khoi
khoi merged commit 0043f0d into main Nov 19, 2026
3 checks passed
@khoi
khoi deleted the khoi/maintain-verify-supacode branch November 19, 2026 02:46
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