What's new in Hamzaish.

🚀 The self-contained build OS

This is the big one — and it's built for first-timers, not just developers. 🌱 You don't need to know how to code, and you don't learn a CLI: you enter Builder Mode, and it picks the right approach for where you are. Clone it, type one sentence in plain English, and it builds. Never used a terminal? There's a "Start here" on-ramp that walks you from zero — no coding required, you just talk to an AI and it does the techie parts.

And as of v2.0 the whole engine ships in the repo, so a fresh clone is complete. 🛠️

git clone https://github.com/hamza-ali-shahjahan/hamzaish
open in Claude Code, then type:
/builder-mode <your idea>

(It routes on context and asks when it's unsure — gates, not guesswork.)

---

✨ Highlights

• 🌱 Built for beginners too. No dev experience needed — a "Start here" on-ramp takes a total first-timer from zero to building. You talk; it does the techie parts.
• 🚪 One front door, it routes. /builder-mode (or /hamzaish, or plain English) reads what you're building and where you are, then drives the right path — a quick change, the gated full cycle, or an autonomous self-verifying loop toward a goal. The ~65 skills & commands are the gears; you never drive them by hand.
• 🎯 Goal-first, eval-gated — it only builds what it can prove. The cycle pins what "done" means, slices the goal into features, and keeps only the ones it can prove — each ships with an eval and an end-to-end test. A feature it can't evaluate or test doesn't get built. "Done" is a green eval, not an opinion.
• 📦 The whole engine ships in the repo. spec → plan → build → test → review → ship, plus autonomous modes — 22 engineering skills + 3 subagents. No separate install; the clone is the whole thing.
• 🔒 Honest by force. 35 agents · 41 skills · 24 commands · 41 playbooks · 133 practices — and a CI guard derives every count from the filesystem and fails the build if a doc drifts, a path leaks, or the version disagrees across files. The counts are the filesystem, not the marketing.

---

🔢 New & improved: real versioning (why this is v2.0, not v1.33)

Hamzaish now follows semver with a documented policy (docs/versioning.md), and a CI guard keeps the number honest across the whole repo (it used to read four different ways 😅 — never again):

• MAJOR = a milestone or a change in how you use it → v2.0 = the self-contained build OS. 🎯
• MINOR = a new capability · PATCH = a fix.
• Frequent changelog entries roll up into deliberate releases — no more drift.

So the jump from v1.2 → v2.0 is on purpose: this is a milestone, not an increment. 🚀

---

📦 What's changed since v1.2

• 🧩 The engineering engine (/full-cycle, /auto, /goal, /spec, /plan, /build, /test, /review…) consolidated into the repo — the front door is now self-contained on a fresh clone.
• 🎯 Goal → Slice → eval-gated build flow + the new feature-slicing skill; /goal self-verifying loop shipped in-repo.
• 🔒 The count / path / version CI guard — believability, mechanized.
• 🖼️ Rebuilt Builder Mode banner + the versioning policy & drift guard above.

Full log → the changelog.

---

Works with Claude Code, Cursor, Codex & Windsurf · 📜 AGPL-3.0 · needs a paid Claude plan (no free tier).

Built on Claude Code and a lot of generous open source. 💛

⚡️ The 100× faster start

Three releases, one mission: collapse the distance between "saw the repo" and "a product running on your screen." Everything below is on main, public, and checkable.

curl -fsSL https://raw.githubusercontent.com/hamza-ali-shahjahan/hamzaish/main/install.sh | sh

---

✨ Highlights

• 🪄 One command from a bare machine. curl … | sh installs Bun (if missing), clones Hamzaish, and runs setup — then prints your first command. (Read it first; it's short and commented.)
• 🟢 Local-first scaffold — zero accounts to start. /builder-mode <idea> now scaffolds a product that runs in ~60 seconds with zero env, zero signups (dev-auth stub, integrations off). Build first; the app boots before you create a single account.
• 🚀 /go-live — accounts, but guided. When you're ready to ship, /go-live <slug> walks the production stack service-by-service: deep-links each signup, validates each key's format, writes .env.local, and tracks a resumable ledger so you can stop and pick up later — then hands off to /security-check → /ship.

Put together: curl … | sh → /builder-mode <idea> → building locally in a minute → /go-live when you want the stack → /ship. The path that used to be a dozen friction-filled steps is now a handful of commands.

📦 What's changed

• install.sh (new) — POSIX-sh bootstrap, idempotent, safe to re-run.
• Starter is local-first by default: env vars optional, a Supabase dev-stub, LOCAL_MODE flag; SETUP.md is now the go-live checklist, not a prerequisite.
• /go-live command + skill; the chain /builder-mode → /go-live → /security-check → /ship → /web-launch is complete.
• Inventory: 29 skills & commands (17 skills + 12 commands), counts computed from the filesystem.

🚀 Get started

curl -fsSL https://raw.githubusercontent.com/hamza-ali-shahjahan/hamzaish/main/install.sh | sh
then, in Claude Code:
/builder-mode a tip calculator for freelancers

License

AGPL-3.0 — free to use, study, fork, and self-host. A commercial license is available for closed-source use.

Builder Mode at the core — plus the factory's first honest judge.

Since v1.0.0, Hamzaish has made its mission public, gained a way to prove its own quality, and added a launch system. Everything below is on main, public, and checkable.

---

✨ Highlights

• 🧭 Builder Mode — the mission. Strategy-first kills more builders than bad ideas do. With AI, building is cheap, fast, and reversible — the ship is the test. The full piece lives at docs/builder-mode.md, and the README now opens on it.
• ⌨️ /builder-mode — the front door. Your first action literally enters the mode: /builder-mode <your idea>. Same momentum router as /hamzaish (now its alias); strategy rails stay opt-in and skippable.
• ⚖️ An honest, agent-blind eval harness (Selection). The factory can now be wrong in a way it can't hide. bun run eval returns a four-outcome verdict per case — PASS / FAIL_BUILDABLE / GAP / UNCERTAIN — with a committed regression floor. The thing being judged can't see or edit its own tests (cases are excluded from the brain index). 9 cases across 3 skills, including an LLM judge that is a gate, never an oracle — no judge verdict can turn a failing case green.
• 🚀 The web-launch plugin. A verification-gated website-launch system (/web-launch) — a per-project workbook with a refuse-to-launch sign-off gate, plus launch-gotchas and pseo-at-scale skills. Portable: install via the marketplace, or use it as plain skills.
• 🤝 Community-ready. Code of conduct, issue + PR templates, and Discussions — GitHub community profile at 100%.

📦 What's inside / changed

• README rearchitected around a "What's inside" inventory — every agent, skill, command, and playbook catalogued, counts computed from the filesystem.
• The practices ledger (BEST-PRACTICES.md) — practices for shipping products with Claude Code, each badged ✅ proven / 🟡 partial / ⏳ research-baked, sourced and linked.
• /release factory step added (this release was cut with it).
• Self-evolution milestone: variation ✅ · heredity ✅ (scored) · selection ✅ — all three ingredients now exist. See meta/SELF-EVOLUTION.md.

🚀 Get started

git clone https://github.com/hamza-ali-shahjahan/hamzaish.git
cd hamzaish
bun run setup

Then, in Claude Code: /builder-mode a tip calculator for freelancers

License

AGPL-3.0 — free to use, study, fork, and self-host. A commercial license is available for closed-source use.

Hamzaish is the Claude Code setup that doesn't stop at code — an AI-native startup factory that takes an idea through the whole lifecycle (Ideate → MVP → Launch → Sell → Scale → Kill-or-double-down) and remembers every lesson for your next build.

> 🎉 This is the first public release of Hamzaish. Open-sourced under AGPL-3.0 and ready to fork.

---

✨ Highlights

• Momentum-first build. /hamzaish builds by default — strategy rails (validation, market sizing, competitor maps) are opt-in and skippable. The factory gets out of your way until you ask for the harder questions.
• A brain that compounds. Every session appends learnings to brain/; the best of them are promoted into load-bearing guardrails. Your second product starts smarter than your first — SQLite-indexed and searchable from any session via /brain-ask.
• Secure by default. Scaffolded products run agent-generated code inside a devcontainer, secrets are gitignored from commit zero, nothing auto-pushes off your machine, and a pre-launch security gate forces a BLOCK/CLEAR verdict across 59 concrete checks.
• An impact-scored, self-evolving learning loop. /learn-loop scores candidate learnings on five axes (Speed ×2, Build-quality ×2, Recurrence, Generalizability, Confidence → composite /35) and promotes only the few that clear the bar. Quarterly, /kill-or-keep prunes promotions that didn't pay off — the factory compounds without ossifying.

📦 What's inside

• Secure-by-default infra — devcontainer-by-default, opt-in auto-push with a pre-push secret scan, and hardened global hooks: every blocking git op is timeout-wrapped, fails open, and is scoped to Hamzaish-managed repos so it never wedges an unrelated session.
• The learning loop — /learn-loop + the five-axis scoring rubric, wired to /kill-or-keep for quarterly pruning.
• A per-product playbook — auth, DB, payments, analytics, and SEO pre-wired in every scaffold (Next.js 16 · Bun · Tailwind/shadcn · Supabase · Stripe · Resend · PostHog · Sentry · Vercel, free-tier-first), with Neon + Clerk as the documented scale path.
• The depth, surfaced — 128 distilled practices · 32 agents · 22 skills & commands · 39 playbooks, every count computed from the filesystem and every claim badged ✅ proven / 🟡 partial / ⏳ research-baked.

🚀 Products built with it

Already shipped through the factory and live for users to touch:

• Ventbox — architecturally-anonymous employee-feedback platform (HR sees AI-categorized sentiment, never who said what).
• Patently — AI IP-clearance research for founders; "Ship without blindsiding yourself on IP."
• wp-to-astro — OSS CLI migrating WordPress → Astro + MDX (138 tests, alpha on npm).
• TASFORT — "There's a System for That": 265+ methodologies from 100+ remarkable people, matched to you.
• Muakkil — mystical multi-agent platform (buildathon beta).

🏁 Get started — first win in ~2 minutes

You need Bun and Claude Code.

git clone https://github.com/hamza-ali-shahjahan/hamzaish.git
cd hamzaish
bun run setup        # idempotent — creates YOUR factory, never touches existing data

Then in Claude Code: /hamzaish a tip calculator for freelancers and watch it scaffold, propose the architecture, and start building — with the security gate and launch rails already waiting downstream.

👉 The 10-minute guided version: docs/your-first-product.md

📄 License

AGPL-3.0 — use, study, modify, and self-host freely. Run a modified version as a network service and your source must be AGPL too. A commercial license is available for closed-source use.

---

Built in public by Hamza Ali. The factory's repo runs on the factory's own discipline.