whatisgithub

What is designer-led-agent-starter?

tantsiho/designer-led-agent-starter — explained in plain English

Analysis updated 2026-05-18

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

In one sentence

A bilingual workflow template that makes AI coding agents document product rules and ask clarifying questions before writing code for an MVP.

Mindmap

mindmap
  root((repo))
    What it does
      Product truth extraction
      PM style questions
      Source of truth docs
    Tech stack
      Markdown
      AGENTS.md
    Use cases
      MVP planning
      AI agent guardrails
      Living documentation
    Audience
      Designers
      PMs and founders

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 build with it?

USE CASE 1

Turn a messy product idea or long design draft into structured product rules before coding starts.

USE CASE 2

Give an AI coding agent PM-style clarifying questions to ask before implementation.

USE CASE 3

Keep a living set of source-of-truth docs updated throughout an MVP build.

What is it built with?

Markdown

How does it compare?

tantsiho/designer-led-agent-starter0marildo/imagoabdurrafey237/rag-chatbot
Stars333
LanguagePythonJupyter Notebook
Setup difficultyeasyeasymoderate
Complexity1/52/53/5
Audiencepm foundergeneralgeneral

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

How do you get it running?

Difficulty · easy Time to first run · 30min

No coding required to set up, requires choosing an English or Chinese doc track and following the doc-first workflow with your AI agent.

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

So what is it?

Designer-Led Agent Starter is a workflow template for product designers and non-engineers who want to use AI coding assistants to build a minimum viable product from rough design ideas. The core problem it solves is that AI coding agents tend to jump straight into writing code before they fully understand what the product is supposed to do, producing something that looks finished but is missing key logic, edge cases, or constraints. The template addresses this by giving the AI agent a structured set of source-of-truth documents to fill out before any coding begins. These cover product rules, user roles, feature flows, architecture decisions, environment differences between local and production, risk concerns, and acceptance criteria. The agent is instructed to read these docs, ask clarifying questions like a product manager, write discoveries back into the docs, and only then implement one capability at a time. Documentation is not a one-time setup step: every build pass may reveal missing rules or undefined states, and the agent keeps the source docs updated throughout. The template is bilingual, offered in English and Traditional Chinese, and requires no slash commands. You work with plain natural-language instructions. It includes eighteen numbered document types covering everything from raw design notes to a contradiction audit, plus an AGENTS.md file that sets the agent's operating rules. The project grew out of roughly three months of real product work on a creator platform called HAIBUNKA, which produced an 80,000 word design document, over 200 specification and audit files, and more than 500 implementation files, so the workflow reflects lessons from an actual build rather than a theoretical outline. This would be useful to product designers, PMs, or founders who want to build an MVP with AI assistance but lack an engineering background, and want a process that keeps the AI from getting ahead of the product definition. It is released under the MIT license.

Copy-paste prompts

Prompt 1
Help me set up the Designer-Led Agent Starter template for my new product idea.
Prompt 2
Read my raw design draft and extract product truth, roles, and rules before we build anything.
Prompt 3
Ask me PM-style clarifying questions about this feature before writing any code.
Prompt 4
Update the source-of-truth docs with what we just learned from this build pass.

Frequently asked questions

What is designer-led-agent-starter?

A bilingual workflow template that makes AI coding agents document product rules and ask clarifying questions before writing code for an MVP.

What license does designer-led-agent-starter use?

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

How hard is designer-led-agent-starter to set up?

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

Who is designer-led-agent-starter for?

Mainly pm founder.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.