asyncio testing

docs/skills/pytest-scaffolding/SKILL.md

@@ -23,6 +23,7 @@ Use it to quickly find the right guidance for:
 2. Naming conventions and test hierarchy organization.
 3. FastAPI route, dependency override, and lifespan testing patterns.
 4. SQLAlchemy transaction and session testing patterns.
+5. AsyncIO loop-scope, fixture-lifecycle, and cancellation-safe testing patterns.
 
 Repository defaults:
 - `uv run pytest` is the canonical invocation.
@@ -53,6 +54,7 @@ Open only the reference that matches the immediate task.
 2. Fixture layering, marker policy, collect-only and fast-path commands: [pytest-docs.md](./references/pytest-docs.md)
 3. Route tests, dependency overrides, lifespan handling: [fastapi-testing.md](./references/fastapi-testing.md)
 4. Session and transaction fixtures, async ORM behavior: [sqlalchemy-testing.md](./references/sqlalchemy-testing.md)
+5. Async test mode selection, event loop scope, cancel-scope teardown issues: [asyncio-testing.md](./references/asyncio-testing.md)
 
 ## Naming Pull-In Triggers
 
@@ -96,6 +98,7 @@ Apply this policy whenever a test change introduces a fake collaborator or patch
 
 - For FastAPI, prefer dependency overrides and clear lifecycle handling; see [fastapi-testing.md](./references/fastapi-testing.md).
 - For SQLAlchemy, prefer transaction-safe session fixtures and explicit async loading strategy; see [sqlalchemy-testing.md](./references/sqlalchemy-testing.md).
+- For async fixtures, loop-scope selection, and cancellation-safe teardown, see [asyncio-testing.md](./references/asyncio-testing.md).
 - For naming and tree organization, use the conventions in [naming-and-organization.md](./references/naming-and-organization.md).
 
 ## Source Documentation Entry Points
@@ -108,6 +111,8 @@ Primary upstream docs are curated in each reference page. Start with:
 4. FastAPI testing: [FastAPI testing tutorial](https://fastapi.tiangolo.com/tutorial/testing/)
 5. SQLAlchemy transaction testing: [SQLAlchemy external transaction pattern](https://docs.sqlalchemy.org/en/20/orm/session_transaction.html#joining-a-session-into-an-external-transaction-such-as-for-test-suites)
 6. Pytest monkeypatch usage and limits: [monkeypatch how-to](https://docs.pytest.org/en/stable/how-to/monkeypatch.html)
+7. pytest-asyncio configuration: [pytest-asyncio config](https://pytest-asyncio.readthedocs.io/en/stable/reference/configuration.html)
+8. AnyIO cancellation semantics: [AnyIO cancellation and timeouts](https://anyio.readthedocs.io/en/stable/cancellation.html)
 
 ## Quick Validation Commands