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.md style
- Contain copy-able example prompts
- Link to related articles and source chat mode files
- Include the standard footer
Acceptance Criteria
Research
Complete research document available at:
.copilot-tracking/research/20250128-rpi-getting-started-guides-research.md
Related Discovery: README.md Broken Links
⚠️ Note: During research, .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.md could serve as the "getting started with task workflows" that the missing getting-started.prompt.md was intended to cover
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
docs/rpi-overview.md/clearbetween phasesdocs/rpi-task-researcher.mddocs/rpi-task-planner.mddocs/rpi-task-implementor.mddocs/rpi-using-together.mdTarget Audience
Developers new to structured AI workflows but familiar with VS Code and GitHub Copilot.
Content Requirements
Each article should:
docs/getting-started.mdstyleAcceptance Criteria
docs/directoryResearch
Complete research document available at:
.copilot-tracking/research/20250128-rpi-getting-started-guides-research.mdRelated Discovery: README.md Broken Links
.github/prompts/README.mdwas 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.mdRecommend creating a separate issue to either remove references or create the missing prompts.
Additional Context
rpi-overview.mdcould serve as the "getting started with task workflows" that the missinggetting-started.prompt.mdwas intended to cover