From 457010bca10470aa948010d259ef041b7ad9f50d Mon Sep 17 00:00:00 2001 From: Anton Babenko Date: Sun, 17 May 2026 12:19:22 +0200 Subject: [PATCH 1/2] docs(readme): fix code-intelligence Try prompt, add tldr value tables - code-intelligence Try list led with a rename prompt implying an LSP rename; terraform-ls has no rename provider. Replaced with 5 prompts that map to real ops (findReferences/goToDefinition/hover/degradation), phrased as real developer asks - added a 3-column tldr table (prompt / without plugin / with plugin) under each plugin description so the value is obvious at a glance; the rename story moved into the table where the no-LSP-rename -> safe manual workflow nuance is explained - removed the obsolete marketplace-clash warning blockquote - npx skills block now shows both URLs (agent-plugins installs code-intelligence; terraform-skill from its own repo) - the old block listed only terraform-skill, implying npx could not get code-intelligence --- README.md | 34 ++++++++++++++++++++++++++-------- 1 file changed, 26 insertions(+), 8 deletions(-) diff --git a/README.md b/README.md index 7d3120e..ce2dbbb 100644 --- a/README.md +++ b/README.md @@ -15,9 +15,13 @@ Agent Plugins is a plugin marketplace for Claude Code and OpenAI Codex. ### npx skills - recommended for any Agent Skills host -Works with any compatible agent (Claude Code, Cursor, Copilot, Gemini CLI, OpenCode, Codex, and more): +Works with any compatible agent (Claude Code, Cursor, Copilot, Gemini CLI, OpenCode, Codex, and more). Each command is independent - run the one(s) you want: ```bash +# code-intelligence (this repo's inline skill) +npx skills add https://github.com/antonbabenko/agent-plugins + +# terraform-skill (its own repo) npx skills add https://github.com/antonbabenko/terraform-skill ``` @@ -141,25 +145,31 @@ this repo - install them from their own repo instead. -> Do not also add `antonbabenko/terraform-skill` as a marketplace. It uses the -> same marketplace name as this repo and the two will clash. Install -> `terraform-skill` from here, or as a standalone skill from its own repo - not -> both. - ## Plugins ### code-intelligence > Stops blind text-replace renames and "the tool is broken" guesses: the agent picks language-server vs text vs fuzzy search correctly for the task, and says so on the first line when it has to swap one tool for another. +**tldr** - what changes with the plugin: + +| Prompt | Without the plugin | With the plugin | +|--------|--------------------|-----------------| +| Rename `var.tags` to `var.resource_tags` across the module | Blind `grep`/replace - misses position scoping, collides with same-named symbols in child modules, no post-edit validate | terraform-ls has no rename provider, so it runs the safe manual workflow: `findReferences` at an anchored position -> fresh per-file Read -> edit -> `validate` | +| Find every reference to `aws_s3_bucket.this` before changing it | One regex; may over/under-match, then claims "found all" | Position-anchored `findReferences`; on an uninitialized workspace it says so on line 1 and discloses the `rg` fallback | +| `rg` looks missing so the agent reaches for `grep` | Silent tool swap - you never learn coverage dropped | Proves the tool is really absent first; states the substitution on the first line | + ```bash /plugin install code-intelligence@antonbabenko ``` Try: -- `Rename the vpc_id variable across this Terraform module` -- `Find every reference to aws_s3_bucket.this before I change it` +- `I need to change var.vpc_id - what references it?` +- `Where does local.name_prefix come from?` +- `What can I set on this aws_s3_bucket resource?` +- `Is output.cluster_endpoint used anywhere before I change its type?` +- `Did you really find all the references, or just text matches?` Check your setup (Claude Code): `/code-intelligence:doctor` @@ -167,6 +177,14 @@ Check your setup (Claude Code): `/code-intelligence:doctor` > Routes a Terraform or OpenTofu request to its real failure mode - identity churn, secret exposure, blast radius, state corruption - before generating code, instead of emitting plausible-looking HCL that breaks on apply. +**tldr** - what changes with the plugin: + +| Prompt | Without the plugin | With the plugin | +|--------|--------------------|-----------------| +| Create a VPC module | Plausible HCL, no tests, no version guards | Routes to the failure mode first; module + native tests + version-aware guards | +| Configure S3 backend with state locking | May emit DynamoDB locking (outdated) | TF 1.10+ S3 native `use_lockfile`; flags DynamoDB as no longer required | +| Change a resource's address | Text rename -> destroy/recreate on apply | `moved` block + `plan` shows 0 destroy; blast radius checked before generating code | + ```bash /plugin install terraform-skill@antonbabenko # or, on any Agent Skills host: From 103962e35ec8ce999a168a5b47d4f2c6bf1cd658 Mon Sep 17 00:00:00 2001 From: Anton Babenko Date: Sun, 17 May 2026 12:23:50 +0200 Subject: [PATCH 2/2] docs(readme): note the code-intelligence semantic rows need a language server The tldr 'with the plugin' cells describe the LSP tier (findReferences, position-anchored), which needs terraform-ls installed. Add one line so readers know the semantic behavior is server-gated and that the plugin still adds value (honest rg-fallback disclosure) without it. Points to /code-intelligence:doctor. --- README.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/README.md b/README.md index ce2dbbb..acbd3dd 100644 --- a/README.md +++ b/README.md @@ -159,6 +159,11 @@ this repo - install them from their own repo instead. | Find every reference to `aws_s3_bucket.this` before changing it | One regex; may over/under-match, then claims "found all" | Position-anchored `findReferences`; on an uninitialized workspace it says so on line 1 and discloses the `rg` fallback | | `rg` looks missing so the agent reaches for `grep` | Silent tool swap - you never learn coverage dropped | Proves the tool is really absent first; states the substitution on the first line | +The semantic rows above need a language server installed (here `terraform-ls`). +Without one the plugin still helps: it discloses the `rg` fallback on the first +line instead of pretending the text search was exhaustive. Check your setup +with `/code-intelligence:doctor`. + ```bash /plugin install code-intelligence@antonbabenko ```