codemod-rust-workspace
Use when working on Codemod's Rust workspace, including workflow engine crates, models, state, runners, scheduler, CLI-adjacent Rust crates, schema generation, Cargo features, Rust tests, clippy, rustfmt, or CI parity.
Informations de source
- Dépôt
- tomevault-io/tomes
- Dernière activité de la source
- 23 juillet 2026 à 21:48
- Langue détectée de SKILL.md
- anglais
- Étoiles
- 1
- Forks
- 0
Options d'installation
Le prompt qui vérifie d'abord la source est sélectionné par défaut. Vous pouvez passer à une commande directe ou télécharger une copie locale.
Vérifiez les fichiers source
Lisez SKILL.md et les fichiers associés affichés par SkillsMP avant de décider de l'installer.
Affichage de SKILL.md
SKILL.md
Instructions source · Aperçu en lecture seule- name
- codemod-rust-workspace
- description
- Use when working on Codemod's Rust workspace, including workflow engine crates, models, state, runners, scheduler, CLI-adjacent Rust crates, schema generation, Cargo features, Rust tests, clippy, rustfmt, or CI parity.
- metadata
- {"author":"codemod"}
# Codemod Rust Workspace
## Start Here
1. Read the nearest `AGENTS.md` for the crate you are changing.
2. Identify the crate role before editing:
- `butterflow-models`: workflow schema/data contracts.
- `butterflow-core`: execution engine, step execution, reports, git/file operations.
- `butterflow-state`: state adapters.
- `butterflow-runners`: Docker/Podman/direct runner abstractions.
- `butterflow-scheduler`: task scheduling and WASM package logic.
- `codemod`: CLI command surface and TUI.
- `codemod-sandbox`: JSSG runtime and sandbox.
- `testing-utils`: shared test helpers.
3. Prefer workspace dependencies in root `Cargo.toml`.
## Implementation Rules
- Keep model contracts in `crates/models`; avoid duplicate public structs in higher-level crates.
- Preserve async cancellation and error propagation.
- Avoid logging-only failures for user-visible workflow behavior.
- Do not write directly to stdout/stderr from non-CLI crates. Return structured data, errors, events,
reports, or log records and let `crates/cli` choose text, TUI, JSONL, or task-log routing.
- Keep feature gates meaningful, especially `docker`, `podman`, `wasm`, `native`, and `real-fs`.
- For schema-affecting model changes, run `cargo xtask schema` and review generated diffs.
## Validation
- Focused crate: `cargo test -p <crate>`
- Workspace: `cargo test`
- Format: `cargo fmt --check`
- Lint: `cargo clippy --tests --no-deps -- -D warnings`
- CI parity for terminal dependencies: `bash ./scripts/check-single-crossterm.sh`
---
> Source: [codemod/codemod](https://github.com/codemod/codemod) — distributed by [TomeVault](https://tomevault.io).
<!-- tomevault:4.0:skill_md:2026-07-20 -->
Voir sur GitHub