Skip to content

ScaleSense v0.1.0: Evidence-Driven Architecture Decisions

Choose a tag to compare

@umit umit released this 09 Aug 08:13
· 1 commit to main since this release

ScaleSense is an evidence-driven system design and capacity-planning methodology for Codex. It turns product demand into workload, latency, resource, cost, failure, and evolution decisions before implementation.

What's Included

  • Four focused workflows: review, design, estimate, and challenge.
  • Workload modeling across traffic, concurrency, data growth, latency, availability, CPU, RAM, storage, IOPS, bandwidth, replicas, connections, and cost.
  • RFC/ADR-ready Decision Records with facts, assumptions, units, confidence, verdicts, validation evidence, and measurable evolution triggers.
  • Complexity decisions grounded in profiling, representative benchmarks, production measurements, or an explicit measurement contract.
  • A 28-case behavior evaluation suite covering activation, routing, incomplete requirements, pressure, and justified complexity.

Install With Codex CLI

No Git clone, ZIP download, custom installer, package registry, or ScaleSense backend is required:

codex plugin marketplace add umit/scalesense --ref v0.1.0
codex plugin add scalesense@scalesense
codex plugin list --json

Start a new Codex session after installation.

Verify The Source

Development requires Node.js 22 or newer:

npm test
npm run check
npm run check:release

v0.1.0 Boundaries

  • Estimates are models based on supplied facts and labeled assumptions, not production measurements.
  • Exact CPU, RAM, instance, partition, and replica allocations require profiling, representative benchmarks, or production data.
  • ScaleSense does not replace telemetry, load testing, security or compliance review, or accountable engineering ownership.
  • The plugin is skills-only and instruction-only: no MCP server, connector, app, hook, backend, telemetry, authentication, or background process.
  • Public behavior and evaluations are English.
  • Installation command shapes are verified with Codex CLI 0.146.0 on macOS.

See the changelog for the complete release scope.