{
  "markdown": "\n<p align=\"center\">\n  <img src=\"assets/god-eye.gif\" alt=\"hey-god\" width=\"200\" />\n</p>\n\n<p align=\"center\">\n  <strong><font size=\"6\">Heygod</font></strong>\n</p>\n<p align=\"center\">\n  <em>Software that can change without fighting you.</em>\n</p>\n\n\n\n## Table of Contents\n\n- [The problem](#the-problem)\n- [The old excuse is dead](#the-old-excuse-is-dead)\n- [The invocations](#the-invocations)\n- [What's actually inside (and what deliberately isn't)](#whats-actually-inside-and-what-deliberately-isnt)\n- [Install](#install)\n- [Repo layout](#repo-layout)\n\n\n\n## The problem\n\nDay by day, people gain access to the finest AI models. Companies have access to increasingly similar capabilities, yet some struggle while others build better software as time goes on. The difference is no longer the model. It’s how you use it.\n\nAgents are smart now. They've read every book we could feed them like SOLID, Clean Architecture, the Fowler catalog. There is no knowledge gap. So there's no point teaching an agent *how to cook*, what it needs is someone insisting on **what good taste is**, direction, reasoning, and rules it holds itself to when nobody's watching.\n\nMeanwhile, the layers have shifted. Programming languages are becoming the new low-level layer, what assembly was to C, code is becoming to specs. Spec-driven development is how **humans express software now**. That doesn't mean nobody cares how the low-level layer is generated, it means we've **abstracted that layer to the agent, and the agent must care on our behalf**. The human owns the spec; the agent owns the code; and the moment that contract breaks, you can see it:\n\n- **The moment a human has to open the code**, the agent went wrong somewhere.\n- **The moment each new feature takes longer than the last**, the code is shaping wrong.\n- **The moment the result stops matching the spec**, the structure is fighting the intent.\n- **The moment a small change burns hundreds of tokens**, you are paying interest on invisible debt.\n\nThe gap is not agent capability and it's not human skill. **The gap is discipline.**\n\n## The old excuse is dead\n\n\"Clean code is a long-term investment, it pays off later.\" That framing no longer holds, for two reasons.\n\nFirst, **there is no \"later\" anymore.** Decisions change left and right, pivots that took months now happen in days. Structure is not a savings account; it's the *steering system*. Clean boundaries are what let a human change their mind on Tuesday and ship it Wednesday. The goal is simple: **make every change as fast as possible, adapt to anything, and let the human never worry about internals.**\n\nSecond, **the up-front cost argument is gone.** With a human, discipline cost weeks. With an agent, the disciplined version and the sloppy version take nearly the same time to build, the agent types both at the same speed. You're no longer paying extra for structure; you're only choosing whether the *next* change is cheap or expensive.\n\n## The invocations\n\nhey-god is a plugin: a core doctrine plus one skill per invocation.\n\n| Say | You get |\n|---|---|\n| `hey-god-bring-us-on-same-page` | Blind-spot questions + assumptions surfaced BEFORE building, kills the 2-3 wasted iterations |\n| `hey-god-give-me-third-eye` | A calm outsider re-measures the problem the conversation inflated |\n| `hey-god-show-me-the-pain` | Your system as a story, components as characters, pain named where it lives |\n| `hey-god-bring-it-to-life` | Implement New Feature; every changed line traces to the feature |\n| `hey-god-god-mode` | Autonomous run-to-merge on the righteous path, aligns once, then no more questions until the PR is in main |\n| `hey-god-devil-mode` | ⚠ Berserk run-to-merge, shortcuts unlimited, every sin auto-billed to `SINS.md`, gates convinced but never broken |\n| `hey-god-grant-me-wisdom` | Quick-fix vs right-way, priced at the 10th change, ONE pick |\n| `hey-god-build-a-new-world` | New-project sequence: qualities → style → seams → ADRs → first slice |\n| `hey-god-purify-me` | Safe refactoring: behavior pinned first, small green steps, ledger debts repaid |\n| `hey-god-forgive-me-for-my-sins` | The devil's bargain: shortcut granted NOW, debt written in `SINS.md` |\n| `hey-god-am-i-sinning?` | Verdict + sins by rule ID + penance for each |\n\nNo invocation needed for normal work, the doctrine applies to any coding task with lasting structure.\n\n## What's actually inside (and what deliberately isn't)\n\n- **No lessons.** The agent already knows the rules; re-teaching them is dead weight. Rules are cited by ID (D3, LSP, T1) and the rulebook stores only each rule's *boundary*, the condition where it flips, because a knowledgeable agent's failure mode is dogma, not ignorance.\n- **Counter-rationalization armor.** The excuses agents actually make under pressure (\"abstraction will save time later\", \"no time for the test first\"), pre-refuted.\n- **Permission to do less.** Scope discipline, \"propose don't perform\", the right to push back on the spec, overriding the agent's trained urge to over-help.\n- **The sins ledger (`SINS.md`).** Shortcuts are allowed; silence is not. Every deliberate shortcut is recorded with its interest rate and repay-when trigger. Absolution collects.\n- **Third Eye.** Long conversations amplify problems, the model builds a story, absorbs your bias, inherits stale conclusions. Facts kept, story dropped, problem re-measured at true size.\n- **Same-page alignment.** Wrong solutions start as silent assumptions, the human's unstated context, the agent's auto-filled gaps. One round of blind-spot questions (each with a recommended answer) plus a story playback, before any effort is spent.\n- **Speaks human.** All modes answer in plain words and short stories by default, components as real things with jobs, consequences as what you'll feel, because humans reply better to stories, and better replies mean fewer iterations. Technical on request.\n\n## Install\n\nEasy way to install across all agents, scope\n\n```\nnpx skills add sudo-pradip/hey-god\n```\n\n### Claude Code\n\n```\n/plugin marketplace add sudo-pradip/hey-god\n/plugin install hey-god@hey-god\n```\n\nTwo separate prompts. Skills appear namespaced (`hey-god:am-i-sinning`, `hey-god:give-me-third-eye`, …); the doctrine triggers on any structural coding work with no invocation needed. Also works from the Claude desktop app's Code tab, and in Cowork via the same plugin.\n\n### Codex\n\n```\ncodex plugin marketplace add sudo-pradip/hey-god\ncodex plugin add hey-god@hey-god\n```\n\nRun `codex` and start a new thread. The VS Code Codex extension reads `AGENTS.md`, which this repo ships, so it also works from a checkout with no setup (`~/.codex/AGENTS.md` makes it global).\n\n### GitHub Copilot CLI\n\n```\ncopilot plugin marketplace add sudo-pradip/hey-god\ncopilot plugin install hey-god@hey-god\n```\n\nIn an interactive Copilot CLI session, use the slash equivalents:\n\n```\n/plugin marketplace add sudo-pradip/hey-god\n/plugin install hey-god@hey-god\n```\n\nCopilot CLI fallback (instruction-only mode): it reads `AGENTS.md` and `.github/copilot-instructions.md` in a project, or copy the rules into `~/.copilot/copilot-instructions.md` to run hey-god in every project.\n\n### Gemini CLI\n\n```\ngemini extensions install https://github.com/sudo-pradip/hey-god\n```\n\nLoads the ruleset as always-on context every session. The skills ship too, activated when a task needs them.\n\n### Antigravity CLI\n\n```\nagy plugin install https://github.com/sudo-pradip/hey-god\n```\n\nReuses the `gemini-extension.json`. Until the Gemini → Antigravity migration completes, `gemini extensions install` still works too. To run it as an always-on rule instead, drop the ruleset into `.agents/rules/`.\n\n### Pi agent harness\n\n```\npi install git:github.com/sudo-pradip/hey-god\n```\n\n### Devin CLI\n\n```\ndevin plugins install sudo-pradip/hey-god\n```\n\nSkills are available as `hey-god:am-i-sinning`, `hey-god:grant-me-wisdom`, and so on.\n\n### Grok Build\n\n```\ngrok plugin install sudo-pradip/hey-god --trust\n```\n\nEnable the plugin: `/plugins` → Space on `hey-god`, or in `~/.grok/config.toml`:\n\n```toml\n[plugins]\nenabled = [\"hey-god\"]\n```\n\n`AGENTS.md` still works instruction-only from a checkout without the plugin.\n\n### Hermes Agent\n\n```\nhermes plugins install sudo-pradip/hey-god --enable\n```\n\nRestart Hermes after installing.\n\n### OpenCode\n\nAdd to `opencode.json`:\n\n```json\n{ \"plugin\": [\"./.opencode/plugins/hey-god.mjs\"] }\n```\n\nOpenCode also auto-loads this repo's `AGENTS.md`, so the rules hold even without the plugin.\n\n### Qoder\n\nQoder auto-loads `AGENTS.md` from the repo root as always-on context, so running hey-god from a checkout works with zero setup. For per-project rules, copy `.qoder/rules/hey-god.md` into your project's `.qoder/rules/`.\n\n### Cursor\n\n```\nmkdir -p .cursor/rules && curl -o .cursor/rules/hey-god.mdc https://raw.githubusercontent.com/sudo-pradip/hey-god/main/.cursor/rules/hey-god.mdc\n```\n\n### Windsurf\n\nCopy `.windsurf/rules/hey-god.md` into your project's `.windsurf/rules/`.\n\n### Cline\n\nCopy `.clinerules/hey-god.md` into your project's `.clinerules/`.\n\n### Kiro\n\nCopy `.kiro/steering/hey-god.md` to `~/.kiro/steering/` (global) or `.kiro/steering/` in your project.\n\n### Aider / CodeWhale / Amp / Jules / Junie\n\nThese all read `AGENTS.md` from the project root, which this repo ships, zero setup from a checkout.\n\n### Swival\n\n```\nswival skills add --global https://github.com/sudo-pradip/hey-god\nswival skills add hey-god\n```\n\nAlso reads `AGENTS.md` from the project root and `~/.config/swival/AGENTS.md` globally.\n\n### Any other agent (instruction-file fallback)\n\nPlace `AGENTS.md` in your project root, or append `CLAUDE.md.example` to your `CLAUDE.md`. Any agent that reads project instructions gets the full doctrine, the single-file mirrors are self-contained.\n\n### Skill files only (no plugin)\n\nCopy the `skills/*` folders into `~/.claude/skills/`. Note: the sub-skills reference `../doctrine/` by relative path, so copy the whole set together.\n\n### Uninstall\n\n```\n/plugin remove hey-god                              # Claude Code\ncodex plugin remove hey-god                          # Codex\ncopilot plugin remove hey-god                        # Copilot CLI\ndevin plugins remove hey-god                         # Devin\ngrok plugin uninstall hey-god                        # Grok Build\npi uninstall hey-god                                 # Pi\n```\n\n### Updating\n\n`/plugin marketplace update hey-god` then reinstall, or re-run the curl for file-based installs. All mirrors are generated from `AGENTS.md`; `scripts/check_rule_copies.py` in CI guarantees they never drift, so any single file you grab is always current.\n\n## Repo layout\n\n```\n.agents/rules/              Antigravity CLI always-on rule\n.claude-plugin/             marketplace.json + plugin.json (the two-command Claude install)\n.codex-plugin/              plugin.json (the two-command Codex install)\n.devin-plugin/              plugin.json (Devin CLI plugin install)\n.github/                    copilot-instructions.md (GitHub Copilot)\n.grok-plugin/               plugin.json (Grok Build plugin install)\n.kiro/steering/             hey-god.md (Kiro steering rule)\n.qoder-plugin/              plugin.json (Qoder plugin install)\n.qoder/rules/               hey-god.md (Qoder per-project rules)\nskills/\n  doctrine/                 core: laws, workflow, scope discipline, rules.md (IDs + boundaries)\n  am-i-sinning/          grant-me-wisdom/   build-a-new-world/   bring-it-to-life/\n  purify-me/           forgive-me-for-my-sins/              give-me-third-eye/\n  bring-us-on-same-page/    show-me-the-pain/    god-mode/    devil-mode/\nAGENTS.md                   canonical single-file mirror (Codex, Aider, Amp, Jules, CodeWhale)\ngemini-extension.json       Gemini CLI / Antigravity CLI extension manifest\nopencode.json               OpenCode plugin config\nplugin.json                 Pi agent harness / generic plugin marker\nplugin.yaml                 Hermes Agent manifest\n.cursor/rules/  .clinerules/  .windsurf/rules/  CLAUDE.md.example\nscripts/check_rule_copies.py   CI check: mirrors never drift from AGENTS.md\n```\n\nTo change the doctrine: edit the skills, condense into `AGENTS.md`, re-copy the mirrors, run `python3 scripts/check_rule_copies.py`.\n\n**Human owns the spec. Agent owns the code. hey-god keeps the contract.**\n\n*The sinner is always welcome.*\n",
  "bytes": 12310,
  "sha": "7a9b8039b85cdffe4ebb5e1b07ee7397965bd670b340ef372ffe22749f8ee767",
  "repo_slug": "sudo-pradip/hey-god",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_sudo_pradip_hey_god_7e23911c/readme"
}