docs(agents): add GitHub Backlog Manager documentation and agent catalog

[WilliamBerryiii]

Description

Added a new docs/agents/ documentation section with a top-level agent catalog and a seven-page documentation suite for the GitHub Backlog Manager. Updated existing documentation pages to cross-reference the new agent catalog and corrected artifact counts.

• Created docs/agents/README.md as the agent systems catalog, organizing 22 agents into 9 functional groups with a summary table and per-group descriptions
• Added docs/agents/github-backlog/README.md as the hub page covering all five workflows (discovery, triage, sprint planning, execution, quick add), autonomy levels, and prerequisites
• Added docs/agents/github-backlog/discovery.md documenting three discovery paths (user-centric, artifact-driven, search-based) with output artifacts and usage examples
• Added docs/agents/github-backlog/triage.md covering the 17-label taxonomy (5 categories), duplicate detection across four similarity dimensions, and confidence scoring
• Added docs/agents/github-backlog/sprint-planning.md with the six-step milestone discovery process, capacity planning, and handoff generation
• Added docs/agents/github-backlog/execution.md documenting checkbox-based handoff consumption, operation logging, and recovery from interruption
• Added docs/agents/github-backlog/using-together.md with an ASCII pipeline diagram, end-to-end walkthrough, and iteration model for connecting all four workflows
• Added docs/agents/github-backlog/why-backlog-manager.md explaining the cognitive-separation design rationale and quality comparison between manual and managed approaches
• Updated docs/README.md agent and prompt counts from 18/18 to 22/27 and added an Agent Systems section
• Added Agent Catalog cross-references to docs/getting-started/README.md, docs/architecture/ai-artifacts.md, and docs/rpi/README.md

Related Issue(s)

Closes #478

Type of Change

Select all that apply:

Code & Documentation:

• Bug fix (non-breaking change fixing an issue)
• New feature (non-breaking change adding functionality)
• Breaking change (fix or feature causing existing functionality to change)
• Documentation update

Infrastructure & Configuration:

• GitHub Actions workflow
• Linting configuration (markdown, PowerShell, etc.)
• Security configuration
• DevContainer configuration
• Dependency update

AI Artifacts:

• Reviewed contribution with prompt-builder agent and addressed all feedback
• Copilot instructions (.github/instructions/*.instructions.md)
• Copilot prompt (.github/prompts/*.prompt.md)
• Copilot agent (.github/agents/*.agent.md)
• Copilot skill (.github/skills/*/SKILL.md)

Note for AI Artifact Contributors:

• Agents: Research, indexing/referencing other project (using standard VS Code GitHub Copilot/MCP tools), planning, and general implementation agents likely already exist. Review .github/agents/ before creating new ones.
• Skills: Must include both bash and PowerShell scripts. See Skills.
• Model Versions: Only contributions targeting the latest Anthropic and OpenAI models will be accepted. Older model versions (e.g., GPT-3.5, Claude 3) will be rejected.
• See Agents Not Accepted and Model Version Requirements.

Other:

• Script/automation (.ps1, .sh, .py)
• Other (please describe):

Sample Prompts (for AI Artifact Contributions)

N/A — this PR contains documentation only.

Testing

• All six validation commands pass clean:
  • npm run lint:md — no new violations
  • npm run spell-check — 427 files, 0 issues
  • npm run lint:frontmatter — all 8 new files have valid frontmatter
  • npm run lint:md-links — no broken links
  • npm run lint:ps — no PowerShell changes
  • npm run lint:all — clean (pre-existing symlink warnings only)
• ASCII diagram alignment verified programmatically
• Convention compliance validated across all 8 new files

Checklist

Required Checks

• Documentation is updated (if applicable)
• Files follow existing naming conventions
• Changes are backwards compatible (if applicable)
• Tests added for new functionality (if applicable)

AI Artifact Contributions

• Used /prompt-analyze to review contribution
• Addressed all feedback from prompt-builder review
• Verified contribution follows common standards and type-specific requirements

Required Automated Checks

The following validation commands must pass before merging:

• Markdown linting: npm run lint:md
• Spell checking: npm run spell-check
• Frontmatter validation: npm run lint:frontmatter
• Link validation: npm run lint:md-links
• PowerShell analysis: npm run lint:ps

Security Considerations

• This PR does not contain any sensitive or NDA information
• Any new dependencies have been reviewed for security issues
• Security-related scripts follow the principle of least privilege

Additional Notes

All new documentation follows the established hve-core writing style (active voice, imperative mood, second-person address) and includes standard frontmatter with title, description, author, ms.date, ms.topic, keywords, and estimated_reading_time fields. Each page includes the standard Copilot footer.

[github-actions]

Dependency Review

✅ No vulnerabilities or license issues or OpenSSF Scorecard issues found.

Scanned Files

None

[codecov-commenter]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 85.34%. Comparing base (fdf9145) to head (d4d7dcf).

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #503      +/-   ##
==========================================
- Coverage   85.36%   85.34%   -0.03%     
==========================================
  Files          23       23              
  Lines        4475     4475              
==========================================
- Hits         3820     3819       -1     
- Misses        655      656       +1     

Flag	Coverage Δ
pester	85.34% <ø> (-0.03%)	⬇️

Flags with carried forward coverage won't be shown. Click here to find out more.
see 1 file with indirect coverage changes

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[Copilot]

Pull request overview

Adds a new docs/agents/ documentation section that catalogs agent systems and introduces a multi-page user guide for the GitHub Backlog Manager, then wires the new catalog into existing docs and updates artifact counts.

Changes:

• Introduces an Agent Systems Catalog (docs/agents/README.md) and a GitHub Backlog Manager documentation suite under docs/agents/github-backlog/.
• Updates the main docs index (docs/README.md) with an Agent Systems section and corrected agent/prompt counts.
• Adds cross-references from getting-started, architecture, and RPI docs to the new agent catalog.

Reviewed changes

Copilot reviewed 12 out of 12 changed files in this pull request and generated 6 comments.

Show a summary per file

File	Description
docs/README.md	Updates counts and adds an “Agent Systems” entry point that links into the new catalog and backlog manager docs.
docs/agents/README.md	New top-level agent systems catalog page grouping agents and linking to system docs.
docs/agents/github-backlog/README.md	New hub page for the GitHub Backlog Manager workflows, autonomy model, and prerequisites.
docs/agents/github-backlog/discovery.md	New discovery workflow guide (paths, outputs, usage).
docs/agents/github-backlog/triage.md	New triage workflow guide (taxonomy, duplicates, outputs, usage).
docs/agents/github-backlog/sprint-planning.md	New sprint planning workflow guide (milestone discovery, outputs, usage).
docs/agents/github-backlog/execution.md	New execution workflow guide (handoff consumption, logging, outputs, usage).
docs/agents/github-backlog/using-together.md	New end-to-end pipeline walkthrough connecting the workflows.
docs/agents/github-backlog/why-backlog-manager.md	New rationale page describing the cognitive separation design and quality tradeoffs.
docs/getting-started/README.md	Adds a link to the new agent catalog from getting started.
docs/rpi/README.md	Adds a link to the agent systems catalog from the RPI docs hub.
docs/architecture/ai-artifacts.md	Adds a related-docs link to the new agent systems catalog.

[Copilot]

Pull request overview

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

[bindsi]

that´s really helpful...nice!

[katriendg]

I think this is great, though I will probably get a more detailed read once I use the docs along with it. It's a lot of content to read in detail 👓

[Copilot]

Pull request overview

Copilot reviewed 12 out of 12 changed files in this pull request and generated 8 comments.

[Copilot]

Pull request overview

Copilot reviewed 12 out of 12 changed files in this pull request and generated 3 comments.

[Copilot]

The PR description states "Updated docs/README.md agent and prompt counts from 18/18 to 22/27" but the actual change removes the counts entirely rather than updating them. The line now reads "specialized agents, reusable prompts, instruction sets" without specific numbers. If the intent was to provide updated counts, consider changing to "22 specialized agents, 27 reusable prompts, 17+ instruction sets". If the intent was to remove specific counts to avoid maintenance burden, the PR description should be updated to reflect this decision.

[Copilot]

The DevOps Quality row lists "2" agents and describes "Two agents focused on code quality and deployment reliability. Covers PR review automation and build pipeline analysis." However, only the pr-review agent exists in the codebase (.github/agents/pr-review.agent.md). No build pipeline analysis agent was found. Verify the count and update to "1" if only pr-review exists, or clarify which second agent is intended.

[Copilot]

These bullet points are complete sentences with subject-verb constructions and should end with periods according to the Markdown Instructions guidelines for bullet point punctuation. For example, line 22 should end with a period after "contributors", line 23 after "gaps", and line 24 after "work".