architecture-decisions

architecture-decisions is a cursor rule for coding agents from jterratsdev/ableton-live-mcp. It costs 252 tokens per session, scanned A, original, MIT.

A lightweight record of an important software architecture choice: what was decided, why, which alternatives were considered, and what follows from it.

In plain words
What is it for?
Use it to document decisions about frameworks, databases, cloud services, APIs, deployment, authentication, testing, and other choices with meaningful trade-offs or migration risks.
Why use it?
It preserves the reasoning behind changes to systems, data, integrations, security, infrastructure, or tools, so teams can trace decisions without rewriting history.

Cursor rule

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/jterratsdev/ableton-live-mcp/architecture-decisions
Clone the repo
git clone --depth 1 https://github.com/jterratsdev/ableton-live-mcp

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for architecture-decisions

README.md
[![agentmods](https://agentmods.dev/badge/rules/jterratsdev/ableton-live-mcp/architecture-decisions.svg)](https://agentmods.dev/rules/jterratsdev/ableton-live-mcp/architecture-decisions)
Your own site
<a href="https://agentmods.dev/rules/jterratsdev/ableton-live-mcp/architecture-decisions"><img src="https://agentmods.dev/badge/rules/jterratsdev/ableton-live-mcp/architecture-decisions.svg" alt="Measured on agentmods" height="20"></a>
Per session 252 This file is loaded in full into every session.
When invoked 252 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.00252 $0.00252
Opus 5 $0.00126 $0.00126
Sonnet 5 $0.00050 $0.00050
Haiku 4.5 $0.00025 $0.00025

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

Security

Grade A, and why

architecture-decisions 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 4d ago.

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.

rules/architecture-decisions.mdc · 28 lines

What it actually says

Architecture Decisions

Important architecture choices must be recorded briefly. The goal is traceability, not bureaucracy.

When to Record an ADR

  • Record an ADR when changing system boundaries, data ownership, integration contracts, authentication, authorization, infrastructure, deployment, or storage patterns.
  • Record an ADR when choosing a new framework, library, cloud service, messaging pattern, database, or testing strategy.
  • Record an ADR when a decision has meaningful trade-offs, migration cost, security impact, or rollback complexity.

ADR Format

  • Title: short decision name.
  • Status: proposed, accepted, superseded, or rejected.
  • Context: problem, constraints, and forces.
  • Decision: chosen approach.
  • Consequences: benefits, costs, risks, and follow-up work.
  • Alternatives considered: at least one reasonable option and why it was not chosen.

Decision Hygiene

  • Keep ADRs concise and link them from PRs when relevant.
  • Supersede old ADRs instead of rewriting history.
  • If a decision is reversed, record why new information changed the outcome.
  • Architecture decisions must align with security, testing, observability, and delivery quality gates.
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. 4d ago First seen · 28 lines · 252 tokens per session scan A cf81f453dda7

Subscribe to this mod's changes

architecture-decisions is a cursor rule published in the GitHub repository jterratsdev/ableton-live-mcp (0 stars, last pushed 11d ago), licensed MIT. It adds 252 tokens to every session, about $0.0013 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.