Agent Plugins Marketplace
← All plugins

discuss

v0.7.0

ADR-driven development, agent spec conventions, decision grilling, English-only artifacts, controlled-language rewrites, and diff explanations

Claude CodeAgent Plugins7 Skills

By HernandoR0 GitHub starsUpdated 4 days ago

Directory evidence

Runtimes
Claude Code and Agent Plugins
Parsed components
7 skill or MCP entries
Source updated
Sep 20, 2026
Manifest status
Canonical path parsed

The directory validates manifest shape and source location. It does not execute the plugin or provide a security endorsement. Review the indexing methodology →

Install discuss for Claude Code

Installs for the current user
claude plugin marketplace add IchenDEV/agent-plugin-mkt
claude plugin marketplace update agent-plugin-marketplace
claude plugin install discuss-4@agent-plugin-marketplace

Paste and run these commands in a terminal with Claude Code. They add and refresh the PluginsMP catalog, then install this plugin.

The installer fetches third-party code from the source repository shown on this page. This directory validates manifest structure and source location, but does not perform a security audit; review the manifest, components, and source before installing.

Get the source manually
git clone https://github.com/HernandoR/agent-skillset

Clone the source repository, then follow its setup instructions to add the plugin to a compatible client. The plugin root is plugins/discuss/.

Plugin files

plugins/discuss/
├── .claude-plugin/plugin.json
├── plugin.json
├── skills/adr-driven-development/SKILL.md
├── skills/agent-spec-convention/SKILL.md
├── skills/asd-ste100/SKILL.md
├── skills/decision-grilling/SKILL.md
├── skills/english-only-artifacts/SKILL.md
├── skills/explain-diff-html/SKILL.md
└── skills/explain-diff-myst/SKILL.md

Included Skills7

adr-driven-developmentskills/adr-driven-development/SKILL.md

Use when capturing design discussion that should survive across sessions and contributors (RFC), or when recording/updating the settled design intent a project commits to (ADR). Triggers whenever a design direction is being debated, an architectural choice gets made, an existing decision needs revising, or someone asks "why is it built this way?" or "what is this supposed to do?". Covers the RFC→ADR record lifecycle, not the per-session implementation plan that executes a decision.

agent-spec-conventionskills/agent-spec-convention/SKILL.md

Use when adding a project-level rule that AI coding agents should follow (no-print, no-inline-paths, naming conventions, commit format, etc.) and the rule must be discoverable by any harness — Claude Code, Codex, Cursor, Kiro — not pinned to a single editor's hook system.

asd-ste100skills/asd-ste100/SKILL.md

Use when English text must be parsed without a human to resolve ambiguity — tool descriptions, error messages, inter-agent instructions, system prompts, status reports — and misreading has a real cost, or when text reads as dense, hedged, or easy to misparse. Triggers: disambiguate, STE100 rewrite, apply Simplified Technical English, plain-language rewrite, controlled-language rewrite, rewrite so an agent cannot misread this. Not for creative or marketing copy.

decision-grillingskills/decision-grilling/SKILL.md

Use when a plan, feature, design, or implementation direction has unresolved questions, hidden assumptions, or branching decisions that can change the work.

english-only-artifactsskills/english-only-artifacts/SKILL.md

Use whenever writing something that persists — docs, RFCs, ADRs, plans, specs, code comments, docstrings, identifiers, log and error strings, commit subjects, PR and issue text. Load it especially when the conversation is being held in Chinese or another non-English language, when the user asks for the discussion in that language, or when a Chinese/localized document is requested. Prevents the interaction language from leaking into durable artifacts.

explain-diff-htmlskills/explain-diff-html/SKILL.md

Use when asked to explain a code change, diff, commit range, branch, or PR to a human reader as a rich, self-contained HTML page with diagrams and an interactive quiz. Trigger on "explain this diff/PR/branch", "write up this change", "onboarding doc for this change", or a request for a shareable single-file explanation. Not for writing commit messages, PR descriptions, changelogs, or release notes, and not for reviewing a change for defects.

explain-diff-mystskills/explain-diff-myst/SKILL.md

Use when asked to explain a code change, diff, commit range, branch, or PR to a human reader as a MyST Markdown document with mermaid diagrams, callouts, and a dropdown-based quiz. Trigger on "explain this diff/PR/branch", "write up this change", "onboarding doc for this change", or a request for a rendered/publishable Markdown explanation. Not for writing commit messages, PR descriptions, changelogs, or release notes, and not for reviewing a change for defects.

Plugin manifests2

plugins/discuss/.claude-plugin/plugin.json
{
  "name": "discuss",
  "version": "0.7.0",
  "description": "ADR-driven development, agent spec conventions, decision grilling, English-only artifacts, controlled-language rewrites, and diff explanations",
  "keywords": [
    "adr",
    "rfc",
    "design",
    "conventions",
    "documentation",
    "diff",
    "ste"
  ],
  "skills": "./skills",
  "interface": {
    "displayName": "Discuss",
    "shortDescription": "Design-time reasoning: RFCs, ADRs, project rules, decision grilling, plain-language rewrites, and diff explanations",
    "longDescription": "Skills for the design phase and for explaining the result. Grill a plan until the branching decisions are settled, log the discussion as an append-only RFC, record the outcome as an atomically-edited ADR, publish project rules where any harness will find them, keep every written artifact in English regardless of the conversation language, rewrite text an agent must parse into single-meaning Simplified Technical English, and turn a finished diff, branch, or PR into a teaching artifact — a self-contained HTML page or a MyST Markdown document with diagrams and a comprehension quiz.",
    "developerName": "HernandoR",
    "category": "Productivity",
    "capabilities": [
      "Interactive",
      "Write"
    ],
    "defaultPrompt": [
      "Grill this plan before I implement it.",
      "Record this decision as an ADR.",
      "Explain this PR for someone new to the codebase."
    ]
  }
}
plugins/discuss/plugin.json
{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "discuss",
  "version": "0.7.0",
  "description": "ADR-driven development, agent spec conventions, decision grilling, English-only artifacts, controlled-language rewrites, and diff explanations",
  "author": {
    "name": "HernandoR",
    "email": "[email protected]"
  },
  "homepage": "https://github.com/HernandoR/agent-skillset",
  "repository": "https://github.com/HernandoR/agent-skillset",
  "keywords": [
    "adr",
    "rfc",
    "design",
    "conventions",
    "documentation",
    "diff",
    "ste"
  ]
}

For maintainers

If you maintain this plugin, link to this source-backed listing from your README so users can review its manifest and indexed components.

[discuss on Agent Plugins Marketplace](https://pluginsmp.com/plugins/discuss-4)