ci: improve AI issue triager routing and prompts

[ayeshurun]

Summary

Fixes several gaps found while reviewing recent triaged issues, triager runs, and prompt outputs. All changes are scoped to .github/ triage infra (workflow + prompt YAMLs); no CLI source or tests are touched.

Changes

1. Fixed the "documentation" black hole

• New .github/prompts/documentation-triage.prompt.yml and a documentation entry in the workflow's labels_to_prompts_mapping. Documentation issues previously had no prompt mapping, so they kept needs triage forever with no AI comment. Its categories (Answered, Help Wanted, Needs Author Feedback, Needs Team Review) route through the existing post-processing keywords/labels — no new labels required.

2. Repaired the broken author-feedback loop

• Needs Author Feedback / Requires Additional Details now applies the needs author feedback label (mirroring the /needinfo command), so resourceManagement.yml automatically re-triages when the author replies. Previously the loop never fired because the AI path never added that label.

3. Fixed @{issue_author} never being substituted

• The "Resolve issue details" step prepends Issue author: @handle to the AI input, and all prompts now substitute that handle for {issue_author} instead of emitting the literal placeholder. Because the handle is prepended ahead of any [RE-TRIAGE] marker, re-triage detection changed from "starts with" to "contains".

4. Removed literal backticks around the Next Steps and footer lines in all prompts, so they render as markdown bold/blockquote rather than inline code.

5. Closed post-processing gaps

• Valuable Enhancement → adds ai:needs team attention for backlog filtering (no @mention spam).
• Out of Scope → auto-closes as not_planned (via a new closeReason).
• Removed the dead needs maintainer input keyword and updated the triage summary table to match.

Verification

• All prompt YAMLs, the workflow, and the policy file parse cleanly (yaml.safe_load).
• Routing re-checked end-to-end: every new/changed assessment category maps to an existing post-processing branch and label.

Note

The branch name is ayeshurun/dev-alonyeshurun-improve-ai-triager rather than the requested dev/alonyeshurun/improve-ai-triager — the rename tooling slugifies slashes and namespaces under the handle. Happy to recreate the branch if the exact format is required.

[Copilot]

Pull request overview

This PR improves the GitHub-side AI issue triage infrastructure by fixing prompt routing gaps, strengthening post-processing actions (labels/closing), and making prompts reliably address the issue author. All changes are scoped to .github/ (workflow + prompt YAMLs).

Changes:

• Added a documentation triage prompt and mapped the documentation label to it, preventing documentation issues from getting stuck in needs triage.
• Fixed the “author feedback” loop by having AI triage apply the needs author feedback label so policy automation can re-triage on author replies.
• Updated prompts and workflow input shaping to reliably provide/substitute the issue author handle and improved markdown rendering by removing inline-code formatting around key footer/Next Steps lines.

Reviewed changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated no comments.

Show a summary per file

File	Description
.github/workflows/ai-issue-triage.yml	Prepends Issue author: @… to AI input, adds documentation prompt routing, and improves post-processing (needs-author-feedback labeling, valuable-enhancement surfacing, out-of-scope close reason).
.github/prompts/bug-triage.prompt.yml	Updates re-triage detection to “contains” and adjusts Next Steps/footer formatting + author handle substitution guidance.
.github/prompts/feature-triage.prompt.yml	Updates re-triage detection to “contains” and adjusts Next Steps/footer formatting + author handle substitution guidance.
.github/prompts/question-triage.prompt.yml	Updates re-triage detection to “contains” and adjusts Next Steps/footer formatting + author handle substitution guidance.
.github/prompts/documentation-triage.prompt.yml	Introduces a dedicated documentation triage prompt with aligned categories/Next Steps/footer and author handle substitution guidance.