[Docs]: Create RPI Workflow Getting Started Guides #98
Description
Issue Description
Create five short getting started articles documenting the RPI (Research, Plan, Implement) workflow for the hve-core repository. These guides will help new users understand and effectively use the three task-specific chat modes to transform uncertainty into working code through a structured, evidence-based approach.
Articles to Create
| Article | Filename | Purpose |
|---|---|---|
| RPI Workflow Overview | docs/rpi-overview.md |
Explain the type transformation workflow, three phases, when to use RPI vs quick tasks, and /clear between phases |
| Task Researcher Guide | docs/rpi-task-researcher.md |
Document the Task Researcher chat mode with purpose, capabilities, output artifacts, and example prompt |
| Task Planner Guide | docs/rpi-task-planner.md |
Document the Task Planner chat mode with purpose, capabilities, output artifacts, and example prompt |
| Task Implementor Guide | docs/rpi-task-implementor.md |
Document the Task Implementor chat mode with purpose, capabilities, output artifacts, and example prompt |
| Using Them Together | docs/rpi-using-together.md |
Complete RPI workflow with context clearing, artifact handoffs, and practical walkthrough |
Target Audience
Developers new to structured AI workflows but familiar with VS Code and GitHub Copilot.
Content Requirements
Each article should:
- Be a 3-5 minute read (600-1000 words)
- Include valid frontmatter (title, description, author, ms.date, ms.topic, keywords, estimated_reading_time)
- Follow existing
docs/getting-started.mdstyle - Contain copy-able example prompts
- Link to related articles and source chat mode files
- Include the standard footer
Acceptance Criteria
- Five markdown articles created in
docs/directory - All articles follow repo markdown conventions (frontmatter, linting)
- Each article is standalone but includes navigation links to related articles
- Example prompts are practical and copy-able
- Links to source chat mode files are correct
- Article on using them together shows complete workflow with artifacts
Research
Complete research document available at:
.copilot-tracking/research/20250128-rpi-getting-started-guides-research.md
Related Discovery: README.md Broken Links
.github/prompts/README.md was found to reference 17 prompts, but only 6 actually exist. This is a separate issue that should be tracked independently:
Missing prompts (11 total): getting-started.prompt.md, task-planner-plan.prompt.md, git-commit.prompt.md, git-commit-message.prompt.md, git-merge.prompt.md, git-setup.prompt.md, ado-wit-discovery.prompt.md, get-my-work-items.prompt.md, create-my-work-items-handoff.prompt.md, ado-update-wit-items.prompt.md, uv-manage.prompt.md, adr-create.prompt.md, prompt-new.prompt.md, prompt-refactor.prompt.md
Recommend creating a separate issue to either remove references or create the missing prompts.
Additional Context
- The RPI guides reference chat modes (which all exist), not prompts
- Content is based on existing hve-core chat mode files and hve-ai-companion-guide documentation
- The new
rpi-overview.mdcould serve as the "getting started with task workflows" that the missinggetting-started.prompt.mdwas intended to cover