feat(mcp): grow the prompt catalog — madtea workflows as /mcp__ slash commands #8

Closed
opened 2026-07-11 21:09:04 +00:00 by hexajon · 3 comments
hexajon commented 2026-07-11 21:09:04 +00:00 (Migrated from codeberg.org)

Part of #10.

Claude Code exposes MCP prompts as first-class slash commands: /mcp__<server>__<promptname> [space-separated args] (docs, verified 2026-07-06). madtea already ships 4 prompts (start branch, finish branch, file issue, +1) — this surface is confirmed-supported and underused.

Candidate additions, each wrapping a golden-path workflow: triage (rank + report the backlog), release (runbook-following release flow), reconcile (a conflicted-PR recovery path), review (fetch a PR + diff + comments for review), standup (recent activity summary).

Acceptance criteria

  • At least 3 new prompts, each with Title, argument declarations, and completions where arguments are enumerable (repo, issue number)
  • Prompt catalog documented in the reference docs / a help topic, including the /mcp__<server>__<name> invocation form
  • Live check: prompts appear in the Claude Code slash menu and execute with arguments
  • Naming follows naming-conventions.md (parity with CLI verb names where a CLI equivalent exists)
Part of #10. Claude Code exposes MCP prompts as first-class slash commands: `/mcp__<server>__<promptname> [space-separated args]` (docs, verified 2026-07-06). madtea already ships 4 prompts (start branch, finish branch, file issue, +1) — this surface is confirmed-supported and underused. Candidate additions, each wrapping a golden-path workflow: `triage` (rank + report the backlog), `release` (runbook-following release flow), `reconcile` (a conflicted-PR recovery path), `review` (fetch a PR + diff + comments for review), `standup` (recent activity summary). ## Acceptance criteria - [ ] At least 3 new prompts, each with `Title`, argument declarations, and completions where arguments are enumerable (repo, issue number) - [ ] Prompt catalog documented in the reference docs / a help topic, including the `/mcp__<server>__<name>` invocation form - [ ] Live check: prompts appear in the Claude Code slash menu and execute with arguments - [ ] Naming follows naming-conventions.md (parity with CLI verb names where a CLI equivalent exists)
hexajon commented 2026-07-11 22:08:51 +00:00 (Migrated from codeberg.org)

Landed in a later PR (2026-07-09): three new prompts — triage (optional target), review (required number, steers formal verdicts to review_create), standup (optional days, default 7) — plus the repo's first MCP completion support (server-wide CompletionHandler; live values for triage.target from known repos and review.number from open PRs, empty-menu degradation when uncredentialed) and generated docs/reference/prompts.md documenting the /mcp__madtea__<name> invocation form.

Machine-verified green: prompts/list declarations (existing 3 prompts frozen), per-prompt rendering incl. bare-invocation defaults, completion live-data + uncredentialed paths, full gate ×2, three clean adversarial review passes after a fix round.

The one criterion left open (why this stays open): "prompts appear in the Claude Code slash menu and execute with arguments" needs a live interactive session — unverifiable headless. Next interactive session on a post-release binary: type /mcp__madtea__ and confirm triage/review/standup appear and execute; then this closes. Note the correction for the record: the issue body's "madtea already implements the completion API in 4 places" referred to Cobra shell completion — there was no MCP completion code before this PR (confirmed on review).

release/reconcile prompt candidates remain unbuilt — deliberately left for a future slice rather than padding this one.

Landed in a later PR (2026-07-09): three new prompts — `triage` (optional `target`), `review` (required `number`, steers formal verdicts to `review_create`), `standup` (optional `days`, default 7) — plus the repo's first MCP completion support (server-wide CompletionHandler; live values for `triage.target` from known repos and `review.number` from open PRs, empty-menu degradation when uncredentialed) and generated `docs/reference/prompts.md` documenting the `/mcp__madtea__<name>` invocation form. **Machine-verified green:** prompts/list declarations (existing 3 prompts frozen), per-prompt rendering incl. bare-invocation defaults, completion live-data + uncredentialed paths, full gate ×2, three clean adversarial review passes after a fix round. **The one criterion left open (why this stays open):** "prompts appear in the Claude Code slash menu and execute with arguments" needs a live interactive session — unverifiable headless. Next interactive session on a post-release binary: type `/mcp__madtea__` and confirm triage/review/standup appear and execute; then this closes. Note the correction for the record: the issue body's "madtea already implements the completion API in 4 places" referred to Cobra *shell* completion — there was no MCP completion code before this PR (confirmed on review). `release`/`reconcile` prompt candidates remain unbuilt — deliberately left for a future slice rather than padding this one.
hexajon commented 2026-07-16 17:42:32 +00:00 (Migrated from codeberg.org)

Confirmed new commands appear.

Confirmed new commands appear.
hexajon commented 2026-07-17 19:26:16 +00:00 (Migrated from codeberg.org)

Verified complete against the code, not just the report. internal/mcp/prompts.go registers six prompts - start-feature, finish-branch, file-issue, plus this issue's three additions triage, review, standup - each with argument definitions, and the server declares the Completions capability with the server-wide CompletionHandler (internal/mcp/server.go:125) providing argument autocompletion. The live check recorded on this issue (2026-07-16, "Confirmed new commands appear.") covered the client-visible slash commands. All stated acceptance criteria are met. The two candidates this issue explicitly deferred (release, reconcile) are now tracked as their own leaf in #242 so the deferral survives this close; the prompts-vs-skills boundary question that came up in review is #241.

Verified complete against the code, not just the report. internal/mcp/prompts.go registers six prompts - start-feature, finish-branch, file-issue, plus this issue's three additions triage, review, standup - each with argument definitions, and the server declares the Completions capability with the server-wide CompletionHandler (internal/mcp/server.go:125) providing argument autocompletion. The live check recorded on this issue (2026-07-16, "Confirmed new commands appear.") covered the client-visible slash commands. All stated acceptance criteria are met. The two candidates this issue explicitly deferred (release, reconcile) are now tracked as their own leaf in #242 so the deferral survives this close; the prompts-vs-skills boundary question that came up in review is #241.
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
sixfold-space/madtea#8
No description provided.