TechNomadCode/AI-Product-Development-Toolkit

Plan, build and launch products with AI: guided planning prompts, an AI App Starter for Next.js, Supabase and Vercel, and agent configurations.

994

85 commits

updated Sep 28, 2026

See the code

See what people are saying

SourceMessageScoreDate

CLAUDE.md for Sonnet 5.5 based on Anthropic's official platform docs. (their own coding benchmark scored max effort below xhigh) (r/ClaudeAI)

I previously shared CLAUDE.md files for Opus 5 and 5.5 after reading through Anthropic's docs. Sonnet 5.5 just came out, so I went through its [prompting guide](https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/prompting-claude-sonnet-5-5) and launch post the same way. Quick…

7

Sep 28, 2026

README

AI Product Development Toolkit

Plan, build and launch products with AI, without the mess.

MIT license Works with Claude Code Works with Codex (beta)

What it isUse it when
Planning promptsGuided prompts that interview you, then write your plan. Any AI chat.You have an idea and want a solid plan
AI App StarterA project your coding agent builds with you, step by step, up to launch.You want to build and launch a web app
Agent configurationsWorking instructions for Claude Code.You code with Claude Code every day

The planning prompts and the AI App Starter also install as skills for Claude Code and Codex, with one line.

Planning prompts

Most prompts tell the AI to write a document straight away, so it fills every gap with guesses. These prompts make it interview you first:

  • It asks before it writes. A few targeted questions at a time, about your idea, users and goals.
  • It checks what it understood. It states its assumptions and confirms them with you before moving on.
  • It drafts only once you agree. The document is built from your answers, not from guesses.
  • Each step feeds the next. Later prompts use your earlier documents, so the whole plan stays consistent.
StepPromptWhat you get
1. Research usersUser research questionnaireA questionnaire, then an evidence-based research summary for your PRD
2. Define the productPRD generationA product requirements document: goals, users, requirements and constraints
3. Map the experienceUX and user flowUser journeys, screens and interface requirements
4. Scope the first releaseMVP conceptThe core hypothesis, the problem to solve first and a short in/out feature list
5. Plan the buildMVP development plan or ultra-lean versionA full development plan, or a lean build spec for a fast first version
6. Plan testingTest planTest scope, cases and acceptance criteria

How to use them: open a prompt, fill in the bracketed placeholders, paste it into any AI chat and answer its questions. Start at any step; each folder's guide says what to bring. Most people start at step 2, the PRD prompt. Do step 1 first if you have potential users you can ask.

More: the prompt template guide, and why this approach works: How I Turn Ideas Into Products With AI Prompts.

AI App Starter

The AI App Starter turns your AI coding agent into a guide that builds a Next.js, Supabase and Vercel app with you, from idea to launch. You don't need to know the process: it leads, and you answer in plain words.

1. Open your agent in a new, empty folder.

You useHow
Claude Code, desktop appIn the Code tab, start a new session and choose the folder.
Claude Code, terminalRun claude in the folder.
CodexRun codex in the folder. When it asks to use the network for the download, approve it.

2. Paste this:

Set up this folder with the AI App Starter: clone https://github.com/TechNomadCode/AI-Product-Development-Toolkit with git clone --depth 1 into a temporary folder, then follow starters/nextjs-supabase-vercel/SETUP.md from it.

3. Just talk to it. Ask what's next?, then say continue or do X instead. Already made a PRD or MVP scope with the planning prompts? It asks for them and skips those interviews.

Why use it

  • It can't break production. It works only on your computer, with a local database and stand-in payment and email services. It never holds keys, not even test keys, and pushing and deploying are blocked.
  • It leads, in plain language. It asks only what the next piece of work needs, does every local step itself, and hands you one command or a few clicks for the rest.
  • It stays organized. One plan, one decisions file, one list of known issues. Separate local, staging and production environments exist from day one, and new ideas go into the plan instead of derailing the work.
  • It's honest about what's real. It checks current official docs before using a tool, says when a test used a stand-in, and never decides law, tax or pricing for you.
  • Risky work gets a second look. Payment and permission work gets an independent review, ideally by a second agent.

More: the starter guide, which walks through the five stages and what the agent does at each one, and why I made it: AI App Starter: A Custom Step-by-Step Process for Apps With Claude Code.

What you need

  • To start: Node.js, Git and Docker on your computer, and your coding agent. Setup is the heaviest step. If your agent lets you choose how hard the model thinks (an effort or reasoning setting), a higher level helps here, though low worked in testing.
  • Optional: Context7, a free docs tool for your agent. The agent checks current docs before using any tool or service; Context7 makes that faster and more reliable. Without it, the agent reads the official websites.
  • Later, when the app goes online: GitHub, Vercel and Supabase accounts. The agent tells you when. Free plans may not allow a commercial app, such as a shop; it checks the current plans for you.

Tested so far

Tested with Claude Code desktop, through the first working pieces of a web shop. The automatic checks passed on GitHub on the first push. Not tested yet: Codex, the hosted staging and production setup, and launch.

How it works under the hood

Setup copies this structure into your project:

your-project/
├── AGENTS.md              rules loaded every session (CLAUDE.md imports it for Claude Code)
├── docs/plan.md           the current stage, the next action, and the pieces of work
├── docs/decisions.md      the choices made, plus a Deferred list with due moments
├── docs/product/          your PRD, MVP scope and UX flow
├── KNOWN-ISSUES.md        open problems
├── .kit/stages/           one instruction file per stage, read only while it's current
├── .kit/modules/          payments, email and background jobs: questions, rules and tests
├── .kit/planning/         the PRD, UX and MVP interview prompts from this toolkit
├── .claude/settings.json  blocks pushing, deploying and hosted commands (Claude Code)
└── .codex/rules/          the same blocks for Codex
  • Session loop: the agent reads where things stand in docs/plan.md, loads only the current stage, does one step, saves, and updates the plan. At natural stopping points it suggests a fresh session, which picks up from the plan.
  • Safety by design, not by promise: no hosted credentials exist on your machine. An environment guard refuses to run against anything but the local database and stand-in services. Blocked commands are only a backstop.
  • Rules, not recipes: the kit states what must be true and how to check it. The agent looks up how today's tools do it and writes the chosen setup, with its sources, into the AGENTS.md of the folder it concerns. That folder's rules load only when the agent works there.
  • Pipeline: staging follows the main branch by itself. Production changes only when you start it. In both, the database is updated before the new code runs, and only the production domain can be indexed.
  • Questions on time: anything not needed yet goes on the Deferred list with a due moment. The agent checks that list before each stage and each piece of work.

Skills

Use Claude Code or Codex? You can install the planning prompts and the AI App Starter as skills, then you can run each one by name.

Install: paste this into Claude Code or Codex.

Install the AI Product Development Toolkit skills: clone https://github.com/TechNomadCode/AI-Product-Development-Toolkit with git clone --depth 1 into a temporary folder, then follow agent-skills/INSTALL.md from it.

The agent copies seven skills into your personal skills folder, so they work in every project. To update them, paste the same line again.

SkillRun it withWhat it does
User research/user-researchPlans a questionnaire, then turns the responses into input for your PRD
PRD/prdInterviews you, then drafts your product requirements
UX and user flows/uxMaps the screens and user flows from your PRD
MVP concept/mvpPicks the smallest first version worth building
MVP build plan/mvp-planPlans the build: a full plan or an ultra-lean spec
Test plan/test-planDrafts a test plan with scope and acceptance criteria
AI App Starter/nextjs-supabase-vercelSets up an empty folder with the AI App Starter

In Codex, type $ instead of /, for example $prd. Skills run only when you call them. Each planning skill runs its planning prompt unchanged and fills it from what you give it.

Agent configurations

Working instructions for Claude Code, based on Anthropic's documentation. Merge them into your own setup instead of replacing it.

ConfigWhat it does
Claude Sonnet 5.5 rules (latest)The Opus 5.5 file plus three short additions: no unrequested extras, stop after giving a plan, and run a real check before saying done.
Claude Opus 5.5 rulesA CLAUDE.md for clear scope, concise replies and up-to-date docs lookups. The lookups use Context7, a free docs tool; the guide shows how to add it.
Claude Opus 5 rulesThe same idea, written for Opus 5.

More: the agent configuration guide, and What Anthropic Says Has Improved in Opus 5.5.

Good to know

  • AI output is a draft. Review requirements, plans, and code before relying on them.
  • Don't paste private information your AI tool doesn't need.

Feedback and license

Found an unclear step? Open an issue with the template name and a small, non-sensitive example. If this helps you, star the repo to find it again.

I build these using official documentation, AI tools, and my own development work. For broader prompting techniques, see my Prompt Rulebook.

Free to use, adapt, and share under the MIT license.

agent
agentic-ai
agentic-workflow
agents
agent-skills
ai
claude-code
claude-desktop
documentation
mvp
opus-5
opus-5-5
permissions
prd
product
productivity
product-management
prompt-engineering
prompt-library
promptquick

Significant stargazers

Felipe Coury

240 followers · starred Jun 2025

Santiago Fraire Willemoes

117 followers · starred Aug 2025

Udit

54 followers · starred May 2025

Boris Bilich

2 followers · starred Jun 2025

TechNomadCode/AI-Product-Development-Toolkit

Plan, build and launch products with AI: guided planning prompts, an AI App Starter for Next.js, Supabase and Vercel, and agent configurations.

994

85 commits

updated Sep 28, 2026

See the code

See what people are saying

SourceMessageScoreDate

CLAUDE.md for Sonnet 5.5 based on Anthropic's official platform docs. (their own coding benchmark scored max effort below xhigh) (r/ClaudeAI)

I previously shared CLAUDE.md files for Opus 5 and 5.5 after reading through Anthropic's docs. Sonnet 5.5 just came out, so I went through its [prompting guide](https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/prompting-claude-sonnet-5-5) and launch post the same way. Quick…

7

Sep 28, 2026

README

AI Product Development Toolkit

Plan, build and launch products with AI, without the mess.

MIT license Works with Claude Code Works with Codex (beta)

What it isUse it when
Planning promptsGuided prompts that interview you, then write your plan. Any AI chat.You have an idea and want a solid plan
AI App StarterA project your coding agent builds with you, step by step, up to launch.You want to build and launch a web app
Agent configurationsWorking instructions for Claude Code.You code with Claude Code every day

The planning prompts and the AI App Starter also install as skills for Claude Code and Codex, with one line.

Planning prompts

Most prompts tell the AI to write a document straight away, so it fills every gap with guesses. These prompts make it interview you first:

  • It asks before it writes. A few targeted questions at a time, about your idea, users and goals.
  • It checks what it understood. It states its assumptions and confirms them with you before moving on.
  • It drafts only once you agree. The document is built from your answers, not from guesses.
  • Each step feeds the next. Later prompts use your earlier documents, so the whole plan stays consistent.
StepPromptWhat you get
1. Research usersUser research questionnaireA questionnaire, then an evidence-based research summary for your PRD
2. Define the productPRD generationA product requirements document: goals, users, requirements and constraints
3. Map the experienceUX and user flowUser journeys, screens and interface requirements
4. Scope the first releaseMVP conceptThe core hypothesis, the problem to solve first and a short in/out feature list
5. Plan the buildMVP development plan or ultra-lean versionA full development plan, or a lean build spec for a fast first version
6. Plan testingTest planTest scope, cases and acceptance criteria

How to use them: open a prompt, fill in the bracketed placeholders, paste it into any AI chat and answer its questions. Start at any step; each folder's guide says what to bring. Most people start at step 2, the PRD prompt. Do step 1 first if you have potential users you can ask.

More: the prompt template guide, and why this approach works: How I Turn Ideas Into Products With AI Prompts.

AI App Starter

The AI App Starter turns your AI coding agent into a guide that builds a Next.js, Supabase and Vercel app with you, from idea to launch. You don't need to know the process: it leads, and you answer in plain words.

1. Open your agent in a new, empty folder.

You useHow
Claude Code, desktop appIn the Code tab, start a new session and choose the folder.
Claude Code, terminalRun claude in the folder.
CodexRun codex in the folder. When it asks to use the network for the download, approve it.

2. Paste this:

Set up this folder with the AI App Starter: clone https://github.com/TechNomadCode/AI-Product-Development-Toolkit with git clone --depth 1 into a temporary folder, then follow starters/nextjs-supabase-vercel/SETUP.md from it.

3. Just talk to it. Ask what's next?, then say continue or do X instead. Already made a PRD or MVP scope with the planning prompts? It asks for them and skips those interviews.

Why use it

  • It can't break production. It works only on your computer, with a local database and stand-in payment and email services. It never holds keys, not even test keys, and pushing and deploying are blocked.
  • It leads, in plain language. It asks only what the next piece of work needs, does every local step itself, and hands you one command or a few clicks for the rest.
  • It stays organized. One plan, one decisions file, one list of known issues. Separate local, staging and production environments exist from day one, and new ideas go into the plan instead of derailing the work.
  • It's honest about what's real. It checks current official docs before using a tool, says when a test used a stand-in, and never decides law, tax or pricing for you.
  • Risky work gets a second look. Payment and permission work gets an independent review, ideally by a second agent.

More: the starter guide, which walks through the five stages and what the agent does at each one, and why I made it: AI App Starter: A Custom Step-by-Step Process for Apps With Claude Code.

What you need

  • To start: Node.js, Git and Docker on your computer, and your coding agent. Setup is the heaviest step. If your agent lets you choose how hard the model thinks (an effort or reasoning setting), a higher level helps here, though low worked in testing.
  • Optional: Context7, a free docs tool for your agent. The agent checks current docs before using any tool or service; Context7 makes that faster and more reliable. Without it, the agent reads the official websites.
  • Later, when the app goes online: GitHub, Vercel and Supabase accounts. The agent tells you when. Free plans may not allow a commercial app, such as a shop; it checks the current plans for you.

Tested so far

Tested with Claude Code desktop, through the first working pieces of a web shop. The automatic checks passed on GitHub on the first push. Not tested yet: Codex, the hosted staging and production setup, and launch.

How it works under the hood

Setup copies this structure into your project:

your-project/
├── AGENTS.md              rules loaded every session (CLAUDE.md imports it for Claude Code)
├── docs/plan.md           the current stage, the next action, and the pieces of work
├── docs/decisions.md      the choices made, plus a Deferred list with due moments
├── docs/product/          your PRD, MVP scope and UX flow
├── KNOWN-ISSUES.md        open problems
├── .kit/stages/           one instruction file per stage, read only while it's current
├── .kit/modules/          payments, email and background jobs: questions, rules and tests
├── .kit/planning/         the PRD, UX and MVP interview prompts from this toolkit
├── .claude/settings.json  blocks pushing, deploying and hosted commands (Claude Code)
└── .codex/rules/          the same blocks for Codex
  • Session loop: the agent reads where things stand in docs/plan.md, loads only the current stage, does one step, saves, and updates the plan. At natural stopping points it suggests a fresh session, which picks up from the plan.
  • Safety by design, not by promise: no hosted credentials exist on your machine. An environment guard refuses to run against anything but the local database and stand-in services. Blocked commands are only a backstop.
  • Rules, not recipes: the kit states what must be true and how to check it. The agent looks up how today's tools do it and writes the chosen setup, with its sources, into the AGENTS.md of the folder it concerns. That folder's rules load only when the agent works there.
  • Pipeline: staging follows the main branch by itself. Production changes only when you start it. In both, the database is updated before the new code runs, and only the production domain can be indexed.
  • Questions on time: anything not needed yet goes on the Deferred list with a due moment. The agent checks that list before each stage and each piece of work.

Skills

Use Claude Code or Codex? You can install the planning prompts and the AI App Starter as skills, then you can run each one by name.

Install: paste this into Claude Code or Codex.

Install the AI Product Development Toolkit skills: clone https://github.com/TechNomadCode/AI-Product-Development-Toolkit with git clone --depth 1 into a temporary folder, then follow agent-skills/INSTALL.md from it.

The agent copies seven skills into your personal skills folder, so they work in every project. To update them, paste the same line again.

SkillRun it withWhat it does
User research/user-researchPlans a questionnaire, then turns the responses into input for your PRD
PRD/prdInterviews you, then drafts your product requirements
UX and user flows/uxMaps the screens and user flows from your PRD
MVP concept/mvpPicks the smallest first version worth building
MVP build plan/mvp-planPlans the build: a full plan or an ultra-lean spec
Test plan/test-planDrafts a test plan with scope and acceptance criteria
AI App Starter/nextjs-supabase-vercelSets up an empty folder with the AI App Starter

In Codex, type $ instead of /, for example $prd. Skills run only when you call them. Each planning skill runs its planning prompt unchanged and fills it from what you give it.

Agent configurations

Working instructions for Claude Code, based on Anthropic's documentation. Merge them into your own setup instead of replacing it.

ConfigWhat it does
Claude Sonnet 5.5 rules (latest)The Opus 5.5 file plus three short additions: no unrequested extras, stop after giving a plan, and run a real check before saying done.
Claude Opus 5.5 rulesA CLAUDE.md for clear scope, concise replies and up-to-date docs lookups. The lookups use Context7, a free docs tool; the guide shows how to add it.
Claude Opus 5 rulesThe same idea, written for Opus 5.

More: the agent configuration guide, and What Anthropic Says Has Improved in Opus 5.5.

Good to know

  • AI output is a draft. Review requirements, plans, and code before relying on them.
  • Don't paste private information your AI tool doesn't need.

Feedback and license

Found an unclear step? Open an issue with the template name and a small, non-sensitive example. If this helps you, star the repo to find it again.

I build these using official documentation, AI tools, and my own development work. For broader prompting techniques, see my Prompt Rulebook.

Free to use, adapt, and share under the MIT license.

agent
agentic-ai
agentic-workflow
agents
agent-skills
ai
claude-code
claude-desktop
documentation
mvp
opus-5
opus-5-5
permissions
prd
product
productivity
product-management
prompt-engineering
prompt-library
promptquick

Significant stargazers

Felipe Coury

240 followers · starred Jun 2025

Santiago Fraire Willemoes

117 followers · starred Aug 2025

Udit

54 followers · starred May 2025

Boris Bilich

2 followers · starred Jun 2025