qa-slice
Use after implementation waves to replay affected baseline scenarios and record qa-slices.yaml evidence for every shipped behavioral bl-NNN.
git clone --depth 1 https://github.com/ReinaMacCredy/maestro /tmp/qa-slice && cp -r /tmp/qa-slice/embedded/skills/qa-slice ~/.claude/skills/qa-sliceSKILL.md
# QA Slice
Replay affected baseline scenarios after an implementation wave and record the
evidence in `.maestro/features/<id>/qa-slices.yaml`. The ship gate counts only
slices with scenario ids and non-empty evidence.
Activate:
`maestro hook record --event skill_activation --skill qa-slice`
## Use
- After a task wave changes feature behavior.
- Before `maestro feature ship`.
- When ship reports uncovered `[bl-NNN]` scenarios or stale QA evidence.
## Do
1. Read changed files/commands, `maestro feature show <id>`, and
`.maestro/features/<id>/baseline.md`.
2. Select the affected `[bl-NNN]` scenarios. If the wave adds behavior, extend
the baseline with a new id instead of hiding it behind a unit test.
3. Run the smallest useful probes:
focused tests for local invariants, plus a real command/manual/API/UI flow
when composition risk exists.
4. Compare against the baseline. Unexplained output, schema, state, permission,
performance, compatibility, or UI drift is a blocker.
5. Append a counting slice to `qa-slices.yaml`.
6. If blocked, return a tracker entry with expected vs actual, reproduction,
evidence, and fix path. Do not fix code from this skill.
## qa-slices.yaml
Keep this append-only shape. Scenario ids must match baseline digits exactly:
`bl-001` and `bl-1` are different.
```yaml
slices:
- at: "2026-05-31T00:00:00Z"
scenarios: ["bl-001", "bl-002"]
probes: ["cargo test --test feature_domain"]
result: pass
evidence:
- "feature_domain: 12 passed; 0 failed"
- "manual: feature new -> accept -> ship round-trips on temp .maestro"
```
Required for the gate: `scenarios` and `evidence`. Other fields are optional.
If the file does not parse, the ship gate prints the path, parse error, and the
expected shape.
## Output When Blocked
```markdown
### Gate Tracker - QA Slice
- [ ] [qs-001] <severity/confidence> <surface> - <behavior drift or missing proof>
- Scenario: [bl-NNN] <scenario name and dimensions>
- Expected: <baseline behavior>
- Actual: <actual behavior or missing proof>
- Reproduction: <steps/command/manual flow>
- Evidence: <command/output/manual check>
- Artifact: <path/screenshot/output/log/state snapshot, or None>
- Fix path: <recommended fix or probe>
- Verification: <command or check>
```
If clean:
```markdown
### QA Slice
- No blocking QA findings for <wave/scope>.
- Workflow chains replayed: <chain names and steps, or None>
- Scenarios replayed: <bl-NNN scenario names>
- Probes run: `<command>`, <manual check>
- Artifacts captured: <paths/descriptions or None>
```
## Stop
- Do not count a slice without scenario ids and evidence.
- Do not let a changed journey rely only on a unit test when a real observable
flow is feasible.
- Do not drop focused proof for safety-critical invariants.
- Do not block on broad nice-to-have coverage; record follow-up unless the
feature goal depends on it.
## Hand-off
Next: all behavioral baseline ids covered -> `maestro-feature` for
`feature ship --outcome "<one line>"`.>-
>-
Use when the user needs to run GitNexus CLI commands like analyze/index a repo, check status, clean the index, generate a wiki, or list indexed repos. Examples: \"Index this repo\", \"Reanalyze the codebase\", \"Generate a wiki\"
Use when the user is debugging a bug, tracing an error, or asking why something fails. Examples: \"Why is X failing?\", \"Where does this error come from?\", \"Trace this bug\"
Use when the user asks how code works, wants to understand architecture, trace execution flows, or explore unfamiliar parts of the codebase. Examples: \"How does X work?\", \"What calls this function?\", \"Show me the auth flow\"
Use when the user asks about GitNexus itself — available tools, how to query the knowledge graph, MCP resources, graph schema, or workflow reference. Examples: \"What GitNexus tools are available?\", \"How do I use GitNexus?\"
Use when the user wants to know what will break if they change something, or needs safety analysis before editing code. Examples: \"Is it safe to change X?\", \"What depends on this?\", \"What will break?\"
Use when the user wants to rename, extract, split, move, or restructure code safely. Examples: \"Rename this function\", \"Extract this into a module\", \"Refactor this class\", \"Move this to a separate file\"