v2.18.0 β π‘ The factory grows senses
The factory grows senses. Hamzaish's self-improvement loop used to run on what a session remembered to write down β now it runs on what actually happened: session traces recorded automatically from your very first session, and a new operating principle that turns lessons into executable checks instead of prose. This release bundles the eight cycles since v2.10.0.
Highlights
- π‘ Session traces, zero-setup (v2.18.0). A committed
.claude/settings.jsonships project hooks that record every tool call and failure to a local JSONL trace β fail-open (any error exits 0; telemetry can never slow or block a turn), privacy-capped (no tool outputs, no file contents, commands truncated β traces are gitignored and never leave your machine), bounded (one file per day).bun run trace-reportturns them into answers: failure rate by tool, the bash commands that keep breaking, how much work happened./learn-loopnow reads it before every cycle. Adopted from the Code as Agent Harness survey (arXiv:2605.18747, UIUC + Meta + Stanford, Β§3.5) β read against the repo as a checklist, not a blueprint: two gaps adopted, topology rework deliberately declined. - πͺ Operating principle 15: a lesson that can be a check becomes a check (v2.18.0). The promotion ladder β hook β CI guard β eval case β prose, with prose as the fallback, never the default. Hamzaish's own history proved it: its three worst incidents each stopped recurring only when the lesson became a hook.
- ποΈ The factory control plane (v2.16.0). FACTORY-ORDERS / STANDING-ORDERS / HEARTBEAT operator templates, a hard dollar cap + spend ledger on the autonomy loop (
--max-spend-usd, default $25, refuses unmeasured modes), lifecycle gates inproduct.config.jsonwith thecheck-gatesdashboard, and the/factory-launchritual that fills it all in β the gap between "runs overnight" and "runs overnight bounded", closed. - π The starter tells the truth in production (v2.17.0). Sentry now actually initializes in every scaffold (the observability costume is closed), a token-gated canary proves errors reach Sentry on the REAL deploy, and the Stripe webhook never 200s an event it didn't persist (idempotency ledger, claim/release semantics) β silent subscription loss, gone.
- βοΈ The skill-authoring standard (v2.15.0). Context load vs cognitive load, leading words, the no-op test, completion criteria, six failure modes β ported from mattpocock/skills β plus the first context-load audit of every skill description the factory ships.
What changed
v2.18.0 β session traces + the lesson-to-check ladder
scripts/trace-log.ts(hook-fed flight recorder) +scripts/trace-report.ts(bun run trace-report) +.claude/settings.json(project hooks, the first committed one) β 7 new tests including thetrace-capture-fidelityeval; verified live: the hooks captured their own build session.brain/operating-principles.mdprinciple 15;/learn-loopgrounds cycles in traces (step 2) and applies the check ladder on promotion (step 6).
v2.17.0 β starter production truth
sentry.*.config.tsΓ 3 +src/instrumentation.ts, thesentry-canaryroute proven byverify-liveA11, and thestripe_webhook_eventsledger with verify β claim β persist semantics.
v2.16.0 β control plane
- Operator templates scaffolded by
bun run setup; spend meter (scripts/lib/spend.ts) with hard abort; lifecycle gates (scripts/check-gates.ts);/factory-launcheval-covered from birth.
v2.15.0 β skill authoring Β· factory/playbooks/ai-native-2026/skill-authoring.md + context-load audit; skill/command namespace dedupe guard (check-skill-command-collision).
v2.14.0 β the ThousandWorlds fold Β· 12 learnings promoted: 2 anti-patterns (lazy-thenable Supabase inserts that send nothing; trusting .gz extensions over magic bytes), 2 playbooks (multi-agent-one-repo fences; landscape-research-before-roadmap), 6 proven practices.
v2.13.0 β paste-contents rule Β· anything you must relay to an external surface goes into chat as full file contents, never a path (AGENTS.md hard rule 13).
v2.12.0 β the Orca distillation Β· community-flywheel + handoff-vs-supervision playbooks, community PR automation (community-prs.yml), /release hardened (heartbeat trigger, never-publish-backwards gate).
v2.11.0 β the live gate Β· scripts/verify-live.ts: /go-live closes on an A1βA10 scorecard against the real deployment (DNS, TLS, health, auth gate, live keys, no leaked server secrets) β never on a claim.
Get started
curl -fsSL https://raw.githubusercontent.com/hamza-ali-shahjahan/hamzaish/main/install.sh | shThen open Claude Code and type /builder-mode <your idea>. New to terminals? Start at docs/start-here.md.
License
AGPL-3.0 β clean, no added clauses. Free for builders; commercial license on request.