Apply when implementing features, fixing bugs, debugging errors, investigating failures, tracing root causes, reviewing tech debt, tracing issues, planning fixes, or completing any task. Enforces parallel sub-agent implementation, independent adversarial review, and a 95% confidence gate before stopping.

2026-07-100

writing-tests

ZaxbyHub/ragappv3

RAGAPPv3 testing policy and conventions. Load before writing or modifying any test, fixing a test/CI failure, or adding coverage. Covers backend pytest + unittest (SimpleConnectionPool dependency-override harness, FK cascades, the Python 3.11-vs-local event-loop trap) and frontend Vitest + React Testing Library + jsdom (MemoryRouter, Radix Select, react-virtual mock patterns). This repo's frontend uses Vitest, NOT bun:test.

2026-07-100

dependency-ci-contract

ZaxbyHub/ragappv3

Keep dependency and lockfile changes aligned with CI expectations.

2026-07-080

qa-gate-disciplined-completion

ZaxbyHub/ragappv3

Verify all required QA gate artifacts and completion criteria before marking a task or phase complete.

2026-07-080

testing-mock-async-hygiene

ZaxbyHub/ragappv3

Keep mocks, async setup, and test assertions clean and aligned with the code under test.

2026-07-080

ci-compatibility-audit

ZaxbyHub/ragappv3

Lightweight PR-time audit for whether changes are compatible with the actual RAGAPPv3 GitHub Actions workflow, dependency lockfiles, scripts, and cross-platform local validation.

2026-07-060

name	e2e-regression-async-generators
description	End-to-end regression tests for async generator copy logic
triggers	["async generator","copy logic","done chunk","RAGEngine.query","regression test","integration bug","unit test gap"]
generated_from_knowledge	["2274327e-4f6f-4a2f-b3eb-f1c915b14af2"]
source_knowledge_ids	["2274327e-4f6f-4a2f-b3eb-f1c915b14af2","584bad6d-c7ee-4486-8ad4-3c4ef319e5ff"]
generated_at	"2026-07-06T17:07:25.088Z"
confidence	0.7
status	active
version	2
skill_origin	generated

End-to-end regression tests for async generator copy logic

Trigger

When a code change touches copy logic inside an async generator path, prefer end-to-end tests that consume the full generator and assert specific values, not unit tests of private methods that hand-simulate the copy.

Triggers

async generator
copy logic
done chunk
RAGEngine.query
regression test
integration bug
unit test gap

Required Procedure

Drive the real production async generator path end-to-end (e.g., engine.query(...)).
Consume the full async generator output; do not short-circuit after the first yield.
Assert specific values on the emitted payload, not just key presence.
For copy logic, verify the copied value matches the source value resolved by the production path.
Ensure the regression test fails when the production copy logic is removed or broken.

Example

Canonical pattern: backend/tests/test_prompt_ab_variants.py::TestDoneMsgABKeysE2E

Forbidden Shortcuts

Do not hand-simulate the copy step in a test of a private helper and assert the same assignment.
Do not assert only key presence when value correctness is the actual contract.
Do not stop consuming the generator early unless the test explicitly targets an early-stage behavior.

Delegation Template

When delegating a task affected by this skill, include:

SKILLS: file:.opencode/skills/generated/e2e-regression-async-generators/SKILL.md

Reviewer Checks

Verify each required action above appears in the diff.

Source Knowledge IDs

2274327e-4f6f-4a2f-b3eb-f1c915b14af2 — End-to-end tests that consume the full async generator catch integration bugs that unit tests of private methods miss.
584bad6d-c7ee-4486-8ad4-3c4ef319e5ff — Copy logic inside async generator paths must be verified end-to-end, not by unit-testing a private helper in isolation.