{"id":51083540,"url":"https://github.com/blendsdk/claude-codeops","last_synced_at":"2026-06-23T20:32:19.553Z","repository":{"id":366573082,"uuid":"1276663351","full_name":"blendsdk/claude-codeops","owner":"blendsdk","description":"CodeOps — an AI-development workflow for Claude Code: planning, requirements, audits, docs \u0026 git, as an installable plugin.","archived":false,"fork":false,"pushed_at":"2026-06-22T11:57:05.000Z","size":197,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-06-22T13:06:50.969Z","etag":null,"topics":["ai","anthropic","claude","claude-code","codeops","developer-tools","documentation","llm","plugin","skills","workflow"],"latest_commit_sha":null,"homepage":"https://blendsdk.github.io/claude-codeops/","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/blendsdk.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGES.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-06-22T07:21:48.000Z","updated_at":"2026-06-22T11:57:09.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/blendsdk/claude-codeops","commit_stats":null,"previous_names":["blendsdk/claude-codeops"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/blendsdk/claude-codeops","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blendsdk%2Fclaude-codeops","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blendsdk%2Fclaude-codeops/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blendsdk%2Fclaude-codeops/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blendsdk%2Fclaude-codeops/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/blendsdk","download_url":"https://codeload.github.com/blendsdk/claude-codeops/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blendsdk%2Fclaude-codeops/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34706579,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-23T02:00:07.161Z","response_time":65,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","anthropic","claude","claude-code","codeops","developer-tools","documentation","llm","plugin","skills","workflow"],"created_at":"2026-06-23T20:32:18.622Z","updated_at":"2026-06-23T20:32:19.547Z","avatar_url":"https://github.com/blendsdk.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# CodeOps for Claude Code\n\nThe CodeOps AI-development workflow — **9 skills + 13 slash commands + always-on coding\nstandards** — packaged as an installable [Claude Code plugin](https://code.claude.com/docs/en/plugins).\n\nPorted from the original [`codeops-mcp`](https://github.com/blendsdk/codeops-mcp) server (built for\nCline) to native Claude Code. The MCP server existed to load rule documents on demand so the context\nwindow wouldn't blow up; Claude Code does that natively via **skill progressive disclosure** (only\neach skill's name + description load up front, the body loads when used). So the machinery is gone\nand only the knowledge remains. See [CHANGES.md](CHANGES.md) for the full migration record.\n\n\u003e 📖 **Documentation site:** \u003chttps://blendsdk.github.io/claude-codeops/\u003e — full guides, a usage page\n\u003e for every skill, and end-to-end tutorials.\n\u003e\n\u003e **New here?** Follow the step-by-step [TUTORIAL.md](TUTORIAL.md) — it walks install → verify →\n\u003e use → update on a fresh machine.\n\n## Install (recommended): the plugin\n\nInside Claude Code, add this repo as a marketplace and install the plugin:\n\n```text\n/plugin marketplace add blendsdk/claude-codeops\n/plugin install codeops@codeops-marketplace\n```\n\nThat's it — skills, commands, **and the always-on coding standards are active immediately**. No\n`CLAUDE.md` editing and no manual merge: a bundled `SessionStart` hook injects the standards into\nevery session automatically (see [Always-on standards](#always-on-standards) below).\n\n\u003e The marketplace must be added **via git** (`add \u003corg\u003e/\u003crepo\u003e`), as shown — that is what lets the\n\u003e plugin's `source: \".\"` resolve to the repo root. A raw-URL add will not resolve it.\n\n## Verify it loaded\n\nInside Claude Code:\n- Ask **\"What skills are available?\"** — the CodeOps skills should be listed.\n- Type `/` and look for the namespaced commands `/codeops:make_plan`, `/codeops:exec_plan`,\n  `/codeops:gitcm`, `/codeops:gitcmp`, … (plugin skills/commands are namespaced under `codeops:`).\n- Run `/doctor` to confirm no skill descriptions are being truncated.\n\n## Updating\n\nThis plugin uses **rolling updates** — it carries no version number, so the git commit is the\nversion. To pick up the latest:\n\n```text\n/plugin update codeops@codeops-marketplace\n```\n\nEvery push to the repo is immediately installable; there is no version bump to wait for. A fresh\nsession may be needed for newly added directories to be watched.\n\n## Uninstalling\n\n```text\n/plugin uninstall codeops@codeops-marketplace\n```\n\nDisabling or uninstalling the plugin also turns off the standards hook — there is nothing left\nbehind in your `~/.claude/CLAUDE.md` to clean up (because the plugin never edited it).\n\n## Always-on standards\n\nThe plugin bundles a single source of truth for the universal coding/testing/working-style\nstandards: [`standards/coding-standards.md`](standards/coding-standards.md). A `SessionStart`\nhook ([`hooks/hooks.json`](hooks/hooks.json)) `cat`s that file into the context of every new\nsession, so the standards are always present with **zero setup**.\n\n- This fires on every session start (including after `/clear` and context compaction).\n- It is read-only — the hook only reads a file shipped inside the plugin; it never writes anything.\n- To turn it off, disable the plugin. There is no separate toggle.\n- If you prefer the classic approach, you *can* still merge `standards/coding-standards.md` into your\n  global `~/.claude/CLAUDE.md` by hand — but with the plugin that is unnecessary and would duplicate\n  the content.\n\n## Developing the skills (optional)\n\nIf you want to live-edit the skills themselves, there is an in-repo dev installer that symlinks the\n`skills/` and `commands/` folders into `~/.claude/` so a `git pull` propagates edits with no\nreinstall:\n\n```bash\n./install.sh            # symlink skills + commands into ~/.claude/ (recommended)\n./install.sh --copy     # install detached copies instead of symlinks\n./install.sh --dry-run  # preview, change nothing\n./uninstall.sh          # reverse it (restores any backups)\n./scripts/validate.sh   # pre-push guard: validates manifests, hook, standards, descriptions\n```\n\nThe dev installer gives you **short** names (`/make_plan`); the plugin gives you **namespaced**\nnames (`/codeops:make_plan`). **Pick one — the plugin OR the dev installer, not both** — or you will\nsee duplicate skills. Note the dev installer does *not* install the standards hook (that is a plugin\nmechanism); see [Always-on standards](#always-on-standards) for the manual-merge alternative.\n\n## What's here\n\n```text\ncodeops-skills/                # repo root == plugin root\n├── .claude-plugin/\n│   ├── marketplace.json       # marketplace manifest (source: \".\")\n│   └── plugin.json            # plugin manifest (no version → rolling updates)\n├── skills/                    # 9 skills → /codeops:\u003cname\u003e\n│   ├── make_plan/             #   create a multi-document implementation plan\n│   ├── exec_plan/             #   execute a plan task-by-task (commit modes)\n│   ├── make_requirements/     #   gather/add/review requirements (RDs)\n│   ├── retro_requirements/    #   reverse-engineer a codebase into requirements\n│   ├── grill_me/              #   relentless disambiguation interview\n│   ├── preflight/             #   13-dimension quality audit of a plan/requirements\n│   ├── techdocs/              #   VitePress architecture docs + ADRs\n│   ├── roadmap/               #   feature-set lifecycle tracker\n│   └── upgrade_plan/          #   upgrade outdated plans/requirements\n├── commands/                  # 13 slash commands → /codeops:\u003cname\u003e\n│   ├── gitcm.md / gitcmp.md   #   commit (and push) with a Conventional Commit message\n│   ├── analyze_project.md     #   generate/refresh this project's CLAUDE.md\n│   ├── migrate_clinerules.md  #   convert a legacy .clinerules/project.md → CLAUDE.md\n│   └── …                      #   + thin alias commands that delegate to a parent skill\n├── hooks/hooks.json           # SessionStart hook → injects the standards every session\n├── standards/coding-standards.md  # always-on coding/testing/working-style standards (single source)\n├── scripts/validate.sh        # pre-push validation guard\n├── install.sh / uninstall.sh  # optional in-repo dev installer (symlink loop)\n├── LICENSE                    # MIT\n├── TUTORIAL.md                # end-to-end walkthrough\n└── CHANGES.md                 # migration record\n```\n\n## Usage at a glance\n\n| You type / say | What happens |\n|---|---|\n| `make a plan` / `make_plan` | Clarifying interview → Zero-Ambiguity Gate → `plans/\u003cfeature\u003e/` doc set |\n| `exec_plan \u003cfeature\u003e [--auto-commit]` | Implements the plan task-by-task, verifying and committing per mode |\n| `make_requirements` / `add_requirement` / `review_requirements` | Requirements discovery / add one RD / health-check |\n| `retro_requirements [--scope \u003cpath\u003e]` | Reverse-engineer a codebase into a reconstruction brief |\n| `grill_me [topic]` | Relentless design-disambiguation interview |\n| `preflight \u003cartifact\u003e` | Adversarial, codebase-grounded quality audit |\n| `make_techdocs` / `review_techdocs` | Create/maintain VitePress architecture docs + ADRs |\n| `make_roadmap` / `update_roadmap` / … | Track a whole feature-set across its lifecycle |\n| `upgrade_plan \u003cfeature\u003e` / `upgrade_requirements` | Bring an outdated artifact to current standards |\n| `/gitcm` / `/gitcmp` | Commit (and push) with a detailed Conventional Commit message |\n| `/analyze_project` | Generate/refresh this project's `CLAUDE.md` |\n| `/migrate_clinerules` | Convert a legacy `.clinerules/project.md` into `CLAUDE.md` |\n\nThe consolidated skills cover several verbs each, and thin **alias commands** make each verb directly\ntypeable (they delegate to the parent skill in the right mode): `/add_requirement`,\n`/review_requirements` → `make_requirements`; `/make_techdocs`, `/review_techdocs` → `techdocs`;\n`/make_roadmap`, `/update_roadmap`, `/review_roadmap`, `/archive_roadmap` → `roadmap`;\n`/upgrade_requirements` → `upgrade_plan`. These aliases are manual-only — only the parent skills\nauto-trigger from natural language.\n\nThe skills compose into the original CodeOps pipelines, e.g.\n`grill_me → make_requirements → preflight → make_plan → preflight → exec_plan`, with `roadmap`\ntracking it all and `techdocs` keeping architecture docs current.\n\n## License\n\nMIT — see [LICENSE](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fblendsdk%2Fclaude-codeops","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fblendsdk%2Fclaude-codeops","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fblendsdk%2Fclaude-codeops/lists"}