metal

One signal in. Full chain reaction out.
v0 · r825 · 2026-05-04 · 1,254 pts   history   architecture   reference
What It Is

metal is a tilde-command system that turns AI into a disciplined shipping machine. One command triggers a full chain reaction -- plan, build, test, ship, retro -- with pre-baked conventions for format, folder, repo, versioning, and style. The structure never drifts.

Type ~GO and the system plans the work, sizes it into Fibonacci kanban boards, builds each item, tests it, ships it, and writes the retro. Every step produces an HTML report. Every report gets indexed. Every commit gets telemetry. The trail is the proof.

Who It's For

Architects who ship. Solo devs who want structure without overhead. Small teams that need a workflow engine, not a project management tool. Anyone who's tired of AI assistants that drift, forget context, and produce work you can't trace.

Why

Because the tools exist now. Claude Code can read a codebase, plan work, write code, run tests, commit, and push -- but without discipline it produces chaos. metal is the discipline layer. 40 years of shipping distilled into conventions an AI can follow without drifting.

How He Built It

Joey Castillo -- 40+ years as a software architect, code in production with over a billion hours of combined uptime -- built metal with Claude Code itself. The system eats its own cooking. Every revision of metal was planned, built, tested, and shipped using tilde commands.

metal is part of AI Pantheon -- Joey's platform for AI-native tools that respect the craft. No frameworks. No abstractions for hypothetical futures. Vanilla HTML, batch scripts, shell scripts, pure C. The provisioner runs on any machine with curl.

~chain-reaction
~P  ~E  /~B  ~T/  ~S  ~R

Named workflow macros with loops. Commands outside / run once. Commands inside / / loop until the board is exhausted. ~GO runs the full lifecycle. ~HOTFIX inspects, plans the fix, loops test/fix, ships.

Full Chain Reaction Reference
Syntax, built-in chains, how to create custom chains, loop markers, exit conditions.
View reference →
Tilde Commands
Start
~NNewCreate a new project -- repo, be/ scaffold, CLAUDE.md
~LIListList all projects -- local, remote, open transfers
~LLoadLoad a repo -- clone, sync, switch context
~ULUnloadClose out a project -- housekeep, report, switch back
Think
~IInspectRead a repo, URL, or codebase -- report what's there
~PPlanPlan it, render it, save it
~PUUser StoryPlan as a user story with acceptance criteria
~PTPlan TestPlan the test strategy
~EEstimateBreak a plan into sized Fibonacci kanban boards
Build
~AAddAdd something new -- review, report, commit, demo
~UUpdateUpdate existing code or feature
~DDeleteRemove code, feature, or files
~FFixFix a bug -- diagnose, fix, write a test, ship proof
~BBuildBuild it -- or pull next from the board and complete it
~BTBuild TestBuild the tests for a feature
~TTestTest it, fix what's broken
Ship
~SShipCommit, push, version bump, deploy
~BriefBriefAvatar video briefing from ship report
~MonitorMonitorWatch the deploy -- verify it's live and healthy
~DemoDemoDemo, review, or refactor code
~RRetroRetrospect recent work -- what went well, what didn't
Ops
~MMCPManage MCP servers -- add, remove, diagnose, setup
~TagTagTag anything -- stored as triples, searchable
~ConfigConfigRuntime settings -- reports, chains, display modes
~CRRecoverCrash recovery -- read the dirt, resume the chain
~TransferTransferProject handoff -- scan, clean, manifest
~HHelpWorkflow guide with use cases
~JCJoey's Take40 years of architecture advice, on demand
Definition of Done + Ready

Every tilde command that produces an artifact must pass all 7 items before the command is considered complete. Ship adds 4 more. The gate holds.

Code committed -- descriptive message, no uncommitted work
Commit hash in telemetry -- backfilled in be/telemetry.json
Board updated -- item moved to Done with hash (if applicable)
HTML report saved -- correct datetime filename in be/
Index updated -- entry in be/index.html
Pushed to remote -- work exists on origin, not just locally
No prior work damaged -- Done items untouched unless explicitly targeted
Ship (~s, ~r) adds: chain complete, site in sync, help in sync, revision current.

Definition of Ready -- session pre-flight. Before the first edit:

Board state -- read be/board.md. Know what's Done, In Progress, Ready
Last telemetry -- was the previous chain completed? Flag unfinished work
Source of truth -- respect canonical files. Don't edit non-canonical copies
3 file reads. Takes seconds. Prevents most cross-session work loss.
Full Reference
All 25+ commands with aliases, board convention, versioning, folder structure, telemetry, HTML report template.
View full reference →
Install
curl -fsSL https://joeycastillo.us/metal/install.bat -o %TEMP%\install.bat && %TEMP%\install.bat
curl -fsSL https://joeycastillo.us/metal/install.sh | bash
One command. Installs tools, clones the engine, launches Claude Code with tilde commands.
Daily Use

After install, just type:

go

Claude Code launches with full permissions and tilde commands loaded. Type ~H for the full guide, or just:

~GO full lifecycle    ~HOTFIX fix + ship
Under The Hood
26
Fe
Iron
55.845
Fe Iron
the most abundant metal on Earth -- the foundation
Dev tools + identity + auth. Git, GCC, Python, Node, Rust, gh, gcloud, Claude Code, Wrangler, Snowflake CLI, four browsers. Runs once during install. Version-gated -- skips what's already there.
11
Na
Sodium
22.990
Na Sodium
explodes on contact with water -- the reset
Clean slate. Removes the metal repo so you can test a fresh install. Tools and OS changes stay. Just the repo goes.
curl -fsSL https://joeycastillo.us/metal/Go.Na.bat -o %TEMP%\Go.Na.bat && %TEMP%\Go.Na.bat
curl -fsSL https://joeycastillo.us/metal/Go.Na.sh | bash
Add-On
Standalone
3
Li
Lithium
6.941
Li Lithium
the lightest metal -- OS diet
Strip the OS to its minimum weight. Remove bloatware, dark mode, privacy lockdown, full power, clean taskbar, fast keyboard. Not part of the main install -- run separately if you want it.
curl -fsSL https://joeycastillo.us/metal/Go.Li.bat -o %TEMP%\Go.Li.bat && %TEMP%\Go.Li.bat
Run as Administrator -- standalone, zero dependencies
curl -fsSL https://joeycastillo.us/metal/Go.Li.sh | bash
curl -fsSL https://joeycastillo.us/metal/Go.Li.sh | bash
Dedicated to Our Lady of the Miraculous Med(t)al