Skip to content

docs(readme): fix code-intelligence Try prompt + add tldr value tables#7

Merged
antonbabenko merged 2 commits into
masterfrom
docs/readme-tldr-value-tables
May 17, 2026
Merged

docs(readme): fix code-intelligence Try prompt + add tldr value tables#7
antonbabenko merged 2 commits into
masterfrom
docs/readme-tldr-value-tables

Conversation

@antonbabenko
Copy link
Copy Markdown
Owner

What

  • code-intelligence Try list led with Rename the vpc_id variable... which implies terraform-ls does LSP renames. It does not (no rename provider - it's a guided manual workflow). Replaced with 5 prompts phrased as real developer asks, each mapping to a real op (findReferences / goToDefinition / hover / degradation-honesty).
  • tldr value tables added under each plugin description: 3 columns (prompt / output without the plugin / output with the plugin) so the value is obvious in 5 seconds. The rename story is now the strongest tldr row, where the no-LSP-rename -> safe-manual-workflow nuance is explained.
  • Removed the obsolete marketplace-clash warning blockquote.
  • npx skills block now shows both install URLs. The old block listed only the terraform-skill URL, making it look like npx could not install code-intelligence - but npx skills add .../agent-plugins does (verified).

Scope

One file: README.md. +26 / -8.

Verification

  • npx markdownlint-cli2 README.md - 0 errors
  • Confidentiality grep on the diff - clean (no internal terms)
  • Typography - ASCII only, no em/en dash or curly quotes
  • Every Try prompt maps to a supported terraform-ls op or a correct rg/degradation case; none imply an LSP rename or call hierarchy

Independent of PR #6 (separate branch off master).

- 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
…e 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.
@antonbabenko antonbabenko merged commit 4eead04 into master May 17, 2026
@antonbabenko antonbabenko deleted the docs/readme-tldr-value-tables branch May 17, 2026 10:25
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant