[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M72TPXWE7S2EJKZPF3JFSWFS":3,"skill-same:01M72TPXWE7S2EJKZPF3JFSWFS":81},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":60,"commitSha":61,"skillDirectory":62,"forksCount":14,"repositoryHtmlUrl":63,"repositoryHomepageUrl":63,"ownerHtmlUrl":64,"ownerBlogUrl":6,"ownerDescription":65,"updatedAt":66,"install":67,"resources":80},"01M72TPXWE7S2EJKZPF3JFSWFS","rust-workspace-patterns",null,"Use when structuring Rust workspaces. Layouts and splits.","iberi22\u002Fskills","iberi22","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F10615454?v=4","01M72SQ2NXAA3GW0FSH053A5ES","Brahyan Belalcazar","01M72SQ2PYCH0SSA1K61NGEHDV",0,"MIT","https:\u002F\u002Fgithub.com\u002Fiberi22\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Frust-development\u002Frust-workspace-patterns\u002FSKILL.md",[],[],"2026-11-10 22:39:42",false,"---\nname: rust-workspace-patterns\ndescription: \"Use when structuring Rust workspaces. Layouts and splits.\"\nversion: 1.0.0\nauthor: Hermes Agent for belal\nlicense: MIT\nplatforms: [linux, macos, windows]\nmetadata:\n  hermes:\n    tags: [rust, workspace, patterns, organization, architecture, dependency, feature-flags]\n    related_skills: [rust-compile-optimization, cargo-wizard, rust-code-quality-audit]\n    references:\n      - url: https:\u002F\u002Fdoc.rust-lang.org\u002Fcargo\u002Freference\u002Fworkspaces.html\n        title: \"Cargo Workspaces — Official Documentation\"\n        year: 2026\n      - url: https:\u002F\u002Fmatklad.github.io\u002F2021\u002F02\u002F06\u002FARCHITECTURE.md.html\n        title: \"Keep Your Architecture Documentation Clean — matklad\"\n        year: 2021\n      - url: https:\u002F\u002Frust-lang.github.io\u002Fapi-guidelines\u002F\n        title: \"Rust API Guidelines — C-CARGO\"\n        year: 2026\n      - url: https:\u002F\u002Fgithub.com\u002Frust-derive-eq\u002Fexample-project\n        title: \"Example Rust Workspace Project Structure\"\n        year: 2024\n---\n\n# Rust Workspace Patterns — Organización de Código y Dependencias\n\n## Cuándo usar\n\n- Organizar un proyecto Rust con múltiples crates\n- Decidir cómo dividir un monolito en workspaces\n- Gestionar dependencias compartidas entre crates\n- Configurar feature flags para compilación condicional\n- Crear un workspace desde cero con estructura correcta\n- Auditar la organización de un workspace existente\n\n## Estructura canónica de un workspace\n\n```\nmy-project\u002F\n├── Cargo.toml              # Workspace root\n├── crates\u002F\n│   ├── core\u002F               # Domain logic (sin dependencias externas pesadas)\n│   │   ├── Cargo.toml\n│   │   └── src\u002F\n│   ├── api\u002F                # HTTP\u002FREST layer (depends on core)\n│   │   ├── Cargo.toml\n│   │   └── src\u002F\n│   ├── cli\u002F                # CLI binary (depends on core + api)\n│   │   ├── Cargo.toml\n│   │   └── src\u002F\n│   └── proto\u002F              # Shared types (seria\u002FJSON schema)\n│       ├── Cargo.toml\n│       └── src\u002F\n├── scripts\u002F                # Build\u002Ftest scripts\n├── .cargo\u002F\n│   └── config.toml         # Workspace-wide cargo config\n└── README.md\n```\n\n## Regla de dependencias: Capas\n\n```toml\n# core\u002FCargo.toml — SIN dependencias de la organización\n[dependencies]\nserde = { version = \"1\", features = [\"derive\"] }\ntokio = { version = \"1\", features = [\"rt\", \"macros\"] }\n\n# api\u002FCargo.toml — DEPENDE de core\n[dependencies]\nmy-project-core = { path = \"..\u002Fcore\" }\naxum = \"0.7\"\ntower = \"0.4\"\n\n# cli\u002FCargo.toml — DEPENDE de core + api\n[dependencies]\nmy-project-core = { path = \"..\u002Fcore\" }\nmy-project-api = { path = \"..\u002Fapi\" }\nclap = { version = \"4\", features = [\"derive\"] }\n```\n\n**Regla:** Nunca crear dependencias circulares. `core` no depende de `api` ni `cli`.\n\n## Feature flags para compilación condicional\n\n### En un crate\n\n```toml\n# core\u002FCargo.toml\n[features]\ndefault = [\"json\"]\njson = [\"serde_json\"]\nsqlite = [\"rusqlite\"]\nenterprise = []  # Feature vacía para código condicional\n\n[dependencies]\nserde_json = { version = \"1\", optional = true }\nrusqlite = { version = \"0.31\", optional = true }\n```\n\n```rust\n\u002F\u002F core\u002Fsrc\u002Flib.rs\n#[cfg(feature = \"json\")]\npub mod json_support;\n\n#[cfg(feature = \"sqlite\")]\npub mod sqlite_store;\n\n#[cfg(feature = \"enterprise\")]\npub mod enterprise_features;\n```\n\n### En el workspace\n\n```toml\n# Cargo.toml (workspace root)\n[workspace.dependencies]\nserde = { version = \"1\", features = [\"derive\"] }\ntokio = { version = \"1\", features = [\"rt\", \"macros\"] }\n\n# crates heredan la versión exacta del workspace\n# core\u002FCargo.toml\n[dependencies]\nserde.workspace = true\ntokio.workspace = true\n```\n\n### Activar features desde CLI\n\n```bash\n# Solo con feature \"enterprise\"\ncargo build --features enterprise\n\n# Con múltiples features\ncargo build --features \"json,sqlite\"\n\n# Sin features por defecto\ncargo build --no-default-features\n\n# En workspace\ncargo build --workspace --features my-crate\u002Fenterprise\n```\n\n## Patrones de organización\n\n### 1. Proto\u002FShared types crate\n\nPara tipos compartidos entre frontend (TS\u002FFlutter) y backend (Rust):\n\n```\nproto\u002F\n├── Cargo.toml\n├── src\u002F\n│   ├── lib.rs\n│   ├── agent.rs      # AgentMessage, AgentState\n│   ├── memory.rs     # MemoryEntry, QueryResult\n│   └── event.rs      # EventType, EventPayload\n├── schemas\u002F          # JSON Schema (generado)\n└── scripts\u002F\n    └── build.sh      # Genera schemas + types TS\n```\n\n```toml\n# proto\u002FCargo.toml\n[dependencies]\nserde = { version = \"1\", features = [\"derive\"] }\nschemars = \"0.8\"  # Para JSON Schema\n```\n\n### 2. Adapter pattern (Hexagonal architecture)\n\n```rust\n\u002F\u002F core\u002Fsrc\u002Fports\u002Fmod.rs — Interfaces (trait objects)\npub mod storage {\n    pub trait Storage: Send + Sync {\n        fn save(&self, key: &str, value: &[u8]) -> Result\u003C()>;\n        fn load(&self, key: &str) -> Result\u003COption\u003CVec\u003Cu8>>>;\n    }\n}\n\n\u002F\u002F adapters\u002Fsrc\u002Fsqlite.rs — Implementación concreta\npub struct SqliteStorage {\n    conn: rusqlite::Connection,\n}\n\nimpl core::ports::storage::Storage for SqliteStorage {\n    fn save(&self, key: &str, value: &[u8]) -> Result\u003C()> {\n        \u002F\u002F Implementación SQLite\n    }\n    \u002F\u002F ...\n}\n```\n\n### 3. Error handling por capa\n\n```rust\n\u002F\u002F core\u002Fsrc\u002Ferror.rs — Errores del dominio\n#[derive(Debug, thiserror::Error)]\npub enum CoreError {\n    #[error(\"Not found: {0}\")]\n    NotFound(String),\n    \n    #[error(\"Validation failed: {0}\")]\n    Validation(String),\n    \n    #[error(\"Internal error: {0}\")]\n    Internal(#[from] anyhow::Error),\n}\n\n\u002F\u002F api\u002Fsrc\u002Ferror.rs — Errores HTTP (usa core errors)\n#[derive(Debug, thiserror::Error)]\npub enum ApiError {\n    #[error(transparent)]\n    Core(#[from] core::CoreError),\n    \n    #[error(\"Unauthorized\")]\n    Unauthorized,\n}\n\nimpl IntoResponse for ApiError {\n    fn into_response(self) -> Response {\n        match self {\n            ApiError::Core(e) => (StatusCode::INTERNAL_SERVER_ERROR, e.to_string()).into_response(),\n            ApiError::Unauthorized => (StatusCode::UNAUTHORIZED, \"Unauthorized\").into_response(),\n        }\n    }\n}\n```\n\n### 4. Config centralizado\n\n```rust\n\u002F\u002F config\u002Fsrc\u002Flib.rs — Config compartida\nuse serde::Deserialize;\n\n#[derive(Debug, Deserialize, Clone)]\npub struct AppConfig {\n    pub database: DatabaseConfig,\n    pub server: ServerConfig,\n    pub features: FeatureFlags,\n}\n\n#[derive(Debug, Deserialize, Clone)]\npub struct FeatureFlags {\n    pub enterprise: bool,\n    pub analytics: bool,\n}\n\n\u002F\u002F Uso en api\npub async fn start_server(config: AppConfig) {\n    let app = Router::new()\n        .route(\"\u002F\", get(health))\n        .with_state(config.server);\n}\n```\n\n### 5. Test helpers compartidos\n\n```\ncrates\u002F\n├── core\u002F\n│   ├── src\u002F\n│   └── tests\u002F\n│       └── common\u002F\n│           └── mod.rs  # Test fixtures\n├── api\u002F\n│   ├── src\u002F\n│   └── tests\u002F\n│       └── common\u002F\n│           └── mod.rs  # Re-exporta core::tests::common\n```\n\n## Gestión de dependencias\n\n### Verificar dependencias no usadas\n\n```bash\n# Detectar dependencias no usadas\ncargo machete\n\n# Verificar features activas\ncargo tree -e features\n\n# Verificar dependencias duplicadas\ncargo tree --duplicates\n```\n\n### Actualizar dependencias\n\n```bash\n# Verificar updates disponibles\ncargo outdated\n\n# Actualizar todas\ncargo update\n\n# Actualizar una específica\ncargo update -p serde\n```\n\n### Dependencias del workspace\n\n```toml\n# Cargo.toml (workspace root)\n[workspace.dependencies]\n# Definir versiones una vez\nserde = { version = \"1\", features = [\"derive\"] }\ntokio = { version = \"1\", features = [\"rt\", \"macros\"] }\n\n# En crates individuales\n# core\u002FCargo.toml\n[dependencies]\nserde.workspace = true\ntokio.workspace = true\n```\n\n## Patrones anti-patrones\n\n### ❌ Monolito gigante\n\n```rust\n\u002F\u002F src\u002Fmain.rs — 5000 líneas, TODO mezclado\nfn main() {\n    \u002F\u002F HTTP handlers, DB logic, CLI parsing, business logic...\n}\n```\n\n### ✅ Workspace separado\n\n```\ncrates\u002F\n├── core\u002F      # Business logic\n├── api\u002F       # HTTP layer\n├── cli\u002F       # CLI interface\n└── proto\u002F     # Shared types\n```\n\n### ❌ Dependencias circulares\n\n```toml\n# core\u002FCargo.toml\n[dependencies]\nmy-project-api = { path = \"..\u002Fapi\" }  # ❌ core no debería depender de api\n```\n\n### ✅ Dependency inversion\n\n```rust\n\u002F\u002F core define el trait\npub trait ApiClient: Send + Sync {\n    fn send_request(&self, url: &str) -> Result\u003CResponse>;\n}\n\n\u002F\u002F api implementa el trait\nimpl ApiClient for ReqwestClient {\n    fn send_request(&self, url: &str) -> Result\u003CResponse> {\n        \u002F\u002F reqwest implementation\n    }\n}\n```\n\n## Comandos útiles para workspaces\n\n```bash\n# Build todo el workspace\ncargo build --workspace\n\n# Test todo el workspace\ncargo test --workspace\n\n# Test un crate específico\ncargo test -p my-crate\n\n# Clippy en todo\ncargo clippy --workspace\n\n# Formatear todo\ncargo fmt --all\n\n# Verificar compilación sin build\ncargo check --workspace\n\n# Ver miembros del workspace\ncargo metadata --format-version 1 | jq '.workspace_members'\n```\n\n## Referencias\n\n1. **Cargo Workspaces (Official)**: https:\u002F\u002Fdoc.rust-lang.org\u002Fcargo\u002Freference\u002Fworkspaces.html — Documentación oficial de Cargo.\n2. **ARCHITECTURE.md (matklad)**: https:\u002F\u002Fmatklad.github.io\u002F2021\u002F02\u002F06\u002FARCHITECTURE.md.html — Cómo documentar arquitectura de proyectos Rust.\n3. **Rust API Guidelines**: https:\u002F\u002Frust-lang.github.io\u002Fapi-guidelines\u002F — Guidelines para APIs de Rust.\n4. **Cargo Book (Workspaces)**: https:\u002F\u002Fdoc.rust-lang.org\u002Fcargo\u002Fbook\u002Fworkspaces.html — Guía de workspaces.\n5. **Rust Design Patterns**: https:\u002F\u002Frust-unofficial.github.io\u002Fpatterns\u002F — Patrones de diseño en Rust.\n6. **Thiserror**: https:\u002F\u002Fgithub.com\u002Fdtolnay\u002Fthiserror — Derive macro para errores.\n7. **Anyhow**: https:\u002F\u002Fgithub.com\u002Fdtolnay\u002Fanyhow — Error handling para applications.\n8. **Schemars**: https:\u002F\u002Fgithub.com\u002FGREsau\u002Fschemars — JSON Schema generation desde Rust.\n\n## Pitfalls\n\n| Problema | Causa | Solución |\n|----------|-------|----------|\n| \"cycle detected\" en cargo | Dependencias circulares | Revisar el grafo de dependencias con `cargo tree` |\n| Feature unification problem | Features se unen en workspace | Usar `resolver = \"2\"` en workspace root |\n| Test helpers duplicados | Cada crate tiene sus propios fixtures | Crear crate `test-utils` compartido |\n| Path dependency hell | Muchos crates con `path = \"..\u002F\"` | Considerar crates.io o git deps para crates estables |\n| Stale feature flags | Features que nadie usa | `cargo machete` + revisar `cfg(feature = \"...\")` en código |\n| Build times explode | Workspace muy grande | Split en sub-workspaces o reducir dependencies |\n\n---\n\n*Rust Workspace Patterns — v1.0.0*\n","# Rust Workspace Patterns — Organización de Código y Dependencias\n\n## Cuándo usar\n\n- Organizar un proyecto Rust con múltiples crates\n- Decidir cómo dividir un monolito en workspaces\n- Gestionar dependencias compartidas entre crates\n- Configurar feature flags para compilación condicional\n- Crear un workspace desde cero con estructura correcta\n- Auditar la organización de un workspace existente\n\n## Estructura canónica de un workspace\n\n```\nmy-project\u002F\n├── Cargo.toml              # Workspace root\n├── crates\u002F\n│   ├── core\u002F               # Domain logic (sin dependencias externas pesadas)\n│   │   ├── Cargo.toml\n│   │   └── src\u002F\n│   ├── api\u002F                # HTTP\u002FREST layer (depends on core)\n│   │   ├── Cargo.toml\n│   │   └── src\u002F\n│   ├── cli\u002F                # CLI binary (depends on core + api)\n│   │   ├── Cargo.toml\n│   │   └── src\u002F\n│   └── proto\u002F              # Shared types (seria\u002FJSON schema)\n│       ├── Cargo.toml\n│       └── src\u002F\n├── scripts\u002F                # Build\u002Ftest scripts\n├── .cargo\u002F\n│   └── config.toml         # Workspace-wide cargo config\n└── README.md\n```\n\n## Regla de dependencias: Capas\n\n```toml\n# core\u002FCargo.toml — SIN dependencias de la organización\n[dependencies]\nserde = { version = \"1\", features = [\"derive\"] }\ntokio = { version = \"1\", features = [\"rt\", \"macros\"] }\n\n# api\u002FCargo.toml — DEPENDE de core\n[dependencies]\nmy-project-core = { path = \"..\u002Fcore\" }\naxum = \"0.7\"\ntower = \"0.4\"\n\n# cli\u002FCargo.toml — DEPENDE de core + api\n[dependencies]\nmy-project-core = { path = \"..\u002Fcore\" }\nmy-project-api = { path = \"..\u002Fapi\" }\nclap = { version = \"4\", features = [\"derive\"] }\n```\n\n**Regla:** Nunca crear dependencias circulares. `core` no depende de `api` ni `cli`.\n\n## Feature flags para compilación condicional\n\n### En un crate\n\n```toml\n# core\u002FCargo.toml\n[features]\ndefault = [\"json\"]\njson = [\"serde_json\"]\nsqlite = [\"rusqlite\"]\nenterprise = []  # Feature vacía para código condicional\n\n[dependencies]\nserde_json = { version = \"1\", optional = true }\nrusqlite = { version = \"0.31\", optional = true }\n```\n\n```rust\n\u002F\u002F core\u002Fsrc\u002Flib.rs\n#[cfg(feature = \"json\")]\npub mod json_support;\n\n#[cfg(feature = \"sqlite\")]\npub mod sqlite_store;\n\n#[cfg(feature = \"enterprise\")]\npub mod enterprise_features;\n```\n\n### En el workspace\n\n```toml\n# Cargo.toml (workspace root)\n[workspace.dependencies]\nserde = { version = \"1\", features = [\"derive\"] }\ntokio = { version = \"1\", features = [\"rt\", \"macros\"] }\n\n# crates heredan la versión exacta del workspace\n# core\u002FCargo.toml\n[dependencies]\nserde.workspace = true\ntokio.workspace = true\n```\n\n### Activar features desde CLI\n\n```bash\n# Solo con feature \"enterprise\"\ncargo build --features enterprise\n\n# Con múltiples features\ncargo build --features \"json,sqlite\"\n\n# Sin features por defecto\ncargo build --no-default-features\n\n# En workspace\ncargo build --workspace --features my-crate\u002Fenterprise\n```\n\n## Patrones de organización\n\n### 1. Proto\u002FShared types crate\n\nPara tipos compartidos entre frontend (TS\u002FFlutter) y backend (Rust):\n\n```\nproto\u002F\n├── Cargo.toml\n├── src\u002F\n│   ├── lib.rs\n│   ├── agent.rs      # AgentMessage, AgentState\n│   ├── memory.rs     # MemoryEntry, QueryResult\n│   └── event.rs      # EventType, EventPayload\n├── schemas\u002F          # JSON Schema (generado)\n└── scripts\u002F\n    └── build.sh      # Genera schemas + types TS\n```\n\n```toml\n# proto\u002FCargo.toml\n[dependencies]\nserde = { version = \"1\", features = [\"derive\"] }\nschemars = \"0.8\"  # Para JSON Schema\n```\n\n### 2. Adapter pattern (Hexagonal architecture)\n\n```rust\n\u002F\u002F core\u002Fsrc\u002Fports\u002Fmod.rs — Interfaces (trait objects)\npub mod storage {\n    pub trait Storage: Send + Sync {\n        fn save(&self, key: &str, value: &[u8]) -> Result\u003C()>;\n        fn load(&self, key: &str) -> Result\u003COption\u003CVec\u003Cu8>>>;\n    }\n}\n\n\u002F\u002F adapters\u002Fsrc\u002Fsqlite.rs — Implementación concreta\npub struct SqliteStorage {\n    conn: rusqlite::Connection,\n}\n\nimpl core::ports::storage::Storage for SqliteStorage {\n    fn save(&self, key: &str, value: &[u8]) -> Result\u003C()> {\n        \u002F\u002F Implementación SQLite\n    }\n    \u002F\u002F ...\n}\n```\n\n### 3. Error handling por capa\n\n```rust\n\u002F\u002F core\u002Fsrc\u002Ferror.rs — Errores del dominio\n#[derive(Debug, thiserror::Error)]\npub enum CoreError {\n    #[error(\"Not found: {0}\")]\n    NotFound(String),\n    \n    #[error(\"Validation failed: {0}\")]\n    Validation(String),\n    \n    #[error(\"Internal error: {0}\")]\n    Internal(#[from] anyhow::Error),\n}\n\n\u002F\u002F api\u002Fsrc\u002Ferror.rs — Errores HTTP (usa core errors)\n#[derive(Debug, thiserror::Error)]\npub enum ApiError {\n    #[error(transparent)]\n    Core(#[from] core::CoreError),\n    \n    #[error(\"Unauthorized\")]\n    Unauthorized,\n}\n\nimpl IntoResponse for ApiError {\n    fn into_response(self) -> Response {\n        match self {\n            ApiError::Core(e) => (StatusCode::INTERNAL_SERVER_ERROR, e.to_string()).into_response(),\n            ApiError::Unauthorized => (StatusCode::UNAUTHORIZED, \"Unauthorized\").into_response(),\n        }\n    }\n}\n```\n\n### 4. Config centralizado\n\n```rust\n\u002F\u002F config\u002Fsrc\u002Flib.rs — Config compartida\nuse serde::Deserialize;\n\n#[derive(Debug, Deserialize, Clone)]\npub struct AppConfig {\n    pub database: DatabaseConfig,\n    pub server: ServerConfig,\n    pub features: FeatureFlags,\n}\n\n#[derive(Debug, Deserialize, Clone)]\npub struct FeatureFlags {\n    pub enterprise: bool,\n    pub analytics: bool,\n}\n\n\u002F\u002F Uso en api\npub async fn start_server(config: AppConfig) {\n    let app = Router::new()\n        .route(\"\u002F\", get(health))\n        .with_state(config.server);\n}\n```\n\n### 5. Test helpers compartidos\n\n```\ncrates\u002F\n├── core\u002F\n│   ├── src\u002F\n│   └── tests\u002F\n│       └── common\u002F\n│           └── mod.rs  # Test fixtures\n├── api\u002F\n│   ├── src\u002F\n│   └── tests\u002F\n│       └── common\u002F\n│           └── mod.rs  # Re-exporta core::tests::common\n```\n\n## Gestión de dependencias\n\n### Verificar dependencias no usadas\n\n```bash\n# Detectar dependencias no usadas\ncargo machete\n\n# Verificar features activas\ncargo tree -e features\n\n# Verificar dependencias duplicadas\ncargo tree --duplicates\n```\n\n### Actualizar dependencias\n\n```bash\n# Verificar updates disponibles\ncargo outdated\n\n# Actualizar todas\ncargo update\n\n# Actualizar una específica\ncargo update -p serde\n```\n\n### Dependencias del workspace\n\n```toml\n# Cargo.toml (workspace root)\n[workspace.dependencies]\n# Definir versiones una vez\nserde = { version = \"1\", features = [\"derive\"] }\ntokio = { version = \"1\", features = [\"rt\", \"macros\"] }\n\n# En crates individuales\n# core\u002FCargo.toml\n[dependencies]\nserde.workspace = true\ntokio.workspace = true\n```\n\n## Patrones anti-patrones\n\n### ❌ Monolito gigante\n\n```rust\n\u002F\u002F src\u002Fmain.rs — 5000 líneas, TODO mezclado\nfn main() {\n    \u002F\u002F HTTP handlers, DB logic, CLI parsing, business logic...\n}\n```\n\n### ✅ Workspace separado\n\n```\ncrates\u002F\n├── core\u002F      # Business logic\n├── api\u002F       # HTTP layer\n├── cli\u002F       # CLI interface\n└── proto\u002F     # Shared types\n```\n\n### ❌ Dependencias circulares\n\n```toml\n# core\u002FCargo.toml\n[dependencies]\nmy-project-api = { path = \"..\u002Fapi\" }  # ❌ core no debería depender de api\n```\n\n### ✅ Dependency inversion\n\n```rust\n\u002F\u002F core define el trait\npub trait ApiClient: Send + Sync {\n    fn send_request(&self, url: &str) -> Result\u003CResponse>;\n}\n\n\u002F\u002F api implementa el trait\nimpl ApiClient for ReqwestClient {\n    fn send_request(&self, url: &str) -> Result\u003CResponse> {\n        \u002F\u002F reqwest implementation\n    }\n}\n```\n\n## Comandos útiles para workspaces\n\n```bash\n# Build todo el workspace\ncargo build --workspace\n\n# Test todo el workspace\ncargo test --workspace\n\n# Test un crate específico\ncargo test -p my-crate\n\n# Clippy en todo\ncargo clippy --workspace\n\n# Formatear todo\ncargo fmt --all\n\n# Verificar compilación sin build\ncargo check --workspace\n\n# Ver miembros del workspace\ncargo metadata --format-version 1 | jq '.workspace_members'\n```\n\n## Referencias\n\n1. **Cargo Workspaces (Official)**: https:\u002F\u002Fdoc.rust-lang.org\u002Fcargo\u002Freference\u002Fworkspaces.html — Documentación oficial de Cargo.\n2. **ARCHITECTURE.md (matklad)**: https:\u002F\u002Fmatklad.github.io\u002F2021\u002F02\u002F06\u002FARCHITECTURE.md.html — Cómo documentar arquitectura de proyectos Rust.\n3. **Rust API Guidelines**: https:\u002F\u002Frust-lang.github.io\u002Fapi-guidelines\u002F — Guidelines para APIs de Rust.\n4. **Cargo Book (Workspaces)**: https:\u002F\u002Fdoc.rust-lang.org\u002Fcargo\u002Fbook\u002Fworkspaces.html — Guía de workspaces.\n5. **Rust Design Patterns**: https:\u002F\u002Frust-unofficial.github.io\u002Fpatterns\u002F — Patrones de diseño en Rust.\n6. **Thiserror**: https:\u002F\u002Fgithub.com\u002Fdtolnay\u002Fthiserror — Derive macro para errores.\n7. **Anyhow**: https:\u002F\u002Fgithub.com\u002Fdtolnay\u002Fanyhow — Error handling para applications.\n8. **Schemars**: https:\u002F\u002Fgithub.com\u002FGREsau\u002Fschemars — JSON Schema generation desde Rust.\n\n## Pitfalls\n\n| Problema | Causa | Solución |\n|----------|-------|----------|\n| \"cycle detected\" en cargo | Dependencias circulares | Revisar el grafo de dependencias con `cargo tree` |\n| Feature unification problem | Features se unen en workspace | Usar `resolver = \"2\"` en workspace root |\n| Test helpers duplicados | Cada crate tiene sus propios fixtures | Crear crate `test-utils` compartido |\n| Path dependency hell | Muchos crates con `path = \"..\u002F\"` | Considerar crates.io o git deps para crates estables |\n| Stale feature flags | Features que nadie usa | `cargo machete` + revisar `cfg(feature = \"...\")` en código |\n| Build times explode | Workspace muy grande | Split en sub-workspaces o reducir dependencies |\n\n---\n\n*Rust Workspace Patterns — v1.0.0*\n",{"name":5,"author":24,"license":15,"version":25,"metadata":26,"platforms":56,"description":7},"Hermes Agent for belal","1.0.0",{"hermes":27},{"tags":28,"references":36,"related_skills":52},[29,30,31,32,33,34,35],"rust","workspace","patterns","organization","architecture","dependency","feature-flags",[37,41,45,48],{"url":38,"year":39,"title":40},"https:\u002F\u002Fdoc.rust-lang.org\u002Fcargo\u002Freference\u002Fworkspaces.html",2026,"Cargo Workspaces — Official Documentation",{"url":42,"year":43,"title":44},"https:\u002F\u002Fmatklad.github.io\u002F2021\u002F02\u002F06\u002FARCHITECTURE.md.html",2021,"Keep Your Architecture Documentation Clean — matklad",{"url":46,"year":39,"title":47},"https:\u002F\u002Frust-lang.github.io\u002Fapi-guidelines\u002F","Rust API Guidelines — C-CARGO",{"url":49,"year":50,"title":51},"https:\u002F\u002Fgithub.com\u002Frust-derive-eq\u002Fexample-project",2024,"Example Rust Workspace Project Structure",[53,54,55],"rust-compile-optimization","cargo-wizard","rust-code-quality-audit",[57,58,59],"linux","macos","windows","main","688810f2886d212632acf81e532b24e483dd8b98","skills\u002Frust-development\u002Frust-workspace-patterns","https:\u002F\u002Fgithub.com\u002Fiberi22\u002Fskills","https:\u002F\u002Fgithub.com\u002Fiberi22","Senior WEB Full-Stack","2026-10-12 02:46:21",{"source":8,"skillName":5,"commands":68,"prompt":78,"zipAvailable":79},[69,72,75],{"tool":70,"command":71},"npx","npx skills add iberi22\u002Fskills --skill rust-workspace-patterns",{"tool":73,"command":74},"bunx","bunx skills add iberi22\u002Fskills --skill rust-workspace-patterns",{"tool":76,"command":77},"pnpm","pnpm dlx skills add iberi22\u002Fskills --skill rust-workspace-patterns","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fiberi22\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Frust-development\u002Frust-workspace-patterns\u002FSKILL.md",true,[],[82,88,95,101,107,113],{"skillNo":83,"name":84,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":85,"categories":86,"keywords":87,"publishedAt":19},"01M72TWQEQD46ZC9TRBAABF78P","web-design-guidelines","https:\u002F\u002Fgithub.com\u002Fiberi22\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fweb\u002Fweb-design-guidelines\u002FSKILL.md",[],[],{"skillNo":89,"name":90,"nameZh":6,"description":91,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":92,"categories":93,"keywords":94,"publishedAt":19},"01M72TWMQFTYD08DGXVAXRPPEB","blocked-page-recovery","Use when a fetch fails: 403\u002F429, paywall, WAF, bot wall. Recovers the page via archives and provenance-checked fallbacks.","https:\u002F\u002Fgithub.com\u002Fiberi22\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fweb\u002Fblocked-page-recovery\u002FSKILL.md",[],[],{"skillNo":96,"name":97,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":98,"categories":99,"keywords":100,"publishedAt":19},"01M72TVQMS3HCTX18C8T97WTQQ","studio-coach","https:\u002F\u002Fgithub.com\u002Fiberi22\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Ftools\u002Fstudio-coach\u002FSKILL.md",[],[],{"skillNo":102,"name":103,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":104,"categories":105,"keywords":106,"publishedAt":19},"01M72TVNA2PR9RZW0ZAXYP1G6J","src-generator","https:\u002F\u002Fgithub.com\u002Fiberi22\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Ftools\u002Fsrc-generator\u002FSKILL.md",[],[],{"skillNo":108,"name":109,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":110,"categories":111,"keywords":112,"publishedAt":19},"01M72TVEJHHB6SAT3R3TY9MJKS","sqlite-pro","https:\u002F\u002Fgithub.com\u002Fiberi22\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Ftools\u002Fsqlite-pro\u002FSKILL.md",[],[],{"skillNo":114,"name":115,"nameZh":6,"description":116,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":117,"categories":118,"keywords":119,"publishedAt":19},"01M72TVC2EVBHQHCX96VTTYKB8","rigor-evaluator","Use when you need a quick heuristic rigor score (10 criteria, 0-2 each) for the features in a .gitcore\u002Ffeatures.json file, to decide which features are ready to ship.","https:\u002F\u002Fgithub.com\u002Fiberi22\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Ftools\u002Frigor-evaluator\u002FSKILL.md",[],[]]