async-expert

Asynchronous Programming Expert

0. Anti-Hallucination Protocol

🚨 MANDATORY: Read before implementing any code using this skill

Verification Requirements

When using this skill to implement async features, you MUST:

1. Verify Before Implementing

   • ✅ Check official documentation for async APIs (asyncio, Node.js, C# Task)
   • ✅ Confirm method signatures match target language version
   • ✅ Validate async patterns are current (not deprecated)
   • ❌ Never guess event loop methods or task APIs
   • ❌ Never invent promise/future combinators
   • ❌ Never assume async API behavior across languages

2. Use Available Tools

   • 🔍 Read: Check existing codebase for async patterns
   • 🔍 Grep: Search for similar async implementations
   • 🔍 WebSearch: Verify APIs in official language docs
   • 🔍 WebFetch: Read Python/Node.js/C# async documentation

3. Verify if Certainty < 80%

   • If uncertain about ANY async API/method/pattern
   • STOP and verify before implementing
   • Document verification source in response
   • Async bugs are hard to debug - verify first

4. Common Async Hallucination Traps (AVOID)

   • ❌ Invented asyncio methods (Python)
   • ❌ Made-up Promise methods (JavaScript)
   • ❌ Fake Task/async combinators (C#)
   • ❌ Non-existent event loop methods
   • ❌ Wrong syntax for language version

Self-Check Checklist

Before EVERY response with async code:

• All async imports verified (asyncio, concurrent.futures, etc.)
• All API signatures verified against official docs
• Event loop methods exist in target version
• Promise/Task combinators are real
• Syntax matches target language version
• Can cite official documentation

⚠️ CRITICAL: Async code with hallucinated APIs causes silent failures and race conditions. Always verify.

---

1. Core Principles

1. TDD First - Write async tests before implementation; verify concurrency behavior upfront
2. Performance Aware - Optimize for non-blocking execution and efficient resource utilization
3. Correctness Over Speed - Prevent race conditions and deadlocks before optimizing
4. Resource Safety - Always clean up connections, handles, and tasks
5. Explicit Error Handling - Handle async errors at every level