Async Python Patterns

1---
2name: async-python-patterns
3description: Master Python asyncio, concurrent programming, and async/await patterns for high-performance applications. Use when building async APIs, concurrent systems, or I/O-bound applications requiring non-blocking operations.
4---
5 
6# Async Python Patterns
7 
8Comprehensive guidance for implementing asynchronous Python applications using asyncio, concurrent programming patterns, and async/await for building high-performance, non-blocking systems.
9 
10## Use this skill when
11 
12- Building async web APIs (FastAPI, aiohttp, Sanic)
13- Implementing concurrent I/O operations (database, file, network)
14- Creating web scrapers with concurrent requests
15- Developing real-time applications (WebSocket servers, chat systems)
16- Processing multiple independent tasks simultaneously
17- Building microservices with async communication
18- Optimizing I/O-bound workloads
19- Implementing async background tasks and queues
20 
21## Do not use this skill when
22 
23- The workload is CPU-bound with minimal I/O.
24- A simple synchronous script is sufficient.
25- The runtime environment cannot support asyncio/event loop usage.
26 
27## Instructions
28 
29- Clarify workload characteristics (I/O vs CPU), targets, and runtime constraints.
30- Pick concurrency patterns (tasks, gather, queues, pools) with cancellation rules.
31- Add timeouts, backpressure, and structured error handling.
32- Include testing and debugging guidance for async code paths.
33- If detailed examples are required, open `resources/implementation-playbook.md`.
34 
35Refer to `resources/implementation-playbook.md` for detailed patterns and examples.
36 
37## Resources
38 
39- `resources/implementation-playbook.md` for detailed patterns and examples.
40