tokio-scaffold

Tokio Scaffold Command

This command scaffolds new Tokio-based Rust projects with modern structure, proper dependencies, error handling patterns, tracing infrastructure, and testing setup.

Arguments

• $1 - Project name (required)
• $2 - Project type: http-server, grpc-server, tcp-server, cli, or library (optional, defaults to library)

Usage

/rust-tokio-expert:tokio-scaffold my-service http-server
/rust-tokio-expert:tokio-scaffold my-cli cli
/rust-tokio-expert:tokio-scaffold my-lib library

Workflow

1. Validate Arguments

   • Check that project name is provided
   • Validate project type if provided
   • Ensure target directory doesn't already exist

2. Invoke Agent

   • Use Task tool with subagent_type="rust-tokio-expert:tokio-pro"
   • Pass project name and type to the agent

3. Agent Instructions

   The agent should create a complete project structure based on the type:

   For HTTP Server Projects

   Create:

   • Cargo.toml with dependencies:

     • tokio with full features
     • axum for HTTP framework
     • tower and tower-http for middleware
     • serde and serde_json for serialization
     • tracing and tracing-subscriber for logging
     • anyhow and thiserror for error handling
     • sqlx (optional) for database
     • config for configuration management

   • src/main.rs with:

     • Runtime setup with tracing
     • Router configuration
     • Graceful shutdown handling
     • Health check endpoints

   • src/handlers/mod.rs with example HTTP handlers

   • src/error.rs with custom error types

   • src/config.rs with configuration loading

   • src/telemetry.rs with tracing setup

   • tests/integration_test.rs with API integration tests

   • .env.example with configuration template

   • README.md with usage instructions

   For gRPC Server Projects

   Create:

   • Cargo.toml with:
     • tokio with full features
     • tonic and tonic-build
     • prost for protobuf
     • tower for middleware
     • tracing infrastructure
     • error handling crates