myITprocess Roadmap
Overview
Review answers become findings; the vCIO turns findings into
recommendations (a project, a maintenance item, a business goal, with a
budget and hours); related recommendations are grouped into initiatives.
This is the roadmap a vCIO presents to the client. See
api-patterns for filters, paging and the rate limit.
Every tool here is a Conduit read tool. None is admin-gated and none writes:
accepting, rejecting or re-prioritising a recommendation happens in the
myITprocess UI.
Anti-triggers
- Which reviews are late or what the next review should cover — use
alignment-reviews.
- One client's QBR brief — use qbr-prep, which
pulls from this skill's data.
Key Concepts
Recommendations (myitprocess_recommendations_list)
| Field |
Values |
type |
Project, TimeMaterial, Maintenance, Strategic, BusinessGoal |
responsibleParty |
Us (the MSP), You (the client), ThirdParty |
status |
NotDiscussed, Accepted, Rejected, OnHold, InProgress, Completed |
priority |
NoPriority, Low, Medium, High |
Also budget, budgetMonth, hours, client.id / client.name,
initiative.id, parentId, isArchived, name, description. Each item
also carries feedback history and linked finding IDs; those are arrays, so they
come back in results but cannot be filtered or sorted.
Findings (myitprocess_findings_list)
question.label, question.text, review.id, review.name,
vcioAnswerType, findingType, recommendationId, isArchived.
findingType |
Meaning |
AssignedToRecommendation |
The gap has a recommendation (recommendationId) |
UnassignedReviewFinding |
A gap from a review that no recommendation addresses yet |
Legacy |
A finding in myITprocess's older finding model; report it with the rest |
Findings have no client field. Scope them through review.id (reviews are
per client) or through recommendationId.
Initiatives (myitprocess_initiatives_list)
title, description, client.id / client.name, isArchived, and the IDs
of the recommendations grouped under the initiative (array).
Configurations (myitprocess_recommendations_configurations_list)
The IT Glue configurations (devices and assets) attached to one
recommendation: name, status, type, location, expirationDate.
Requires recommendation_id. One call per recommendation, so use it only on the
recommendations that matter.
Common Workflows
Budget forecast for a client
myitprocess_recommendations_list filtered by client.id and isArchived
equal false; page to totalCount.
- Drop
Rejected and Completed. Keep Accepted, InProgress, OnHold and
NotDiscussed, but keep NotDiscussed in its own column: it is proposed
spend, not committed spend.
- Group
budget and hours by budgetMonth (or by quarter), then by type.
Show responsibleParty: a You or ThirdParty item is client or vendor
spend, not MSP project revenue.
- Attach initiative titles from
myitprocess_initiatives_list filtered by the
same client.id, matching on initiative.id.
- Flag any
High priority item with no budget or no budgetMonth.
Open gaps nobody has picked up
- Get the client's reviews:
myitprocess_reviews_list filtered by client.id.
- For each review (usually one or two),
myitprocess_findings_list filtered
review.id equal that ID, findingType equal
UnassignedReviewFinding, and isArchived equal false. Keep every
filter joined by the default and; mixing and and or in one call has no
documented precedence.
- List each finding's
question.label / question.text and the review it came
from. These are the gaps with no recommendation; treat any that read as
security controls as the first conversation for the vCIO.
Recommendations waiting on a decision (portfolio)
myitprocess_recommendations_list filtered status equal NotDiscussed
and priority equal High, sorted by client.name. Group by client: this is
the "bring to the next meeting" list.
Which devices does a recommendation cover?
myitprocess_recommendations_configurations_list with the recommendation's
id as recommendation_id. Sort by expirationDate to show warranty or
lifecycle pressure behind a hardware refresh recommendation.
Gotchas
budget currency and budgetMonth format come back as stored. Report
them as returned; do not convert or assume a fiscal calendar.
- Archived items are returned unless filtered. Add
isArchived equal
false for anything client-facing.
- Sub-recommendations. A non-empty
parentId means the item sits under
another recommendation; do not double-count its budget if the parent already
carries the total. Check with the user when parent and child both have
budgets.
- Findings can be sensitive. They describe security gaps at the client.
Keep them out of anything sent outside the MSP unless the user asks.
1---2name: myitprocess-roadmap3description: >4 The myITprocess strategic roadmap: findings from alignment reviews, the5 recommendations they become (type, responsible party, status, priority,6 budget, budget month, hours), the initiatives that group recommendations, and7 the IT Glue configurations attached to a recommendation. Covers budget8 forecasting, open-gap reviews, and tracing a finding to its recommendation and9 the devices behind it. Read-only.10when_to_use: >-11 When building or reviewing a client's IT roadmap or budget forecast, listing12 open recommendations by priority or status, finding review gaps that never13 became recommendations, or checking which devices a recommendation covers.14 Use when: myitprocess roadmap, recommendations, initiatives, findings, IT15 budget forecast, technology roadmap, or recommendation configurations.16metadata:17 source: https://skillmd.com/skills/wyre-ai/myitprocess-roadmap18---1920# myITprocess Roadmap2122## Overview2324Review answers become **findings**; the vCIO turns findings into25**recommendations** (a project, a maintenance item, a business goal, with a26budget and hours); related recommendations are grouped into **initiatives**.27This is the roadmap a vCIO presents to the client. See28[api-patterns](../api-patterns/SKILL.md) for filters, paging and the rate limit.2930Every tool here is a Conduit **read** tool. None is admin-gated and none writes:31accepting, rejecting or re-prioritising a recommendation happens in the32myITprocess UI.3334## Anti-triggers3536- **Which reviews are late or what the next review should cover** — use37 [alignment-reviews](../alignment-reviews/SKILL.md).38- **One client's QBR brief** — use [qbr-prep](../qbr-prep/SKILL.md), which39 pulls from this skill's data.4041## Key Concepts4243### Recommendations (`myitprocess_recommendations_list`)4445| Field | Values |46|-------|--------|47| `type` | `Project`, `TimeMaterial`, `Maintenance`, `Strategic`, `BusinessGoal` |48| `responsibleParty` | `Us` (the MSP), `You` (the client), `ThirdParty` |49| `status` | `NotDiscussed`, `Accepted`, `Rejected`, `OnHold`, `InProgress`, `Completed` |50| `priority` | `NoPriority`, `Low`, `Medium`, `High` |5152Also `budget`, `budgetMonth`, `hours`, `client.id` / `client.name`,53`initiative.id`, `parentId`, `isArchived`, `name`, `description`. Each item54also carries feedback history and linked finding IDs; those are arrays, so they55come back in results but cannot be filtered or sorted.5657### Findings (`myitprocess_findings_list`)5859`question.label`, `question.text`, `review.id`, `review.name`,60`vcioAnswerType`, `findingType`, `recommendationId`, `isArchived`.6162| `findingType` | Meaning |63|---------------|---------|64| `AssignedToRecommendation` | The gap has a recommendation (`recommendationId`) |65| `UnassignedReviewFinding` | A gap from a review that no recommendation addresses yet |66| `Legacy` | A finding in myITprocess's older finding model; report it with the rest |6768Findings have **no client field**. Scope them through `review.id` (reviews are69per client) or through `recommendationId`.7071### Initiatives (`myitprocess_initiatives_list`)7273`title`, `description`, `client.id` / `client.name`, `isArchived`, and the IDs74of the recommendations grouped under the initiative (array).7576### Configurations (`myitprocess_recommendations_configurations_list`)7778The IT Glue configurations (devices and assets) attached to **one**79recommendation: `name`, `status`, `type`, `location`, `expirationDate`.80Requires `recommendation_id`. One call per recommendation, so use it only on the81recommendations that matter.8283## Common Workflows8485### Budget forecast for a client86871. `myitprocess_recommendations_list` filtered by `client.id` and `isArchived`88 `equal` `false`; page to `totalCount`.892. Drop `Rejected` and `Completed`. Keep `Accepted`, `InProgress`, `OnHold` and90 `NotDiscussed`, but keep `NotDiscussed` in its own column: it is proposed91 spend, not committed spend.923. Group `budget` and `hours` by `budgetMonth` (or by quarter), then by `type`.93 Show `responsibleParty`: a `You` or `ThirdParty` item is client or vendor94 spend, not MSP project revenue.954. Attach initiative titles from `myitprocess_initiatives_list` filtered by the96 same `client.id`, matching on `initiative.id`.975. Flag any `High` priority item with no budget or no `budgetMonth`.9899### Open gaps nobody has picked up1001011. Get the client's reviews: `myitprocess_reviews_list` filtered by `client.id`.1022. For each review (usually one or two), `myitprocess_findings_list` filtered103 `review.id` `equal` that ID, `findingType` `equal`104 `UnassignedReviewFinding`, and `isArchived` `equal` `false`. Keep every105 filter joined by the default `and`; mixing `and` and `or` in one call has no106 documented precedence.1073. List each finding's `question.label` / `question.text` and the review it came108 from. These are the gaps with no recommendation; treat any that read as109 security controls as the first conversation for the vCIO.110111### Recommendations waiting on a decision (portfolio)112113`myitprocess_recommendations_list` filtered `status` `equal` `NotDiscussed`114and `priority` `equal` `High`, sorted by `client.name`. Group by client: this is115the "bring to the next meeting" list.116117### Which devices does a recommendation cover?118119`myitprocess_recommendations_configurations_list` with the recommendation's120`id` as `recommendation_id`. Sort by `expirationDate` to show warranty or121lifecycle pressure behind a hardware refresh recommendation.122123## Gotchas124125- **`budget` currency and `budgetMonth` format come back as stored.** Report126 them as returned; do not convert or assume a fiscal calendar.127- **Archived items are returned unless filtered.** Add `isArchived` `equal`128 `false` for anything client-facing.129- **Sub-recommendations.** A non-empty `parentId` means the item sits under130 another recommendation; do not double-count its budget if the parent already131 carries the total. Check with the user when parent and child both have132 budgets.133- **Findings can be sensitive.** They describe security gaps at the client.134 Keep them out of anything sent outside the MSP unless the user asks.