Verification Cockpit Generator

Portable skill — install from the agent skills library (verification-cockpit/). Primary use: generate layouts in app/library repos you are verifying.

Output: .agents/verification/ in the workspace you are verifying. av auto-delegates when tmux-layout.sh exists there.

Adopt in a target project

Copy or symlink this skill into the project you are verifying:

SKILLS_ROOT=~/skills   # or wherever you cloned the skills library
mkdir -p /path/to/my-app/.cursor/skills
ln -sfn "$SKILLS_ROOT/verification-cockpit" /path/to/my-app/.cursor/skills/verification-cockpit
# or: cp -a "$SKILLS_ROOT/verification-cockpit" /path/to/my-app/.cursor/skills/

Open that project in Cursor, then invoke the skill. It generates .agents/verification/* in that repo — tweak manifest and layout for that stack.

Prerequisite: av workflow with verify-launch.sh + verify-layout.sh on the host. See shell-av-workflow overlay in the skills library.

When to run

• Target project (or this shell repo as dogfood/stress test) needs a verification dashboard
• AGENTS.md / README lists verify commands not reflected in panes
• Stack changed (new pnpm scripts, Rust crate, CI jobs)
• User asks for "verification cockpit", "av layout", or "mission control"

Workflow

Copy this checklist and track progress:

- [ ] 1. Discover verification commands
- [ ] 2. Classify launch tiers
- [ ] 3. Design pane layout
- [ ] 4. Write .agents/verification/*
- [ ] 5. Symlink .cursor/verify
- [ ] 6. Optional: AGENTS.md cockpit row

1. Discover

Read in order (stop when you have enough signal):

2. Classify tiers

Rule: if it writes deps, data, or project structure → mutate. If it only reads/compiles/tests → verify or watch.

Set risk_profile in manifest: low | medium | high (from AGENTS.md stability contracts).

3. Design layout (two-pass, golden ratio)

Mandatory: every pane answers what failure does this surface? If it does not, omit it. Prefer four high-signal panes over six decorative ones.

Golden ratio: all splits use φ ≈ 1.618 → 62% major / 38% minor (bin/lib/verify-layout.sh). Nest splits so higher priority panes accumulate major shares.

Pass 1 — priority → area

Rank panes priority: 1 (highest) through N. Allocate area in golden proportions:

Use verify_layout_build_golden_grid from verify-layout.sh for the default 4-pane skeleton.

Pass 2 — context → arrangement

Adjust using space_profile per pane (manifest + reference.md):

Default golden grid

+----------------------------+------------------+
|                            | VERIFY (minor)   |
|  GIT (tui-side, 62% w)     |------------------|
|  lazygit full height       | WATCH (scroll)   |
|                            |------------------|
|                            | CMD (interactive)|
+----------------------------+------------------+
     git column 62%              ops column 38%

• CMD — tier: monitor, no command — agent_scan, gdf, vf
• WATCH — highest-priority watcher for this stack
• VERIFY — full-suite or build; confirm in pane
• Optional second window verify-risk only when many amber/red commands would crowd one window

Value audit (before shipping)

- [ ] Each pane has `value:` in manifest — one concrete failure mode
- [ ] No system monitors (btop) unless debugging perf during verify
- [ ] No file browser unless verify workflow inspects files
- [ ] No duplicate signals (two panes showing same test output)
- [ ] WATCH pane shows live output without manual refresh

4. Write artifacts

Create under .agents/verification/:

Use templates from templates/ in this skill directory. Fill PROJECT, RISK, and PANES from discovery.

tmux-layout.sh contract:

• Args: [directory] (default .)
• Must run inside tmux
• Sets @workflow_dir, @workflow_mode verify
• Idempotent: verify_layout_ok — recreate when CMD missing or placeholder panes (FILES/SYS/INSIGHT/VERIFY)
• Resolves project layout by walking up from cwd for .agents/verification/tmux-layout.sh
• Sources verify-launch.sh + verify-layout.sh
• Calls verify_layout_build_golden_grid, verify_apply_theme, verify_launch_pane, verify_maybe_rescan
• Ends with tmux select-pane on console

5. Symlink

mkdir -p .cursor
ln -sfn ../.agents/verification .cursor/verify

6. Optional AGENTS.md row

If no cockpit section exists, add under setup/verify:

| Verification cockpit | `.agents/verification/README.md` — run `av` in tmux after agent work |

Test

In Ghostty + tmux (not Cursor integrated terminal):

t && z <project>
av                  # project layout; watchers auto-start
av --scan           # + agent_scan in console
av --launch-mutate  # allow mutate-tier confirms
av --generic        # fallback to generic 4-pane cockpit

Reference

• Manifest schema: reference.md
• Starter templates: templates/ — copy into target project .agents/verification/
• Runtime integration overlay: shell-av-workflow