What you get

  • One offline HTML diagram with search, zoom, pan and a details panel
  • The JSON model behind it, ready for version control
  • A build script that catches dangling edges and gaps in the main path
  • A plain-text outline of every relationship for readers and print
  • Optional docs cover image from PopNow, quoted first

Good for

  • Onboarding docs for a service or repository
  • Tracing one request or job through a system
  • Workflows and lifecycles for design reviews

Not for

  • Proving runtime behaviour, load or failure impact
  • Hundreds of components in a single picture
  • Pixel-perfect diagrams for slide decks

How to use it

In Claude or ChatGPT

Use the PopNow skill "Interactive Architecture Diagram" (interactive-architecture-diagram) for this: Map how a file upload travels through this repo, from the web form to the thumbnail worker.

In a coding agent

/popnow-interactive-architecture-diagram Map how a file upload travels through this repo, from the web form to the thumbnail worker.

Then try

Mark the external storage bucket as a trust boundary and rebuild.

Make a second map for the upload status lifecycle.

What to have ready

  • The question the diagram should answer
  • A description, repository access or a component list
  • Exact names and protocols that must not change

Similar skills

View all →

Questions

Does the diagram need internet or a diagram service?

No. The result is one HTML file with everything inline. It opens from disk, works offline and makes no network requests.

How do I know which parts are guesses?

Every box and connection carries an evidence status: stated in the brief, seen in a file, inferred, or unknown. The details panel shows it with the file and line when there is one.

Can I edit the diagram later?

Yes. Edit the JSON model and run the build script again. It checks ids, connections and the main path before writing the new page.

What does PopNow add here?

Only an optional cover or share image for the page that hosts the diagram, after you see the price. The diagram is never generated by an image model.