Files
sproutclaw/.pi/prompts/pr.md
Andrés Vinueza aa25726ebf feat(coding-agent,tui): support argument-hint frontmatter in prompt templates (#2780)
* feat(coding-agent,tui): support argument-hint frontmatter in prompt templates

Parse argument-hint from prompt template frontmatter and display it
in the autocomplete dropdown description, matching Claude Code's
convention for custom commands.

Frontmatter format:
  ---
  description: Code review
  argument-hint: "[file | #PR | PR-URL]"
  ---

The hint renders in the description column of the autocomplete list:
  review   [file | #PR | PR-URL] — Code review

Closes #2761

* docs(coding-agent,tui): add argument-hint documentation, tests, and built-in hints

- Document argument-hint frontmatter in prompt-templates.md with <required>/[optional] convention
- Add argument-hint to built-in prompts: pr, is, wr
- Expand tests: required/optional hints, missing hints, empty hints, special characters
- Add changelog entries for coding-agent and tui
2026-04-16 23:02:35 +02:00

2.2 KiB

description, argument-hint
description argument-hint
Review PRs from URLs with structured issue and code analysis <PR-URL>

You are given one or more GitHub PR URLs: $@

For each PR URL, do the following in order:

  1. Add the inprogress label to the PR via GitHub CLI before analysis starts. If adding the label fails, report that explicitly and continue.
  2. Read the PR page in full. Include description, all comments, all commits, and all changed files.
  3. Identify any linked issues referenced in the PR body, comments, commit messages, or cross links. Read each issue in full, including all comments.
  4. Analyze the PR diff. Read all relevant code files in full with no truncation from the current main branch and compare against the diff. Do not fetch PR file blobs unless a file is missing on main or the diff context is insufficient. Include related code paths that are not in the diff but are required to validate behavior.
  5. Check for a changelog entry in the relevant packages/*/CHANGELOG.md files. Report whether an entry exists. If missing, state that a changelog entry is required before merge and that you will add it if the user decides to merge. Follow the changelog format rules in AGENTS.md. Verify:
    • Entry uses correct section (### Breaking Changes, ### Added, ### Fixed, etc.)
    • External contributions include PR link and author: Fixed foo ([#123](https://github.com/badlogic/pi-mono/pull/123) by [@user](https://github.com/user))
    • Breaking changes are in ### Breaking Changes, not just ### Fixed
  6. Check if packages/coding-agent/README.md, packages/coding-agent/docs/.md, packages/coding-agent/examples/**/.md require modification. This is usually the case when existing features have been changed, or new features have been added.
  7. Provide a structured review with these sections:
    • Good: solid choices or improvements
    • Bad: concrete issues, regressions, missing tests, or risks
    • Ugly: subtle or high impact problems
  8. Add Questions or Assumptions if anything is unclear.
  9. Add Change summary and Tests.

Output format per PR: PR: Changelog:

  • ... Good:
  • ... Bad:
  • ... Ugly:
  • ... Questions or Assumptions:
  • ... Change summary:
  • ... Tests:
  • ...

If no issues are found, say so under Bad and Ugly.