jordan/stemedb
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
b3e8a9a058
stemedb/.claude/guides/local/setup.md
jordan a776744889 Initial project setup with Claude Code monorepo structure 
- 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>
2026-01-31 10:56:26 -07:00

1.4 KiB
Raw Blame History

Local Development Setup

When to use: Setting up StemeDB for local development.

Prerequisites

  • Rust 1.75+ (2024 edition)
  • cargo and rustup

Quick Start

# 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):

{
  "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

rustup update
cargo clean
cargo build

Clippy warnings

Run with --fix for auto-corrections:

cargo clippy --workspace --fix --allow-dirty

Related