git404hub

what is product-first fr?

amarrey/product-first — explained in plain English

Analysis updated 2026-05-18

0Audience · pm founderComplexity · 1/5LicenseSetup · easy

tl;dr

A Claude Code skill that makes AI-assisted building start from product thinking, scaling how much design rigor a change gets to how risky it is, not how big it looks.

vibe map

mindmap
  root((repo))
    What it does
      Product before engineering
      Ceremony scaled to risk
      Explains jargon plainly
    Tech stack
      Claude Code skill
      Markdown SKILL.md
    Use cases
      Plan a feature before coding
      Get a written design for risky changes
      Hand off testing clearly
    Audience
      Solo builders
      Non-engineer founders
    Tiers
      Quick
      Standard
      High stakes

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Force a product-first discussion before any code gets written for a new feature

VIBE 2

Get a written design review automatically for changes touching money or permissions

VIBE 3

Have technical jargon explained in plain language during planning

VIBE 4

Separate self-verified testing from steps only the user can check

what's the stack?

Claude CodeMarkdown

how it stacks up fr

amarrey/product-first00kaku/gallery-slider-block04amanrajj/netwatch
Stars00
LanguageJavaScriptRust
Last pushed2021-05-19
MaintenanceDormant
Setup difficultyeasyeasymoderate
Complexity1/52/53/5
Audiencepm foundergeneralops devops

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · easy time til it works · 5min
Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

in plain english

product-first is a skill for Claude Code, meant for people who build software with the help of AI but think about their project in terms of products and systems rather than code. Most workflows for building a feature jump straight into implementation. This one insists on settling what you are building and why first, including who it is for, what job it does, what success looks like, and what is intentionally left out, before any technical decisions get made. The second thing it does differently is scale how much process a change gets based on how risky it is, not how large it looks. A small copy or visual tweak just gets built right away. A change that touches money, permissions, or the database gets a written design plan and an independent review before anything is built. So a big visual redesign can stay quick and lightweight, while a small change to how permissions work gets real scrutiny. Throughout the process, technical jargon is explained in plain language, and any real fork in the road is presented as a multiple choice question with a recommendation, so someone without an engineering background can still make informed product decisions. The skill defines three tiers of process, quick for cheaply reversible changes like UI or copy, standard for typical features which get a short design summary that is approved before building, and high stakes for anything involving money, permissions, database migrations, or messages to real users, which gets a written design document and independent review. The overall flow moves from a product brainstorm, to an engineering design phase, to a written summary covering the problem, the design, what is out of scope, risks, and what counts as done, then building, then a testing hand off that separates what was verified automatically from what only the user can check themselves. It installs by cloning the repository into a Claude Code skills folder, either personally or per project, and can be invoked directly or triggered automatically when describing a feature. It is released under the MIT license.

prompts (copy fr)

prompt 1
Install the product-first skill into my Claude Code skills folder and explain how to invoke it
prompt 2
Walk me through the three tiers in product-first and which one my next feature would fall into
prompt 3
Help me customize product-first's SKILL.md for my own project's deploy process and footguns
prompt 4
Explain how product-first's testing hand-off splits what was verified automatically from what I need to check myself

Frequently asked questions

what is product-first fr?

A Claude Code skill that makes AI-assisted building start from product thinking, scaling how much design rigor a change gets to how risky it is, not how big it looks.

What license does product-first use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is product-first to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is product-first for?

Mainly pm founder.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.