mirror of https://github.com/ultraworkers/claw-code.git synced 2026-04-30 16:55:49 +08:00

Yeachan-Heo 07992b8a1b Make Rust formatting guidance runnable from repo root

The Rust crate layout expects formatting to run from the rust directory, so add a root-level wrapper that preserves the working command while forwarding user flags like --check. Documentation now points contributors at the wrapper instead of the misleading virtual-workspace manifest invocation.

Constraint: Root-level cargo fmt --manifest-path rust/Cargo.toml is misleading for this virtual workspace
Rejected: Document cd rust && cargo fmt directly | a root wrapper gives one stable repo-root command
Confidence: high
Scope-risk: narrow
Tested: scripts/fmt.sh --check
Tested: git diff --check

2026-04-28 09:38:08 +00:00

1.2 KiB

Raw Blame History

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Detected stack

Languages: Rust.
Frameworks: none detected from the supported starter markers.

Verification

Run Rust verification from repo root: scripts/fmt.sh --check; for formatting use scripts/fmt.sh. Run Rust clippy/tests from rust/: cargo clippy --workspace --all-targets -- -D warnings, cargo test --workspace
src/ and tests/ are both present; update both surfaces together when behavior changes.

Repository shape

rust/ contains the Rust workspace and active CLI/runtime implementation.
src/ contains source files that should stay consistent with generated guidance and tests.
tests/ contains validation surfaces that should be reviewed alongside code changes.

Working agreement

Prefer small, reviewable changes and keep generated bootstrap files aligned with actual repo workflows.
Keep shared defaults in .claude.json; reserve .claude/settings.local.json for machine-local overrides.
Do not overwrite existing CLAUDE.md content automatically; update it intentionally when repo workflows change.