docs: add adoption dashboard workflow#36
Conversation
|
|
||
| Move a target through: | ||
|
|
||
| `target` -> `qualified` -> `installed` -> `activated` -> `calibrated` -> `design partner` |
There was a problem hiding this comment.
Inconsistent state model across three docs
The Sequence Goal here shows target → qualified → installed → activated → calibrated → design partner, omitting contacted and replied. This conflicts with design-partner-progress-tracking.md, which defines the canonical nine-state model (targeted → contacted → replied → qualified → …), and with design-partner-target-list-template.md, which uses not contacted as the initial status and skips qualified between replied and installed. Team members tracking targets across these files will record different state values for the same pipeline position.
| `target` -> `qualified` -> `installed` -> `activated` -> `calibrated` -> `design partner` | |
| `target` -> `contacted` -> `replied` -> `qualified` -> `installed` -> `activated` -> `calibrated` -> `design partner` |
Prompt To Fix With AI
This is a comment left during a code review.
Path: docs/growth/design-partner-outreach-sequencing.md
Line: 9
Comment:
**Inconsistent state model across three docs**
The Sequence Goal here shows `target → qualified → installed → activated → calibrated → design partner`, omitting `contacted` and `replied`. This conflicts with `design-partner-progress-tracking.md`, which defines the canonical nine-state model (`targeted → contacted → replied → qualified → …`), and with `design-partner-target-list-template.md`, which uses `not contacted` as the initial status and skips `qualified` between `replied` and `installed`. Team members tracking targets across these files will record different state values for the same pipeline position.
```suggestion
`target` -> `contacted` -> `replied` -> `qualified` -> `installed` -> `activated` -> `calibrated` -> `design partner`
```
How can I resolve this? If you propose a fix, please make it concise.| - `Decision Question`: the one pricing or contract question they need answered | ||
| - `Benchmark Pair`: one of the current benchmark pairs or a close equivalent | ||
| - `Outreach Status`: `not contacted`, `contacted`, `replied`, `installed`, `activated`, `calibrated`, `design partner` | ||
| - `Next Step`: the next concrete action, not a vague note |
There was a problem hiding this comment.
Missing
qualified state in Outreach Status enum
The Outreach Status values jump from replied directly to installed, but design-partner-progress-tracking.md defines qualified as a distinct state between replied and installed, and design-partner-qualification-criteria.md defines five outcome labels after the qualification step. Without qualified here, the target list template can't reflect whether a target passed qualification.
| - `Next Step`: the next concrete action, not a vague note | |
| - `Outreach Status`: `not contacted`, `contacted`, `replied`, `qualified`, `installed`, `activated`, `calibrated`, `design partner` |
Prompt To Fix With AI
This is a comment left during a code review.
Path: docs/growth/design-partner-target-list-template.md
Line: 33
Comment:
**Missing `qualified` state in Outreach Status enum**
The Outreach Status values jump from `replied` directly to `installed`, but `design-partner-progress-tracking.md` defines `qualified` as a distinct state between `replied` and `installed`, and `design-partner-qualification-criteria.md` defines five outcome labels after the qualification step. Without `qualified` here, the target list template can't reflect whether a target passed qualification.
```suggestion
- `Outreach Status`: `not contacted`, `contacted`, `replied`, `qualified`, `installed`, `activated`, `calibrated`, `design partner`
```
How can I resolve this? If you propose a fix, please make it concise.
Add the missing INT-277 growth ops docs:\n\n- weekly adoption dashboard schema and manual tracking process\n- Friday review template\n- source-of-truth guidance for trackers vs Linear vs benchmark reports\n- growth index updates for discoverability\n\nThe target pipeline and buyer-facing offer docs were already landed in parallel; this commit closes the dashboard / review / source-of-truth slice.
Greptile Summary
This PR (INT-277) adds 11 new documentation files completing the growth ops slice for ProfitCtl's design-partner program: a weekly adoption dashboard schema with manual tracking process, a Friday review template, source-of-truth guidance mapping each artifact to its canonical owner, and supporting growth docs (value proposition, offer, targeting rubric, qualification criteria, outreach sequencing, progress tracking, and target list template). All cross-document links resolve correctly and referenced files exist.
Confidence Score: 5/5
Safe to merge — documentation-only PR with no code changes and all cross-file links verified.
All findings are P2 (documentation state-label misalignment); no code, schema, or logic is affected. The inconsistencies are worth fixing but do not block the merge.
docs/growth/design-partner-outreach-sequencing.md and docs/growth/design-partner-target-list-template.md — state labels don't fully align with the canonical model in design-partner-progress-tracking.md.
Important Files Changed
contactedandrepliedstates present in the canonical progress-tracking model.qualifiedstate defined in the progress-tracking document.Flowchart
%%{init: {'theme': 'neutral'}}%% flowchart TD A[Target Identified\ntargeting-rubric.md] --> B[targeted] B --> C[contacted] C --> D[replied] D --> E{Qualify?\nqualification-criteria.md} E -->|Pass| F[qualified] E -->|Fail| Z[not a fit / closed] F --> G[installed\noutreach-sequencing.md Stage 3] G --> H[activated\noutreach-sequencing.md Stage 4] H --> I[calibrated\noutreach-sequencing.md Stage 5] I --> J[design partner\noutreach-sequencing.md Stage 6] J --> K[closed] subgraph Weekly Loop L[adoption-dashboard.md\nFriday update] --> M[weekly-review-template.md\nFriday review] M --> N[Linear follow-through] end subgraph Source of Truth O[source-of-truth-guidance.md\nartifact ownership rules] end J -.->|feeds| L N -.->|drives| APrompt To Fix All With AI
Reviews (1): Last reviewed commit: "docs: add adoption dashboard workflow" | Re-trigger Greptile