AGENTS.mdA

AGENTS.md from hamza-ali-shahjahan/hamzaish is an AGENTS.md file: the standing instructions coding agents read in that repo.

Install it, pinned
mdr add hamza-ali-shahjahan/hamzaish/AGENTS.md@git:20260921.82b1475

Pins git:20260921.82b1475 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 14 of 14 checks passed
Kind
AGENTS.md file
Repository
hamza-ali-shahjahan/hamzaish
Path
AGENTS.md
Versions recorded
7
Latest version
git:20260921.82b1475, committed Sep 21, 2026
First version recorded
Jul 12, 2026
Size
15,101 bytes
Repository stars
11
License
MIT

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Hamzaish — AGENTS.md

> Universal context for any coding agent working in this repo (Claude Code, Codex, Cursor, Aider, Continue, Goose, or anything else that reads `AGENTS.md`). Tool-specific routing extends this file — see "Tool-specific files" at the bottom.

## What Hamzaish is

A personal AI Co-builder & Startup OS for one operator running a portfolio of products. Brain + orchestrator + per-product workspace + self-improvement loop. Built on Anthropic's *Founder's Playbook* (Idea → MVP → Launch → Scale) and informed by gbrain (knowledge graph), hermes-agent (self-improving skills), openclaw (multi-channel gateway).

The repo is **metadata + learnings, not product code.** Product source repos live elsewhere on the operator's machine and are mapped via a gitignored `code-paths.local.json`.

## Architecture (4 layers + study material)

```
brain/        — WHAT YOU KNOW         identity, persona, principles, learnings, anti-patterns,
                                       decision log, ingested knowledge, SQLite FTS5 index
factory/      — HOW YOU ACT           agents (idea/mvp/launch/scale/portfolio stages),
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add hamza-ali-shahjahan/hamzaish/AGENTS.md@sha256:7f861fe3d3b092f6

The line at the top of this page pins the label git:20260921.82b1475, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_vvvtftpbl3f6eqjy.svg)](https://markdownregistry.com/a/art_vvvtftpbl3f6eqjy)

5 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 7 versions of this file, between Jul 12, 2026 and Sep 21, 2026, about one every 12 days.

versioncommittedcommitsizeaudit
git:20260921.82b1475 latest2026-09-21 82b1475 15,101 BA view · diff
git:20260919.0ed17f72026-09-19 0ed17f7 15,106 BA view · diff
git:20260903.3c7fc7c2026-09-03 3c7fc7c 14,862 BA view · diff
git:20260819.4b46d8b2026-08-19 4b46d8b 14,038 BA view · diff
git:20260819.f995fd22026-08-19 f995fd2 13,340 BA view · diff
git:20260727.9c4b2c72026-07-27 9c4b2c7 12,072 BA view · diff
git:20260712.764de5e2026-07-12 764de5e 11,313 BA view

Audit of the latest version

A  14 of 14 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Size between 200 bytes and 200 KB (15101 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

hamza-ali-shahjahan/hamzaish · 11 stars · license MIT · pushed 2026-10-07 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_vvvtftpbl3f6eqjy
GET https://markdownregistry.com/api/v1/resolve?ref=hamza-ali-shahjahan/hamzaish/AGENTS.md
GET https://markdownregistry.com/api/v1/blob/7f861fe3d3b092f6c409339ac31e0d067ee84a08275f1019ad584ef05c0744c8

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: how to write a good AGENTS.md · AGENTS.md vs CLAUDE.md · which agent file does what.

More from hamza-ali-shahjahan/hamzaish

hamzaish Cursor rule
hamza-ali-shahjahan/hamzaish · .cursor/rules/hamzaish.mdc · Hamzaish factory — universal operating context for any agent working in this repo
git:20260614.1c0c7ab · audit A · 11 stars
CLAUDE.md CLAUDE.md file
hamza-ali-shahjahan/hamzaish · CLAUDE.md
git:20261007.6b62766 · audit A · 11 stars
CLAUDE.md@_archive/v0 CLAUDE.md file
hamza-ali-shahjahan/hamzaish · _archive/v0/CLAUDE.md
git:20260528.a4e7dfe · audit A · 11 stars
hamzaish-orchestrator SKILL.md skill
hamza-ali-shahjahan/hamzaish · _archive/v0/agents/_orchestrator/SKILL.md · Top-level routing brain. Given any user request, identifies the product + stage + intent, then routes to the right…
git:20260528.a4e7dfe · audit A · 11 stars
competitor-mapper SKILL.md skill
hamza-ali-shahjahan/hamzaish · _archive/v0/agents/idea/competitor-mapper/SKILL.md · Map the competitive landscape by tier (direct/indirect/acquirer/adjacent) and argue why each could win. Antidote to…
git:20260528.a4e7dfe · audit A · 11 stars
customer-discovery SKILL.md skill
hamza-ali-shahjahan/hamzaish · _archive/v0/agents/idea/customer-discovery/SKILL.md · Plan customer discovery — define target profile, build prospect list, draft interview script, set up outreach +…
git:20260528.a4e7dfe · audit A · 11 stars
devils-advocate SKILL.md skill
hamza-ali-shahjahan/hamzaish · _archive/v0/agents/idea/devils-advocate/SKILL.md · Stress-test an idea or hypothesis. Build the strongest possible case AGAINST it, find disconfirming evidence, and…
git:20260528.a4e7dfe · audit A · 11 stars
idea-generator SKILL.md skill
hamza-ali-shahjahan/hamzaish · _archive/v0/agents/idea/idea-generator/SKILL.md · Generate startup ideas grounded in Hamza's existing patterns, current trends, and validated demand signals. Never just…
git:20260528.a4e7dfe · audit A · 11 stars
interview-synthesizer SKILL.md skill
hamza-ali-shahjahan/hamzaish · _archive/v0/agents/idea/interview-synthesizer/SKILL.md · Synthesize a batch of customer interviews into evidence-for + evidence-against the hypothesis, with pattern surfacing…
git:20260528.a4e7dfe · audit A · 11 stars
market-researcher SKILL.md skill
hamza-ali-shahjahan/hamzaish · _archive/v0/agents/idea/market-researcher/SKILL.md · Build TAM/SAM/SOM, market trends, buyer landscape — anchored in citable public data, not vibes.
git:20260528.a4e7dfe · audit A · 11 stars
problem-sharpener SKILL.md skill
hamza-ali-shahjahan/hamzaish · _archive/v0/agents/idea/problem-sharpener/SKILL.md · Turn vague problem observations into testable hypothesis statements with specific who/when/severity/current-workaround…
git:20260528.a4e7dfe · audit A · 11 stars
brand-story-builder SKILL.md skill
hamza-ali-shahjahan/hamzaish · _archive/v0/agents/launch/brand-story-builder/SKILL.md · Build the brand foundation — positioning, story, voice, naming, visual primitives — so every other launch asset…
git:20260528.a4e7dfe · audit A · 11 stars

Every file in hamza-ali-shahjahan/hamzaish

Other files named AGENTS.md

AGENTS.md AGENTS.md file
morluto/rea · AGENTS.md
git:20261015.0e1f0bf · audit A · 352,890 stars
AGENTS.md AGENTS.md file
obra/superpowers · AGENTS.md
git:20260919.5bf4e78 · audit A · 302,424 stars
AGENTS.md AGENTS.md file
affaan-m/ecc · AGENTS.md
git:20261011.412347a · audit A · 284,510 stars
AGENTS.md AGENTS.md file
firecrawl/firecrawl · AGENTS.md
git:20261008.5a75dca · audit A · 193,096 stars
AGENTS.md AGENTS.md file
dietrichgebert/ponytail · AGENTS.md
git:20261008.2a1fe84 · audit A · 170,980 stars
AGENTS.md AGENTS.md file
garrytan/gstack · AGENTS.md
git:20261011.5d64745 · audit A · 136,966 stars
AGENTS.md AGENTS.md file
graphify-labs/graphify · AGENTS.md
git:20260926.98d73fe · audit A · 129,649 stars
AGENTS.md AGENTS.md file
juliusbrussee/caveman · AGENTS.md
git:20260902.d9faebc · audit A · 113,780 stars

Browse by kind, by grade A, or by owner.