development-workflow

A set of development rules and commands for a Python project called lightfast-mcp. It specifies tools for dependencies, formatting, linting, testing, and starting its servers.

In plain words
What is it for?
Use it to install dependencies, format and lint Python code, run quick or full tests, and start the lightfast-mcp orchestrator or individual servers.
Why use it?
It gives contributors one documented way to set up the project, run checks, and launch its components.

Cursor rule for Cursor

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 rules/ekakit/lightfast-mcp/development-workflow
Clone the repo
git clone --depth 1 https://github.com/ekakit/lightfast-mcp

Made for: Cursor.

Per session 412 This file is loaded in full into every session.
When invoked 412 The same file — it is already loaded in full.
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.00412 $0.00412
Opus 5 $0.00206 $0.00206
Sonnet 5 $0.00082 $0.00082
Haiku 4.5 $0.00041 $0.00041

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

Security

Grade A, and why

development-workflow 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.

.cursor/rules/development-workflow.mdc · 63 lines

What it actually says

Development Workflow

Tool Stack

  • Use uv for dependency management and running commands
  • Use taskipy for common development tasks
  • Use nox for comprehensive testing across Python versions
  • Use ruff for linting and formatting

Common Commands

Setup & Development

# Setup
uv sync --extra dev

# Development
uv run task lint          # Run linting
uv run task format        # Format code  
uv run task test_fast     # Quick tests
uv run task demo          # Test working system

Server Management

uv run lightfast-mcp-orchestrator init   # Create sample config
uv run lightfast-mcp-orchestrator list   # List available servers
uv run lightfast-mcp-orchestrator start  # Start servers interactively
uv run lightfast-mcp-orchestrator ai     # Start AI client

# Individual Servers  
uv run lightfast-blender-server     # Start Blender server directly
uv run lightfast-mock-server        # Start mock server directly

Testing Commands

# Fast feedback
nox -s test_fast         # Fast tests (excluding slow)

# Full test suite
nox

# Specific test types
nox -s test_e2e          # End-to-end tests
nox -s test_integration  # Integration tests
nox -s test_coverage     # Tests with coverage
nox -s test-3.13         # Python 3.13 tests
nox -s typecheck         # MyPy type checking
nox -s verify_system     # System verification

Development Guidelines

  • Use async/await patterns throughout for better performance
  • Prefer configuration over hardcoded values
  • Include appropriate tests for new functionality
  • Follow the existing project patterns and conventions
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 · 63 lines · 412 tokens per session scan A 007261702b8f

Subscribe to this mod's changes

development-workflow is a cursor rule published in the GitHub repository ekakit/lightfast-mcp (2 stars, last pushed 1y ago), licensed MIT. It adds 412 tokens to every session, about $0.0021 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-31.