a776744889
- Rust workspace with stemedb-core crate - Full .claude/ configuration (agents, skills, commands, guides) - ai-lookup/ for token-efficient fact storage - Quality gates: clippy, fmt, jscpd duplication detection - Pre-commit hook with 5-phase quality checks - CLAUDE.md router and CODING_GUIDELINES.md standards Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
86 lines
1.4 KiB
Markdown
86 lines
1.4 KiB
Markdown
# Local Development Setup
|
|
|
|
**When to use:** Setting up StemeDB for local development.
|
|
|
|
## Prerequisites
|
|
|
|
- Rust 1.75+ (2024 edition)
|
|
- `cargo` and `rustup`
|
|
|
|
## Quick Start
|
|
|
|
```bash
|
|
# Clone and enter
|
|
cd stemedb
|
|
|
|
# Build everything
|
|
cargo build --workspace
|
|
|
|
# Run tests
|
|
cargo test --workspace
|
|
|
|
# Run lints (must pass)
|
|
cargo clippy --workspace -- -D warnings
|
|
cargo fmt --check
|
|
```
|
|
|
|
## IDE Setup
|
|
|
|
### VS Code
|
|
|
|
Install extensions:
|
|
- rust-analyzer
|
|
- Even Better TOML
|
|
- Error Lens (optional, shows inline errors)
|
|
|
|
Settings (`.vscode/settings.json`):
|
|
```json
|
|
{
|
|
"rust-analyzer.check.command": "clippy",
|
|
"rust-analyzer.check.allTargets": true
|
|
}
|
|
```
|
|
|
|
### JetBrains (RustRover/CLion)
|
|
|
|
- Enable Clippy as default checker
|
|
- Set rustfmt on save
|
|
|
|
## Project Structure
|
|
|
|
```
|
|
stemedb/
|
|
CLAUDE.md # AI router (start here)
|
|
CODING_GUIDELINES.md # Rust standards
|
|
Cargo.toml # Workspace root
|
|
crates/
|
|
stemedb-core/ # Core types and storage
|
|
.claude/
|
|
agents/ # Specialized AI agents
|
|
commands/ # Slash commands
|
|
skills/ # Reusable procedures
|
|
guides/ # You are here
|
|
```
|
|
|
|
## Troubleshooting
|
|
|
|
### Build fails with missing dependencies
|
|
|
|
```bash
|
|
rustup update
|
|
cargo clean
|
|
cargo build
|
|
```
|
|
|
|
### Clippy warnings
|
|
|
|
Run with `--fix` for auto-corrections:
|
|
```bash
|
|
cargo clippy --workspace --fix --allow-dirty
|
|
```
|
|
|
|
## Related
|
|
|
|
- [Testing Guide](./testing.md)
|
|
- [Rust Guidelines](../backend/rust-guidelines.md)
|