dev-setup

A setup checklist for developing the blz project, including its Rust code, documentation tools, command-line program, and scripts.

In plain words
What is it for?
Use it to validate dependencies, build and test the project, run linting and formatting checks, install the local command-line tool, configure completions, and check project scripts.
Why use it?
It helps confirm that required tools are installed and that the project builds, tests, formats, and runs correctly before development begins.

Command

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add commands/outfitter-dev/blz/dev-setup
Clone the repo
git clone --depth 1 https://github.com/outfitter-dev/blz
Per session 7 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 481 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00007 $0.00481
Opus 5 $0.00003 $0.00241
Sonnet 5 $0.00001 $0.00096
Haiku 4.5 $0.00001 $0.00048

Measured yesterday against content hash f8b462e6f51f, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

dev-setup scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured yesterday.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.factory/commands/dev-setup.md · 69 lines

How it starts

The opening of the file, as written. The whole thing — 69 lines — stays where its author put it; the contents beside it link to each section on GitHub.

blz Development Environment Setup

Please help set up the development environment for the blz project. Mode: $ARGUMENTS

Setup Tasks

1. Environment Validation

  • Check Rust toolchain (verify rust-toolchain.toml requirements)
  • Validate required system dependencies
  • Confirm git hooks and pre-commit setup
  • Check Node.js for documentation tooling

2. Build & Dependencies

  • Run cargo build --release to ensure clean compilation
  • Execute cargo test to verify all tests pass
  • Check cargo clippy for linting issues
  • Run formatting with cargo fmt --check

3. Development Tools

  • Install local blz binary with cargo install --path crates/blz-cli
  • Set up shell completions for enhanced development experience
  • Configure IDE/editor settings if applicable
  • Validate benchmark environment with cargo bench --dry-run

4. Project Validation

  • Run the smoke test script: ./scripts/agent-check.sh
  • Verify documentation builds correctly
  • Test CLI with sample sources from registry
  • Check that all scripts in ./scripts/ are executable and functional

5. Development Workflow

  • Explain the git workflow and branch naming conventions
  • Show how to run specific test suites efficiently
  • Demonstrate performance profiling setup
  • Guide through the release process basics

Setup Mode Instructions

Quick Mode ($ARGUMENTS contains "quick"):

  • Focus on essential build and test validation
  • Skip optional tooling and advanced setup
  • Provide minimal viable development environment

Full Mode (default or $ARGUMENTS contains "full"):

  • Complete development environment setup
  • Include all optional tools and configurations
  • Provide comprehensive workflow guidance
  • Set up performance monitoring and profiling tools

Expected Outcome

After completion, the developer should have:

  1. A fully functional build environment
  2. All tests passing locally
  3. CLI tool installed and accessible
  4. Understanding of the development workflow
  5. Access to debugging and profiling tools

Read the full file on GitHub · 69 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. yesterday First seen · 69 lines · 7 tokens per session scan A f8b462e6f51f

Subscribe to this mod's changes

dev-setup is a command published in the GitHub repository outfitter-dev/blz (27 stars, last pushed 20d ago), licensed MIT. It adds 7 tokens to every session and 481 once invoked, about $0.0000 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.