ScaleSense v0.2.0 — Workload-first database decisions

ScaleSense v0.2.0 adds a workload-first database decision framework for evidence-backed architecture choices before implementation.

What changed

• Diagnose why the current design truly falls short by tracing logical operations into physical read, write, and storage work.
• Compare the no-change baseline and smaller corrections before introducing another technology, while still adopting complexity when evidence requires it.
• Clarify component roles: PostgreSQL as transactional authority where it owns business invariants, Redis as cache or derived state unless a stronger durability contract is proven, and Kafka as a retained log or stream when replay, independent consumers, or ordering justify it.
• Make data loss and disagreement explicit through acknowledgement boundaries, authority and reconciliation rules, stale-data behavior, repair, quarantine, rejection, and rebuild paths.
• Require production-shaped benchmarks and measurements instead of deriving exact resources from user count or QPS.
• Keep migrations reversible through checked backfills, shadow reads, idempotent propagation, bounded cutover, freshness visibility, and tested rollback.

Verification

• 135 deterministic tests passed.
• Repository and release checks passed.
• Official Codex plugin and Agent Skill validators passed.
• The complete 28-case live suite ran with zero executor errors and was manually reviewed; focused reruns validated flagged behavior. A mandate-versus-technical-verdict defect discovered by the suite was fixed and its final targeted eval passed.

Install

codex plugin marketplace add umit/scalesense --ref v0.2.0

codex plugin add scalesense@scalesense

ScaleSense v0.1.0: Evidence-Driven Architecture Decisions

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.