petchat-standard

What problem does it solve?

This Skill reduces costly integration mistakes by enforcing PetChat’s client-server architecture, protocol rules, clean-code conventions, and mandatory verification steps before changes are considered complete.

Core Features & Use Cases

• Architecture guardrails: Keeps heavy logic (AI and heavy DB operations) on the server while making the PyQt6 client UI “dumb,” preserving the Client-Server design.
• Protocol safety: Protects the TCP message protocol by requiring that the fixed header and routing workflow stay consistent when adding features.
• Clean-code standards: Enforces type hints for all function signatures and forbids inline “what” comments to keep code readable and consistent.
• Threading correctness for PyQt6: Requires background threads for network/DB I/O and strictly uses pyqtSignal for main-thread UI updates.
• Testing & verification workflow (critical): Makes network/protocol, server logic, and concurrency/stress verification part of the definition of done.

Quick Start

Ask an AI assistant to implement your change in PetChat while following the constraints in petchat-standard, then run tests/network_test.py, tests/verify_cs_server.py, and tests/stress_test.py to confirm it is production-safe.