Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 12 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -149,6 +149,18 @@ The principle above ships as two runnable meta-skills in [`skills/`](./skills)

They're standard [Claude Code Agent Skills](https://code.claude.com/docs/en/skills) (portable to Cursor, Codex, OpenClaw). Install and usage: [`skills/README.md`](./skills/README.md).

## The `/scalable` command

[`commands/scalable.md`](./commands/scalable.md) is a Claude Code slash command that runs the §5 decision test on demand: pressure-test the approach on the table against **scalable / long-term / efficient** — *whatever is scalable, long term, and cannot be done in a more efficient way* — and get one decisive recommendation, with stale-time-budget shortcuts called out.

```bash
mkdir -p ~/.claude/commands
cp commands/scalable.md ~/.claude/commands/ # personal, all projects
# or: .claude/commands/ for one project
```

Then `/scalable` (tests the current direction) or `/scalable <a specific decision>`.

## Install

**Option A: New project**
Expand Down
23 changes: 23 additions & 0 deletions commands/scalable.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,23 @@
---
description: Pressure-test the current approach against scalability, long-term, and efficiency, then recommend the best option.
argument-hint: [decision or approach to test — optional]
---

Run the decision test on **$ARGUMENTS** — or, if that's empty, on the approach currently on the table in this conversation.

The governing question for the choice: **whatever is scalable, long term, and cannot be done in a more efficient way.**

Judge it concretely — name specifics, not abstractions — on three axes:

- **Scalable** — does it hold at 100× the load / data / users / surface area? Name the first thing that breaks.
- **Long term** — six months from now, is this a foundation or a wound? What does it cost to live with, or to undo?
- **Efficient** — is this already the leanest *correct* way, or is there a genuinely more efficient one (fewer moving parts, less code, less to maintain)? "More efficient" never means removing a safety guard.

Then:

- **Be decisive.** Recommend ONE option. Don't survey alternatives you won't take.
- **Catch stale time-budget shortcuts.** "No time", "do it later", "quick hack for now" — in an AI session the proper version usually fits *this* session. If you catch yourself reaching for a shortcut, flag it and price the real version.
- **Never trade away** correctness, security, or data-safety for speed.
- If the approach passes all three, say so plainly and proceed — don't manufacture objections.
- If it fails, state the better approach concretely and exactly what changes to get there.
- If the proper version genuinely would take days, say so explicitly and let me decide — don't silently downgrade to the shortcut.