cargo build                                                    # Build workspace
cargo test --workspace --all-features                         # Run all tests
cargo test -p planning_poker_models                           # Run single package tests
cargo fmt --all                                               # Format code
cargo clippy --workspace --all-targets --all-features -- -D warnings  # Lint

Server/App Runtime Restrictions

DO NOT run server commands: Never execute

cargo run --bin planning-poker-server

cargo run --bin planning_poker_app

Interactive processes hang: These commands start interactive/infinite runtime processes that will hang the agent
Build/test only: Only use build, test, format, and lint commands - never attempt to serve the application
Verification approach: Use
```
cargo build
```
to verify the server/app compiles correctly

Code Style

Use
```
Result<T, E>
```
for error handling, never
```
unwrap()
```
in production code
Import order: std, external crates, workspace crates, local modules
Use
```
tracing
```
for logging, not
```
println!
```
or
```
log
```
Document public APIs with
```
///
```
doc comments
Use
```
snake_case
```
for functions/variables,
```
PascalCase
```
for types/enums
Prefer explicit types over
```
auto
```
/inference in public APIs

Use

#[derive(Debug, Clone, Serialize, Deserialize)]

for data models

Handle
```
Option
```
and
```
Result
```
explicitly, avoid
```
.unwrap()
```
except in tests

Frontend Technology

Uses hyperchad, NOT htmx: This project uses a custom library called "hyperchad" that resembles htmx but is not htmx
Limited feature set: hyperchad does not have all the features of htmx - check existing code patterns before assuming htmx functionality exists
Custom implementation: When working with frontend interactions, refer to existing hyperchad usage patterns in the codebase

Architecture

Modular workspace: models (pure data) → poker (business logic) → session/database → websocket/api → server/app/ui

Build/Test Commands

cargo build                                                    # Build workspace
cargo test --workspace --all-features                         # Run all tests
cargo test -p planning_poker_models                           # Run single package tests
cargo fmt --all                                               # Format code
cargo clippy --workspace --all-targets --all-features -- -D warnings  # Lint

Server/App Runtime Restrictions

DO NOT run server commands: Never execute

cargo run --bin planning-poker-server

cargo run --bin planning_poker_app

Interactive processes hang: These commands start interactive/infinite runtime processes that will hang the agent

Build/test only: Only use build, test, format, and lint commands - never attempt to serve the application

Verification approach: Use

cargo build

to verify the server/app compiles correctly

Code Style

Use

Result<T, E>

for error handling, never

unwrap()

in production code

Import order: std, external crates, workspace crates, local modules

Use

tracing

for logging, not

println!

log

Document public APIs with

///

doc comments

Use

snake_case

for functions/variables,

PascalCase

for types/enums

Prefer explicit types over

auto

/inference in public APIs

Use

#[derive(Debug, Clone, Serialize, Deserialize)]

for data models

Handle

Option

and

Result

explicitly, avoid

.unwrap()

except in tests

Frontend Technology

Uses hyperchad, NOT htmx: This project uses a custom library called "hyperchad" that resembles htmx but is not htmx

Limited feature set: hyperchad does not have all the features of htmx - check existing code patterns before assuming htmx functionality exists

Custom implementation: When working with frontend interactions, refer to existing hyperchad usage patterns in the codebase

AI Agent Instructions for Planning Poker

AI Agent Instructions for Planning Poker

NixOS Environment

Git Usage Restrictions

Build/Test Commands

Server/App Runtime Restrictions

Code Style

Frontend Technology

Architecture

Related Skills

Markdown Converter

Nano Banana Pro

1password

AI Agent Instructions for Planning Poker

NixOS Environment

Git Usage Restrictions

Build/Test Commands

Server/App Runtime Restrictions

Code Style

Frontend Technology

Architecture