Low-traffic applications where distributed caching is overkill
Systems with strong consistency requirements over availability
When to Employ This Paradigm
When traffic or state volume overwhelms a single database node.
When latency requirements demand in-memory data grids located close to processing units.
When linear scalability is required, achieved by partitioning workloads across many identical, self-sufficient units.
Adoption Steps
Partition Workloads: Divide traffic and data into processing units, each backed by a replicated data cache.
Design the Data Grid: Select the appropriate caching technology, replication strategy (synchronous vs. asynchronous), and data eviction policies.
Coordinate Persistence: Implement a write-through or write-behind strategy to a durable data store, including reconciliation processes.
Implement Failover Handling: Design a mechanism for leader election or heartbeats to validate recovery from node loss without data loss.
Validate Scalability: Conduct load and chaos testing to confirm the system's elasticity and self-healing capabilities.
Key Deliverables
An Architecture Decision Record (ADR) detailing the chosen grid technology, partitioning scheme, and durability strategy.
Runbooks for scaling processing units and for recovering from "split-brain" scenarios.
A monitoring suite to track cache hit rates, replication lag, and failover events.
Risks & Mitigations
Eventual Consistency Issues:
Mitigation: Formally document data-freshness Service Level Agreements (SLAs) and implement compensation logic for data that is not immediately consistent.
Operational Complexity:
Mitigation: The orchestration of a data grid requires mature automation. Invest in production-grade tooling and automation early in the process.
Cost:
Mitigation: In-memory grids can be resource-intensive. Implement aggressive monitoring of utilization and auto-scaling policies to manage costs effectively.
Concrete Components
These vocabulary items name the concrete tools and abstractions
that show up when the paradigm is implemented. They are not
required dependencies and they are not part of the skill's
tools: frontmatter (which is reserved for Claude Code tool
restrictions). Use this list to disambiguate during architecture
discussions.
data-grid-platform: Hazelcast, Apache Ignite, or similar; in-memory partitioned data store
replication-manager: moves writes asynchronously to durable storage and across regions
load-tester: drives the grid past its single-region ceiling to validate scale-out
Exit Criteria
[ ] An ADR documents the chosen grid technology, partitioning scheme, replication strategy
(sync vs. async), data eviction policies, and durability SLA before any processing unit
is deployed.
[ ] Runbooks for scaling processing units and recovering from split-brain scenarios exist and
have been exercised in a non-production environment.
[ ] Load and chaos testing confirms the system handles >= 2x expected peak traffic without
data loss, measured before production promotion.
[ ] A monitoring suite tracks cache hit rates, replication lag, and failover events with
alerting thresholds set before the system accepts live traffic.
How to use it
Copy the folder
Take athola/architecture-paradigm-space-based from the repository into ~/.claude/skills for personal
use, or into .claude/skills inside a project.
Check the name does not clash
The agent identifies a skill by the name field in its header. Two skills with the
same name cannot sit side by side — one of them will be ignored.