Files
Bruno Pantaleão Gonçalves 1221c6f317 Instruct AI agents to prefer Swift concurrency over PromiseKit (#4726)
## Summary
Updates the AI agent instruction files so that AI coding assistants
prefer **Swift Concurrency** (`async/await`, `Task`, actors, structured
concurrency) for new asynchronous code and **avoid introducing new
PromiseKit usage**.

PromiseKit remains a legacy dependency in parts of `HomeAssistantAPI`
(`HAAPI.swift`), so the guidance also tells agents not to assume a full
migration and to convert PromiseKit to `async/await` where practical
when they touch that code.

Files updated:
- `AGENTS.md` — added a **Concurrency** subsection under Common Patterns
and a note in the Networking section.
- `.github/copilot-instructions.md` — added a **Concurrency** subsection
under Swift Conventions and clarified the existing PromiseKit/HAKit
notes. (`CLAUDE.md` is a symlink to this file, so it's covered too.)
- `.cursorrules` — added a concurrency key rule and a code-style bullet.

These are documentation-only changes to AI agent guidance; no app code
is affected.

## Screenshots
N/A — documentation/instruction files only, no user-facing change.

## Link to pull request in Documentation repository
Documentation: home-assistant/companion.home-assistant#

## Any other notes
No-op for the build/tests — only Markdown instruction files for AI
agents changed.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-10 13:42:20 +00:00
..