{
  "markdown": "<p align=\"center\">\n  <img src=\"assets/logo.svg\" alt=\"greybeard\" width=\"220\">\n</p>\n\n# greybeard\n\n> Less AI slop. More engineering judgment and more correct code.\n\nMost coding-agent mistakes are judgment failures, not syntax failures: guessing instead of asking,\nbuilding abstractions before the second case exists, patching symptoms, accepting review comments\nblindly, touching unrelated code, and saying \"done\" without evidence.\n\ngreybeard is one unified operating discipline for that:\n\n1. **Think from facts** - surface load-bearing assumptions, ask only questions that change the implementation, and push back when the request is unsafe or overbuilt.\n2. **Build the minimum** - reuse what exists, prefer stdlib and native platform features, avoid speculative dependencies and abstractions.\n3. **Debug systematically** - reproduce, read the full error, trace bad data to its source, form one hypothesis, and fix the root cause.\n4. **Cut surgically** - every changed line traces to the request, verified root cause, or cleanup created by the change.\n5. **Use agents like tools** - delegate only independent or review-worthy work, with complete task-specific context.\n6. **Verify before done** - run the narrowest check that proves the behavior, then report the result plainly.\n\n## Install\n\n### `npx skills`\n\n```bash\nnpx skills add nassiharel/greybeard\n```\n\nThis installs the reusable skill from `skills/greybeard/SKILL.md`.\n\n### Claude Code plugin\n\n```text\n/plugin marketplace add nassiharel/greybeard\n/plugin install greybeard@greybeard\n```\n\nThe plugin manifest points at the same `skills/` directory.\n\n### Codex\n\nCodex can use the native plugin manifest in `.codex-plugin/plugin.json`, or the portable\ninstructions file:\n\n```bash\ncurl -o AGENTS.md \\\n  https://raw.githubusercontent.com/nassiharel/greybeard/main/AGENTS.md\n```\n\nUse `~/.codex/AGENTS.md` if you want the compact rules globally.\n\n### Gemini CLI\n\nThis repo ships `gemini-extension.json` with `contextFileName` set to `AGENTS.md`, so the compact\nrules load as extension context.\n\n```bash\ngemini extensions install https://github.com/nassiharel/greybeard\n```\n\nRestart Gemini CLI after installing or updating the extension.\n\n### OpenCode\n\nOpenCode can read `AGENTS.md` from the project root. This repo also ships a thin plugin that\nregisters `skills/` and injects `AGENTS.md` only when it has not already been loaded.\n\nAdd the plugin to your `opencode.json`:\n\n```json\n{\n  \"plugin\": [\"./.opencode/plugins/greybeard.mjs\"]\n}\n```\n\nIf you keep one shared checkout, point that entry at the plugin's absolute path.\n\n### GitHub Copilot\n\nCopilot reads `.github/copilot-instructions.md` from a repository. Install the compact rules with:\n\n```bash\ncurl --create-dirs -o .github/copilot-instructions.md \\\n  https://raw.githubusercontent.com/nassiharel/greybeard/main/.github/copilot-instructions.md\n```\n\n## Files\n\n| File | Purpose |\n|------|---------|\n| `skills/greybeard/SKILL.md` | Canonical long-form skill |\n| `AGENTS.md` | Compact portable rules for agents that read project instructions |\n| `.github/copilot-instructions.md` | Copilot adapter generated from `AGENTS.md` |\n| `.claude-plugin/plugin.json` | Claude Code plugin metadata |\n| `.codex-plugin/plugin.json` | Codex plugin metadata |\n| `gemini-extension.json` | Gemini CLI extension metadata |\n| `opencode.json` and `.opencode/plugins/greybeard.mjs` | OpenCode plugin adapter |\n\n## How to know it is working\n\nYou should see smaller diffs, fewer invented abstractions, earlier clarifying questions, more\nroot-cause debugging, review feedback checked before implementation, and final answers that lead\nwith what changed and what was verified.\n\nSee [`examples/`](examples/) for small before/after proof cases.\n\n## Philosophy\n\n- **Truth over momentum** - name uncertainty instead of hiding it.\n- **Simplicity over cleverness** - the best code is still the code never written.\n- **Root cause over symptoms** - patch once where the bug begins.\n- **Evidence over confidence** - done means checked.\n- **Brevity over filler** - cut prose, not precision.\n\n## License\n\n[MIT](LICENSE).\n",
  "bytes": 4086,
  "sha": "cf8aff8bdb92d563c5cb619178f95e12a412cc52ce2a656576f6ddb3eba70d9d",
  "repo_slug": "nassiharel/greybeard",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_nassiharel_greybeard_78a4b97c/readme"
}