HigorAlves/orc / codex/orc/content/skills/phases
phases
VerifiedPer-phase playbooks for orc commands, loaded one phase at a time
references/qa/PACKET.md
View on GitHub<!-- orc-qa/PACKET -->
_Loaded on demand via orc-phases. Do not run this phase from memory — this file is the phase._
# Packet contract (web mode)
The `qa/` directory MUST hold the driver's full packet. `orc-qa/P5` checks it before the verdict.
| Artifact | Driver P — playwright | Driver A — agent-browser | Driver B — chrome |
|----------|-----------------------|--------------------------|-------------------|
| Visual proof | `trace-<id>.zip` per scenario (screenshots inside) | `screenshot-NN-<step>.png` per golden-path step (`--annotate`) + edge-case shots | in-conversation screenshots, referenced by step number in `steps.md` (`Write` cannot emit binary) |
| Criterion proof | `qa-<branch>.webm#t=<chapter>` + the `test.step` title | `ac-<sliceId>-<idx>-<slug>.png` per scored criterion | the numbered `### Step <N>` anchor a criterion's `evidence` points at |
| Motion proof | `qa-<branch>.webm` stitched (ffmpeg) | `qa-<branch>.webm` (`agent-browser record` — needs `ffmpeg`) (+ optional `.gif` for ticket embedding) | `qa-<branch>.gif` (`gif_creator`, edge cases included) |
| Manifest | `qa-manifest.json` (`video.chapters`) | `qa-manifest.json` | `qa-manifest.json` |
| A11y snapshot | `trace-<id>.zip` (ARIA snapshots per action) | `snapshot-final.txt` (`agent-browser snapshot`) | `snapshot-final.txt` (`read_page` output) |
| Console | `console-<id>.log` | `console.log` (`agent-browser console`) | `console.log` (`read_console_messages`; state any filter used) |
| Network | `trace-<id>.zip` | `network.har` (`agent-browser network har stop`) | `network-summary.md` (distilled `read_network_requests`) |
| Narrative | `steps.md` | `steps.md` | `steps.md` (same template) |
Motion proof: mandatory whenever the change touches a rendered surface. Two exemptions, each stated as a one-line reason in `steps.md`, never omitted silently:
- a non-visual change;
- Driver A only: `ffmpeg` not installed. agent-browser's recorder wraps ffmpeg, so a headless run without it captures stills only. The Claude-in-Chrome driver's `gif_creator` has no such dependency.
Every acceptance criterion MUST appear in `qa-manifest.json` with a result; a `skipped` row says why.
Bonus evidence, NOT required: `trace.json` (Chrome DevTools trace), `react-renders.json`, `vitals.json`. Add these only when relevant to the change.
The chrome driver trades HAR-grade network capture and request mocking for live visibility. That is the user's call at the gate, not a loophole: its packet above stays mandatory in full.
Blocked callout, printed when a required artifact is missing; the user closes the gap before any "ready to PR" claim:
```markdown
> **🛑 Blocked — QA evidence incomplete**
>
> Missing: <artifact list>. No "QA passed" claim without the full evidence packet.
```
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |