TPM · Technical Product Manager

Open source · MIT

A Technical Product Manager, in your terminal.

TPM audits your product by reading your codebase — the source of truth — and optionally cross-referencing your public marketing site for context. It never runs your product, never signs in, never hits your auth-gated screens.

View on GitHub Read the method 

npm install -g @sinameraji/tpm

cd your-product-repo
tpm init
tpm audit

No install? npx @sinameraji/tpm@latest audit works too. macOS users hitting EACCES on global install: one-time prefix fix.

First run prompts you for an optional marketing URL. Skip with Enter for a code-only audit. Every new device gets one free audit on our hosted Cloudflare Workers AI credits. After that, self-host on your own Cloudflare for unlimited audits.

Code is the source of truth. Marketing is auxiliary.

Production apps have multiple frontend/server/infra folders, env vars, seed data, auth flows — it's unrealistic to assume any tool can "run your product as a user" before reviewing it. TPM doesn't try. It reads your source, extracts the routes, forms, components, copy, auth gates and tracking events, and narrates what the user experiences from the code alone.

Optionally, TPM can also fetch your public marketing URL (landing, pricing, features) to understand the positioning promise. This is step 2 of tpm audit — explicitly optional, skippable with a keystroke. When marketing and code disagree, the code wins, and TPM reports the divergence as a finding.

The method is the product.

Every TPM audit runs the same six-stage pipeline. Each stage produces a validated YAML artifact.

  1. Intent extraction — Lean Canvas reconstructed from the codebase (primary) + marketing (auxiliary).
  2. Imagined critical path — user journey inferred from routes, forms, components.
  3. Delta analysis — classifies every step and names the intent mismatches.
  4. Leverage prioritization — ranks problems with an explicit argument, not a formula.
  5. Solution specs + prototypes — top 5 fixes, each with a working HTML prototype.
  6. Artifact assembly — spec.md + spec.html, PM-grade.

Built for product owners who know what they're looking at.

TPM won't tell you to add confetti animations or rainbow gradients. It finds the step in your signup flow that every honest user abandons, the page where your marketing copy contradicts the product, and the feature whose code exists but no user can reach it. Then it gives you a structured fix with a prototype.

Open source

All source, all patterns, all prompts: github.com/sinameraji/tpm. Fork it, audit it, send PRs, or just run it on your own infra.