stoa: Skill for Claude Code

Verify MEGA — $ARGUMENTS

Overview

Run all 5 MEGA Close Gates on a ticket (or audit all recently-closed MEGAs). Prevents false Dones on multi-phase tickets.

Mode Detection

• If $ARGUMENTS is --all-done-7d: Audit mode — scan all MEGAs marked Done in last 7 days
• If $ARGUMENTS is CAB-XXXX: Single mode — verify one MEGA ticket

Step 1: Fetch MEGA Data

Single Mode

linear.get_issue("CAB-XXXX", includeRelations=true)

Extract:

• title — verify contains [MEGA] or has children
• children.nodes[] — list of sub-tickets with id, identifier, state.name, estimate
• estimate — total points

If no children → report: "CAB-XXXX is not a MEGA (no children). Use standard close flow."

Audit Mode

linear.list_issues(
  teamId: "<LINEAR_TEAM_ID>",
  filter: { state: { name: { eq: "Done" } }, updatedAt: { gte: "<7 days ago>" } }
)

Filter results to only MEGAs (title contains [MEGA] or has children). Run gates on each.

Step 2: Gate 0 — Decomposition Invariant

• Check: children.nodes.length > 0
• Pass: MEGA has sub-tickets
• Fail: "MEGA has no sub-tickets. Run /decompose CAB-XXXX first."

Step 3: Gate 1 — Per-Phase PR Evidence

For each child ticket in Done state:

linear.list_comments(issueId: "<child_id>")

Check that at least one comment contains PR # or PR [#.

• Pass: All Done children have PR evidence
• Fail: List children missing PR references: "CAB-XXXX: no PR evidence found"

Step 4: Gate 2 — All Sub-Tickets Done

Check each child's state.name:

• Pass: ALL children have state.name == "Done" or state.name == "Canceled"
• Fail: List non-Done children with their current state:

  CAB-1351: In Progress
  CAB-1352: Todo
  

Step 5: Gate 3 — Live Verification

Based on the MEGA's component scope:

• API changes: curl -s https://api.gostoa.dev/health → expect 200
• UI/Portal: curl -s https://console.gostoa.dev or curl -s https://portal.gostoa.dev → expect 200
• Gateway: curl -s https://mcp.gostoa.dev/health → expect 200
• Docs: curl -s https://docs.gostoa.dev → expect 200
• Cross-component: verify all affected endpoints