microsoft/hve-core

Commit

feat(docs): add RPI workflow documentation and restructure docs folder (#102)

## Summary

Adds comprehensive RPI (Research → Plan → Implement) workflow
documentation and restructures the docs folder for better
discoverability.

## Changes

### New Documentation Structure

- `docs/getting-started/` - Setup guide and first workflow tutorial
- `docs/rpi/` - Five RPI workflow articles (overview, researcher,
planner, implementor, using-together)
- `docs/contributing/` - Consolidated contributing guides

### RPI Workflow Articles

| Article | Purpose |
|---------|---------|
| `README.md` | RPI framework overview and when to use it |
| `task-researcher.md` | How to use the Task Researcher chat mode |
| `task-planner.md` | How to use the Task Planner chat mode |
| `task-implementor.md` | How to use the Task Implementor chat mode |
| `using-together.md` | Complete workflow walkthrough with example |

### Getting Started Updates

- `first-workflow.md` - Hands-on 15-minute RPI tutorial using PowerShell
script creation
- `README.md` - Added optional scripts section for users to copy to
their projects

### Root README Optimization

- Replaced verbose agent list with "Try the RPI Workflow" section
- Added "What's Included" table consolidating features
- Replaced "Resources" with "Documentation" table linking new guides
- Updated project structure to show docs/ and prompts/

### Linting Fixes

- Fixed schema mapping to correctly scope root patterns to repo root
- Expanded `ms.topic` enum values in frontmatter schemas (`guide`,
`hub-page`, `architecture`, `research`)
- Fixed typo: `conceptual` → `concept` in `docs/rpi/README.md`
- Fixed grammar and list formatting per Copilot review feedback

## Testing

- All markdown files pass `markdownlint-cli2` validation
- All files pass `cspell` spelling check
- All tables formatted with `npm run format:tables`
- All frontmatter passes schema validation with no warnings

## Closes

Closes #101
Closes #103

## Related Work

Establishes the primary learning path for new HVE Core users.