dependency-injection

A dependency-injection coding guide. Dependency injection means giving a class the services it needs from outside instead of creating them internally.

In plain words
What is it for?
Use it when writing or reviewing classes with service dependencies, object graphs, dependency containers, or testability concerns.
Why use it?
It makes dependencies visible and makes code easier to replace or test with fakes, while avoiding tight coupling and hidden global services.

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/andr-ca/agentharness/dependency-injection
Clone the repo
git clone --depth 1 https://github.com/andr-ca/agentharness

Made for: Cursor.

Per session 43 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 678 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.00043 $0.00678
Opus 5 $0.00022 $0.00339
Sonnet 5 $0.00009 $0.00136
Haiku 4.5 $0.00004 $0.00068

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

Security

Grade A, and why

dependency-injection 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/dependency-injection.mdc · 82 lines

How it starts

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

Dependency Injection

One rule: depend on abstractions, receive them via constructor, never create them internally.

The Pattern

# BAD — hard to test, tightly coupled
class OrderService:
    def __init__(self):
        self.db = Database()          # creates its own dependency
        self.email = EmailClient()    # can't inject fakes in tests

# GOOD — testable, decoupled
class OrderService:
    def __init__(self, db: Database, email: EmailClient) -> None:
        self.db = db
        self.email = email
// BAD
class OrderService {
    private db = new Database();   // hidden dependency
}

// GOOD
class OrderService {
    constructor(private db: Database, private email: EmailClient) {}
}

Rules

Do Don't
Inject dependencies via constructor Create dependencies with new inside a class
Depend on interfaces/protocols Depend on concrete types when an abstraction exists
Make dependencies explicit Use service locators (Container.get(...)) inside business logic
Keep constructors simple — no logic Do work in __init__/constructors
Use fakes/stubs in tests Patch global singletons in tests

When to Use a DI Container

Use a container (FastAPI's Depends, tsyringe, Wire for Go) when:

  • The object graph has 3+ levels of nesting
  • You need lifetime management (singleton vs. transient vs. scoped)
  • You need request-scoped dependencies (e.g., database sessions per HTTP request)

Don't use a container for:

  • Small scripts or utilities (manual wiring is simpler and clearer)
  • Value objects (DTOs, records) — they carry data, not behavior
  • Stateless pure functions

Lifetimes

Lifetime When to use Example
Singleton Shared state across the app; expensive to create DatabasePool, ConfigLoader
Scoped One instance per request/unit of work DbSession, UserContext
Transient Stateless; cheap to create EmailFormatter, Validator

Anti-Patterns

Read the full file on GitHub · 82 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 · 82 lines · 43 tokens per session scan A e286e241ba2c

Subscribe to this mod's changes

dependency-injection is a cursor rule published in the GitHub repository andr-ca/agentharness (1 stars, last pushed yesterday), licensed MIT. It adds 43 tokens to every session and 678 once invoked, about $0.0002 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.