FormForge Journey Map Synthesis
Review-stage synthesis for the active flat FormForge scope. This page proposes the canonical research/journey-map.md content from the approved Service Blueprint and User Story Map intermediates, then stops for compiled YAML approval.
Review Checklist
- Confirm the proposed lifecycle and user journeys match the approved FormForge scope.
- Confirm critical moments and evidence confidence are accurate enough for a canonical research artifact.
- Choose whether the post-approval next step should emphasize lifecycle metrics before positioning.
- Compile YAML from the bottom of this page and paste it into a fresh
$journey-mapsession.
Proposed Summary
FormForge's unified customer journey centers on client-service intake: a consultant, coach, or small-agency operator needs a fast, polished way to collect the right client information before kickoff or delivery work. The current product loop already covers the walking skeleton from AI-assisted draft creation through public submission, response review, status triage, analytics, and CSV export.
The journey risk is not basic form creation. It is the post-submission transition from "a response arrived" to "this client is ready for kickoff or delivery." Both approved journey frameworks identify intake completeness, response readiness, and handoff into the user's real work system as the highest-leverage gaps.
User Journeys
Owner-Operator Consultant / Coach
Entry: a new paid client, program, discovery call, audit, or package requires structured intake.
Happy path: describe the intake need, edit generated fields, publish a credible public link, review the response, and move answers into delivery work.
Failure modes: weak AI draft, incomplete answers, missed assets/access details, missed notification, or ongoing copy/paste after submission.
Agency / Operations Coordinator
Entry: repeated onboarding or project briefs across accounts.
Happy path: standardize intake, tailor per client, collect responses, review readiness, and route answers into the agency operating system.
Failure modes: submissions do not become delivery-ready artifacts, or broad integrations arrive before the key destination is validated.
External Client / Respondent
Entry: receives a public intake link.
Happy path: completes relevant fields without an account, fixes validation errors, and gets clear success confirmation.
Failure modes: unclear file requests, mobile friction, Turnstile/validation friction, or answers that pass validation but do not help kickoff.
Customer Lifecycle
| Stage Cluster | Current Support | Main Risk | Confidence |
|---|---|---|---|
| Draft to publish | AI generation, visual editing, settings, themes, publish snapshots. | Generated forms may not be complete enough for service-specific intake. | Medium-high |
| Submit to review | Public form, validation, Turnstile, response storage, status labels, analytics. | Field-level validity may not equal kickoff readiness. | Medium-high |
| Review to handoff | Email notification and CSV export. | Manual copy/paste remains the highest-value unresolved stage. | Medium-high |
| Reuse to expansion | Duplicate, regenerate, close, monitor, billing exists but deferred. | Expansion surfaces should not outrun core-loop validation. | Medium |
Critical Moments
| Moment | Why It Wins Or Loses | Evidence | Confidence |
|---|---|---|---|
| First useful AI draft | Beats blank-page setup if the generated form is close enough; loses if output feels generic. | ICP blank-page pain; AI generation implementation; User Story Map draft activity. | Medium-high |
| Pre-publish confidence | User must trust the form captures the right service-specific details before sending it to a client. | Service Blueprint publish quality gap; User Story Map completeness stories. | Medium |
| Respondent completion | External client must complete the form without account friction, validation confusion, or unclear asset requests. | Public form/submit route; ICP respondent friction; complete-intake stories. | Medium-high |
| Response readiness | Provider must know whether the answer set is complete enough for kickoff or delivery. | Service Blueprint review bottleneck; readiness-signal stories. | Medium-high |
| Handoff into real work | Value compounds only when answers reach the user's actual work system. | ICP manual copy/paste pain; competitive integrations; both journey frameworks. | Medium-high |
Evidence Matrix
| Claim | Supporting Framework(s) | Evidence | Confidence |
|---|---|---|---|
| The journey should focus on client-service intake/onboarding. | Service Blueprint, User Story Map | Approved ICP and both framework summaries center on consultants, coaches, and small agencies. | High |
| The walking skeleton from draft to public submission and CSV export exists. | Service Blueprint, User Story Map | README core loop; AI generation, editor, publish snapshots, public submit, response router, export. | High |
| AI drafting is useful but not durable differentiation by itself. | User Story Map | ICP blank-page pain plus competitive analysis showing AI creation across incumbents. | High |
| Intake completeness and response readiness are core journey risks. | Service Blueprint, User Story Map | Gaps around pre-publish checks, completeness scoring, and follow-up needs. | Medium-high |
| Post-submission handoff is the highest-value unresolved stage. | Service Blueprint, User Story Map | ICP manual copy/paste pain; competitive integration battleground; CSV/email-only current boundary. | Medium-high |
| Direct customer evidence is still the largest confidence gap. | Service Blueprint, User Story Map | No customer-feedback file, interviews, analytics, support tickets, or win/loss notes. | High |
Journey Gaps
| Gap | Why It Matters | Potential Owner After Approval |
|---|---|---|
| Direct customer evidence | Current confidence is research/code-backed, not interview or usage-backed. | Customer feedback/discovery before hardening roadmap assumptions. |
| First-success instrumentation | The journey cannot yet prove first prompt, first publish, first response, first export, repeat use, or handoff behavior. | $lifecycle-metrics if measurement must precede product-loop decisions. |
| Intake completeness criteria | Field validation does not prove the response is useful enough for kickoff or delivery. | $onboarding-map if activation/first-success criteria need sharper definition. |
| Handoff destination priority | Evidence says handoff matters, but not which destination comes first. | Customer interviews, conversion/retention research, or lifecycle metrics depending on the blocker. |
| Notification/support recovery | Missed notifications, failed submissions, and incomplete responses lack a visible recovery workflow. | $lifecycle-metrics or support research if reliability risk blocks validation. |
Product path implication: the active flat FormForge path remains appropriate. The journey evidence does not promote deferred product paths for lead/quote forms, event registration, nonprofit volunteer forms, or HR operations.
Proposed File Changes After Approval
- Write canonical
research/journey-map.mdwith the approved synthesis. - Archive
research/_working/preliminary-journey-map-research.md. - Archive consumed
research/_working/journey-map-run.yaml. - Remove active working packet and run manifest after archive.
- Update
research/.progress.yamlactive FormForgepipeline_stagetojourney-map. - Convert this page to confirmed with the approval record preserved.
Approval Gates
Compiled YAML
Use this local compiler, then paste the YAML into a fresh Codex session with $journey-map. The next agent will consume it and either finalize the canonical artifact or update this review page.
Click "Compile YAML" after selecting the approval gates.