workspace

Guidelines for organizing complex Rust projects as workspaces containing multiple crates, which are Rust packages or libraries. They cover domain-based, service-based, and layered structures.

In plain words
What is it for?
Use them to organize multi-crate Rust projects, define subsystem boundaries, manage shared dependencies, plan integration tests, and improve build organization.
Why use it?
They provide a consistent way to separate subsystems while sharing dependencies and infrastructure.

Cursor rule for Cursor

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add rules/tyrchen/cursor-rust-rules/workspace
Clone the repo
git clone --depth 1 https://github.com/tyrchen/cursor-rust-rules

Made for: Cursor.

Per session 0 Nothing until a file matches its globs; then the whole rule loads.
When invoked 9,549 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00000 $0.09549
Opus 5 $0.00000 $0.04775
Sonnet 5 $0.00000 $0.01910
Haiku 4.5 $0.00000 $0.00955

Measured 2d ago against content hash 05becb32e774, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

workspace scanned grade A with 0 findings against 26 rules in 11 categories โ€” prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency โ€” measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.cursor/rules/rust/complex/workspace.mdc ยท 1,318 lines

How it starts

The opening of the file, as written. The whole thing โ€” 1,318 lines โ€” stays where its author put it; the contents beside it link to each section on GitHub.

๐Ÿข MULTI-CRATE WORKSPACE STRUCTURE

TL;DR: Guidelines for organizing complex Rust projects using workspace architecture with multiple crates, clear subsystem boundaries, and domain-driven design principles.

๐Ÿ” WORKSPACE ARCHITECTURE STRATEGY

graph TD
    Start["Complex Project"] --> ArchType{"Architecture<br>Pattern?"}

    ArchType -->|Domain-Driven| DomainArch["Domain-Based Architecture"]
    ArchType -->|Service-Oriented| ServiceArch["Service-Based Architecture"]
    ArchType -->|Layered| LayeredArch["Layered Architecture"]

    DomainArch --> DomainCrates["Domain-Specific Crates"]
    ServiceArch --> ServiceCrates["Service-Specific Crates"]
    LayeredArch --> LayerCrates["Layer-Specific Crates"]

    DomainCrates --> SharedInfra["Shared Infrastructure"]
    ServiceCrates --> SharedInfra
    LayerCrates --> SharedInfra

    SharedInfra --> WorkspaceDeps["Workspace Dependencies"]
    WorkspaceDeps --> CrateOrganization["Crate Organization"]

    CrateOrganization --> IntegrationTesting["Integration Testing"]
    IntegrationTesting --> BuildOptimization["Build Optimization"]
    BuildOptimization --> Documentation["Workspace Documentation"]

    Documentation --> Production["Production Workspace"]

    style Start fill:#4da6ff,stroke:#0066cc,color:white
    style DomainArch fill:#4dbb5f,stroke:#36873f,color:white
    style ServiceArch fill:#ffa64d,stroke:#cc7a30,color:white
    style LayeredArch fill:#d94dbb,stroke:#a3378a,color:white

๐Ÿ—๏ธ SERVICE-ORIENTED WORKSPACE ARCHITECTURE

graph TD
    Workspace["Service Platform Workspace"] --> Shared["Shared Infrastructure"]
    Workspace --> CoreServices["Core Services"]
    Workspace --> BusinessServices["Business Services"]
    Workspace --> PlatformServices["Platform Services"]

    Shared --> SharedTypes["shared-types<br/>(domain primitives)"]
    Shared --> SharedConfig["shared-config<br/>(configuration)"]
    Shared --> SharedObservability["shared-observability<br/>(metrics & tracing)"]

    CoreServices --> ServiceCore["service-core<br/>(business logic)"]
    CoreServices --> ServiceApi["service-api<br/>(HTTP handlers)"]
    CoreServices --> ServiceWorker["service-worker<br/>(background jobs)"]

    BusinessServices --> BusinessCore["business-core<br/>(domain logic)"]
    BusinessServices --> BusinessApi["business-api<br/>(API endpoints)"]
    BusinessServices --> BusinessProcessor["business-processor<br/>(workflow engine)"]

    PlatformServices --> Gateway["gateway<br/>(API gateway)"]
    PlatformServices --> AdminPanel["admin-panel<br/>(administration)"]
    PlatformServices --> HealthMonitor["health-monitor<br/>(monitoring)"]

    style Workspace fill:#4da6ff,stroke:#0066cc,color:white
    style Shared fill:#4dbb5f,stroke:#36873f,color:white
    style CoreServices fill:#ffa64d,stroke:#cc7a30,color:white
    style BusinessServices fill:#d94dbb,stroke:#a3378a,color:white
    style PlatformServices fill:#9b59b6,stroke:#7d4796,color:white

Read the full file on GitHub ยท 1,318 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen ยท 1,318 lines ยท 0 tokens per session scan A 05becb32e774

Subscribe to this mod's changes

workspace is a cursor rule published in the GitHub repository tyrchen/cursor-rust-rules (27 stars, last pushed 1y ago), licensed MIT. It costs nothing until one of its globs matches a file; then it loads 9,549 tokens. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.