All skills
sailscastshq avatar

/the-frugal-architect

@3e3ad46

Cost-aware architecture skill inspired by The Frugal Architect and adapted for The Boring JavaScript Stack. Treat cost as a first-class non-functional requirement, align system shape to the business model, make trade-offs explicit, observe cost and waste, add cost controls, optimize incrementally, and challenge stale assumptions. Use this skill when shaping infrastructure, architecture, scaling, observability, performance, background jobs, caching, or product-engineering trade-offs.

Use this Skill: https://skilld.dev/gh/sailscastshq/boring-stack/the-frugal-architect

This session only. Nothing lands on disk.

rulesfrugal-stack-decisions.md

≈648 tokens on demand. Your agent reads this file only when SKILL.md points to it.

Frugal Stack Decisions

Use frugal architecture to keep the stack boring on purpose, not by accident.

Start With the Default Stack Shape

Prefer:

  • a Sails action plus an Inertia page over a duplicated page API and client data layer
  • Waterline plus the primary database over extra data stores added for hypothetical scale
  • built-in Shipwright asset handling over custom pipeline work
  • Sounding request tests over browser-heavy suites when the browser is not the thing being validated

Delay:

  • Redis, queues, websocket fanout, search infrastructure, object pipelines, and edge logic until usage justifies them
  • internal platforms that solve organizational scale you do not yet have
  • expensive monitoring products when simple metrics and logs will answer the current question

Tie Architecture to Unit Economics

Before you add a new layer, ask:

  • what revenue event, customer outcome, or mission-critical outcome pays for this?
  • what part of cost-to-serve does it reduce or protect?
  • if usage doubled tomorrow, would this layer improve the economics or merely look sophisticated?

Examples in this stack:

  • a background job is justified if it shortens user response time or consolidates expensive work
  • a CDN is justified if it meaningfully absorbs traffic, latency, or origin load
  • realtime is justified if faster updates change user behavior or reduce manual refresh churn

Spend More on the Path That Must Work

Invest first in:

  • authentication, payments, checkout, critical notifications, and primary write paths
  • recovery, retries, and visibility for workflows that directly affect revenue or trust

Spend carefully on:

  • admin conveniences
  • low-value automations
  • vanity dashboards
  • broad realtime features
  • speculative personalization

Add Explicit Cost Levers

Good Boring Stack levers include:

  • job frequency and batch size in Quest
  • email send timing, batching, and template weight
  • image size, caching, and retention
  • request rate limits
  • feature-level degradation flags
  • database query count and payload size on Inertia responses
  • websocket room fanout and event frequency

Prefer Reversible Decisions

When two choices are close, pick the one that:

  • teaches you faster
  • locks you in less
  • keeps migration cost low
  • can be upgraded later without rewriting the product

Source: SKILL.md on GitHub

No alerts17d3 checks · Risk SAFE
  • Gen Agent Trust Hub17d

    The skill provides architectural guidance and principles for cost-aware software development. It contains no executable code, network operations, or security issues.

  • Socket17d

    No alerts

  • Snyk17d

    Risk: LOW · No issues

Signed by skilld at 3e3ad46. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 3 days ago.

Activeupdated 6 months ago
Other metadata
metadata
{
  "author": "sailscastshq",
  "version": "1.0.0",
  "tags": "the-frugal-architect, frugality, cost-awareness, architecture, trade-offs, observability, optimization, boring-stack"
}

README badge

README badge for sailscastshq/boring-stack/the-frugal-architect