Stop Sending PDFs — Ship an Interactive Proposal Blueprint
Stop Sending PDFs — Ship an Interactive Proposal Blueprint
Turn proposals into interactive blueprints—searchable, audience-filtered, annotated docs with optional ChatGPT access.
·Updated on:··
Get Practical CMS Decision Briefs
Get concise advice on choosing the right CMS, understanding migration costs, and avoiding expensive implementation mistakes before they become roadmap problems.
A long proposal is not an attachment. It is a product: a decision surface, a shared source of truth, and a working document stakeholders will return to for weeks.
For years the default was the same. Write a careful discovery or SOW, compile a branded PDF, email the link, hope people read it. They skim. They lose the thread between chapter 7 and chapter 31. They ask the same questions in Slack that the document already answers. When one person needs the executive view and another needs the field matrix, you send a second PDF — or worse, one overloaded PDF that serves nobody well.
I stopped treating the PDF as the primary artifact.
I still generate PDFs. They are useful. They are no longer the product.
The product is a private interactive blueprint: the same canonical Markdown, presented as a documentation site that people can navigate, filter by audience, search, ask, annotate, and — when it helps — pull into ChatGPT with consent.
The cost of a static proposal
A 40-chapter discovery blueprint is not a brochure. It is closer to an internal product docs site that happens to decide a project.
In a PDF:
Depth is fixed. You either drown executives in tables or starve implementers of detail.
Finding something means Ctrl+F across a long scroll, or remembering which heading held the risk register.
Clarifying a recommendation means emailing the author — even when the answer is already in chapter 12.
Review comments live in threads, sticky notes, or a separate spreadsheet, disconnected from the passage they refer to.
The document cannot meet people where they already work with AI tools.
None of that is a writing problem. It is a presentation problem.
Reframe: product docs for a decision
Product teams already know how to present complex systems. They ship docs sites: sidebar navigation, search, deep links, audience modes, sometimes an assistant that answers from the docs.
Proposals deserve the same medium.
When a stakeholder opens the blueprint, the first screen should teach the medium, not dump a table of contents. In the portal I built, a once-per-browser welcome dialog greets them with:
Welcome to the interactive blueprint
Then it shows the capabilities that make the format worth using: choose your view, search the blueprint, ask the blueprint, add feedback — plus an optional path to connect ChatGPT via MCP, and a clear escape hatch labeled Prefer PDFs? for people who still need a static file.
That framing matters. You are not apologizing for not sending a PDF. You are inviting them into a better working surface.
What “interactive” actually means
Skip the feature list as a list of features. Each capability exists to change how stakeholders use the document.
Navigate like documentation
Chapters live in a sidebar. Each page has an in-page table of contents, related-chapter links, and prev/next. A 41-chapter blueprint becomes browsable the way a product docs site is browsable — not a single scroll through a binder.
One source, three depths
The same Markdown source powers three views:
Audience is a view switcher, not three forked documents. Stakeholders share one URL. They change depth in the sidebar. Chat retrieval follows the same filter, so an Executive session does not quietly pull Reference-only detail unless they switch to Full.
Authoring this well is an editorial skill. You tag content with decision, reference, or both on purpose. Untagged content appears in both decision and reference views — there are no smart defaults that guess for you.
Ask the blueprint — with citations
“Ask the blueprint” is not a generic chatbot bolted onto a website.
It answers from the proposal text. Every material conclusion is expected to cite a stable source id (for example [§27:editable-and-locked-boundary]). The UI turns those citations into clickable chips. The model is instructed to distinguish confirmed facts, recommendations, assumptions, drafts, and open decisions — and to say when the blueprint does not answer the question.
That is the difference between an assistant that helps stakeholders work the document and one that invents confidence.
Optional Listen narration is available for completed answers when someone wants to hear the response. The written answer remains the source of truth.
Feedback on the living document
Reviewers can select a passage, leave a comment on that exact text, or leave page-level feedback. Comments go to a review workflow. They do not silently edit the canonical Markdown.
The document stays authoritative. Feedback stays attached to the passage that prompted it.
Bring the blueprint into ChatGPT (optional)
For stakeholders who already work in ChatGPT, the portal can expose a read-only MCP server. After OAuth consent, tools can list chapters and fetch clean chapter Markdown. The first-run welcome dialog includes a short setup carousel for connecting the plugin and referencing it with @.
The proposal stops being a file you upload into a chat. It becomes a resource the chat can request, with authentication and explicit permission.
PDFs when a static file is easier
Executive, Reference, and Full PDF editions still exist as companions. Offline reading, legal archives, printouts, and “just email me the file” culture are real. The welcome dialog says so plainly: explore in the app, or use the PDF editions when a static document is easier.
The PDF is a export. The interactive blueprint is the product.
Author once, present for the reader
The technical constraint that makes this honest: there is one canonical Markdown source. The PDF pipeline and the web portal both read it. The portal never forks chapters into a CMS.
That forces a better authoring habit:
Write structured chapters with clear headings and intentional audience tags.
Prefer blocks that mean something (BLUF, scope tables, timelines, callouts) over walls of prose.
Present in the medium that fits the reader — web first for work, PDF second for portability.
Higher value is not “more pages.” Higher value is shorter paths to the right depth, with provenance when someone asks a hard question.
When PDFs still win
Keep PDFs when:
Someone needs a file that works offline or in a regulated archive
A counterparty’s process requires an attachment
You need a frozen snapshot for signature or print
A stakeholder simply prefers a linear read for a short document
Do not keep PDFs as the primary medium for multi-audience, multi-week discovery blueprints. That is where interactive presentation earns its keep.
What to take away
If you sell with long proposals, SOWs, or discovery docs, treat presentation as part of the offer:
Ship a private docs-style blueprint, not only a PDF
Let audience control depth without forking the source
Make the document searchable and askable, with citations
Collect feedback on passages without corrupting the source of truth
Keep PDFs as optional companions
The stack that implements this — Next.js, Fumadocs, grounded chat, dual auth, MCP — is a separate story for builders.