[{"data":1,"prerenderedAt":403},["ShallowReactive",2],{"docs-sections":3,"docs-page-\u002Fdocs":124},[4,9,13,17,21,25,30,34,38,42,46,50,54,58,62,66,71,75,79,83,88,92,96,100,104,108,112,116,120],{"path":5,"title":6,"description":7,"group":8},"\u002Fdocs","Introduction","pdd-kit brings Product-Driven Development to coding agents through a Git-tracked Product Model and an automatic verification loop.","Get started",{"path":10,"title":11,"description":12,"group":8},"\u002Fdocs\u002Finstallation","Installation","Install the pdd-kit skills into your coding agent at project or global scope.",{"path":14,"title":15,"description":16,"group":8},"\u002Fdocs\u002Ffrom-your-repo","From your repo","Map what an existing repository already does into a Product Model, review it, then check the code against it.",{"path":18,"title":19,"description":20,"group":8},"\u002Fdocs\u002Ffrom-an-idea","From an idea","Decide what a new product does, approve its Product Model, then ask your agent to implement it while verify checks each part.",{"path":22,"title":23,"description":24,"group":8},"\u002Fdocs\u002Ffrom-a-blueprint","From a Blueprint","Pull a reviewed Product Model for a common kind of product instead of starting blank, adapt it if needed, then ask your agent to implement it.",{"path":26,"title":27,"description":28,"group":29},"\u002Fdocs\u002Fproduct-model","Model overview","The Product Model in five minutes (what the product-model\u002F folder holds, what each resource type is for, and how to tell them apart).","Product Model",{"path":31,"title":32,"description":33,"group":29},"\u002Fdocs\u002Fproduct","Product","The one product a Product Model describes (its name, its promise, the languages it is delivered in, its known boundaries, and what it needs to be published as a Blueprint).",{"path":35,"title":36,"description":37,"group":29},"\u002Fdocs\u002Fentities","Entities","The things your product keeps or reasons about (orders, products, settings) and the people and systems that act on it, with what it knows about each and the States it moves through.",{"path":39,"title":40,"description":41,"group":29},"\u002Fdocs\u002Finterfaces","Interfaces","The web apps, mobile apps, CLIs, APIs and webhooks through which people and systems reach your product, the parts inside them, and the places where facts and abilities are met.",{"path":43,"title":44,"description":45,"group":29},"\u002Fdocs\u002Fdomains","Domains","Optional subject areas, such as ordering or billing, that follow the Product's own sections and group its Capabilities and Entities without owning them.",{"path":47,"title":48,"description":49,"group":29},"\u002Fdocs\u002Fcapabilities","Capabilities","The things your product lets someone do, where each is offered, and the Capability Scenarios that show each one working.",{"path":51,"title":52,"description":53,"group":29},"\u002Fdocs\u002Fjourneys","Journeys","Goals where your product carries a person from one Capability into the next, and the Journey Scenarios that walk each path.",{"path":55,"title":56,"description":57,"group":29},"\u002Fdocs\u002Fbusiness-rules","Business Rules","What must always hold in your product, and who may do what (constraints, derivations and permissions), each stated once with everything it applies to.",{"path":59,"title":60,"description":61,"group":29},"\u002Fdocs\u002Fvariations","Variations","Feature flags, settings, plan tiers, A\u002FB tests and API versions, when your product works in more than one supported way and something decides which way applies.",{"path":63,"title":64,"description":65,"group":29},"\u002Fdocs\u002Freferences","References","Point any resource at material kept outside the model (code, a PRD, a design, research), saying what it is and why it is attached.",{"path":67,"title":68,"description":69,"group":70},"\u002Fdocs\u002Fskills","Skills overview","Three self-contained skills cover adoption, intended product change, and automatic verification-to-resolution.","Skills",{"path":72,"title":73,"description":74,"group":70},"\u002Fdocs\u002Fskill-pdd-map","map","Create or expand a Product Model from the code you already have, without running it.",{"path":76,"title":77,"description":78,"group":70},"\u002Fdocs\u002Fskill-pdd-ideate","ideate","Explore or define intended behavior, then write only the exact Product Model change you approve.",{"path":80,"title":81,"description":82,"group":70},"\u002Fdocs\u002Fskill-pdd-verify","verify","Implement the Product Model in code, in phases, or check that the model and the code agree, and resolve every gap you approve until they do or something blocks.",{"path":84,"title":85,"description":86,"group":87},"\u002Fdocs\u002Fcli","CLI overview","Install skills, lint and view a Product Model locally, and move Blueprints between repositories with the pdd-kit CLI.","CLI",{"path":89,"title":90,"description":91,"group":87},"\u002Fdocs\u002Fcli-install","install","Install the bundled pdd-kit agent skills safely for selected AI harnesses and scopes.",{"path":93,"title":94,"description":95,"group":87},"\u002Fdocs\u002Fcli-update","update","Refresh only pdd-kit-managed skill installations in project or global scope.",{"path":97,"title":98,"description":99,"group":87},"\u002Fdocs\u002Fcli-lint","lint","Check that a Product Model is structurally sound (files, relationships, Steps, Rules and References) without claiming it matches the code.",{"path":101,"title":102,"description":103,"group":87},"\u002Fdocs\u002Fcli-view","view","Open a Product Model as a private local report, from your checkout or from a GitHub repository.",{"path":105,"title":106,"description":107,"group":87},"\u002Fdocs\u002Fcli-export","blueprint export","Compile a Product Model into a portable Product Report that can move safely between repositories.",{"path":109,"title":110,"description":111,"group":87},"\u002Fdocs\u002Fcli-open","blueprint open","Expand a local Product Report into a canonical Product Model.",{"path":113,"title":114,"description":115,"group":87},"\u002Fdocs\u002Fcli-list","blueprint list","List the published Blueprints you can pull.",{"path":117,"title":118,"description":119,"group":87},"\u002Fdocs\u002Fcli-pull","blueprint pull","Pull a published Blueprint into the current directory.",{"path":121,"title":122,"description":123,"group":87},"\u002Fdocs\u002Fcli-contribute","blueprint contribute","Open a pull request proposing your Product Model as a Blueprint.",{"id":125,"title":6,"body":126,"description":7,"extension":396,"group":8,"meta":397,"navigation":399,"order":318,"path":5,"seo":400,"stem":401,"__hash__":402},"docs\u002Fdocs\u002Findex.md",{"type":127,"value":128,"toc":388},"minimark",[129,134,152,155,160,163,223,230,234,237,250,253,289,297,300,304,307,330,337,346,350,364,368,384],[130,131,133],"h1",{"id":132},"pdd-kit-product-driven-development-for-coding-agents","pdd-kit: Product-Driven Development for coding agents",[135,136,137,138,142,143,147,148,151],"p",{},"pdd-kit is Product-Driven Development for coding agents. It keeps a\ndurable Product contract in ",[139,140,141],"code",{},"product-model\u002F",": what your product does, for whom,\nwhere, and under which rules, including where it works more than one way\n(",[144,145,60],"a",{"href":146},".\u002Fdocs\u002Fvariations",": feature flags, plan tiers, A\u002FB tests, API\nversions). The ",[144,149,27],{"href":150},".\u002Fdocs\u002Fproduct-model"," explains the folder in five\nminutes.",[135,153,154],{},"The Product Model says what the product is intended to do. It does not prescribe\nthe stack or replace your plan mode, SDD framework, coding agent, or tests.",[156,157,159],"h2",{"id":158},"what-the-model-covers-and-what-it-doesnt","What the model covers, and what it doesn't",[135,161,162],{},"The model keeps what any rebuild of your web app, CLI or API would have to\nkeep, and nothing a rebuild is free to change:",[164,165,166,179],"table",{},[167,168,169],"thead",{},[170,171,172,176],"tr",{},[173,174,175],"th",{},"In the model",[173,177,178],{},"Left to design",[180,181,182,191,199,207,215],"tbody",{},[170,183,184,188],{},[185,186,187],"td",{},"Who can reach each place",[185,189,190],{},"Colors, typography, copy",[170,192,193,196],{},[185,194,195],{},"What it shows and asks for",[185,197,198],{},"Components, layout, modals",[170,200,201,204],{},[185,202,203],{},"What can be done there",[185,205,206],{},"Tabs, wizards and menus",[170,208,209,212],{},[185,210,211],{},"Which rules apply",[185,213,214],{},"CLI syntax and flags",[170,216,217,220],{},[185,218,219],{},"What happens next",[185,221,222],{},"API style: CRUD or RPC",[135,224,225,226,229],{},"That is why ",[144,227,40],{"href":228},".\u002Fdocs\u002Finterfaces"," and their Screens are in it: a refund\noperators issue in an admin console is a different product from one shoppers\nrequest on the website.",[156,231,233],{"id":232},"the-development-loop","The development loop",[135,235,236],{},"Every product change runs the same loop:",[238,239,240],"development-loop",{},[241,242,248],"pre",{"className":243,"code":245,"language":246,"meta":247},[244],"language-text","ideate → implement ⇄ verify\n   ▲                     │\n   └──── next change ────┘\n\nimplement: your agent, your way, in phases\n","text","",[139,249,245],{"__ignoreMap":247},[135,251,252],{},"Ideate and verify with pdd-kit. Your own agent implements, your way.",[254,255,256,271,277],"ul",{},[257,258,259,263,264,270],"li",{},[260,261,262],"strong",{},"Ideate"," with ",[144,265,267],{"href":266},".\u002Fdocs\u002Fskill-pdd-ideate",[139,268,269],{},"\u002Fpdd-ideate",":\nDecide the next change and record it in the product model.",[257,272,273,276],{},[260,274,275],{},"Implement"," with your agent, your way: In phases, with plan mode, an SDD\ntool, or freestyle.",[257,278,279,263,282,288],{},[260,280,281],{},"Verify",[144,283,285],{"href":284},".\u002Fdocs\u002Fskill-pdd-verify",[139,286,287],{},"\u002Fpdd-verify",":\nCheck and improve the code and product model until they agree.",[135,290,291,292,296],{},"You don't have to name a skill. Ask your agent for a change, such as \"add\nguest checkout to the product\", and ideate decides it with you. Ask it to\nimplement the change, and verify plans the work in phases: your agent\nimplements each phase, and verify checks every part of it before the next\nstarts. You can also\n",[144,293,295],{"href":294},".\u002Fdocs\u002Fskill-pdd-verify#choose-the-pace","choose the pace",": one part at\na time, or everything in one go without phases. Ask your agent to check the\ncode against the model whenever you want to be sure, for example before a\nrelease.",[135,298,299],{},"Ideate changes the model only with your approval. Your agent changes the code\nand never the model. A product question that comes up while implementing comes\nback to you; it is never decided in code.",[156,301,303],{"id":302},"see-the-model-at-any-time","See the model at any time",[135,305,306],{},"At any point in the loop, open the model as a local report in your browser:",[241,308,312],{"className":309,"code":310,"language":311,"meta":247,"style":247},"language-bash shiki shiki-themes pdd-kit-brand-warm pdd-kit-brand-warm material-theme-palenight","npx @itai-gendler\u002Fpdd-kit view\n","bash",[139,313,314],{"__ignoreMap":247},[315,316,319,323,327],"span",{"class":317,"line":318},"line",1,[315,320,322],{"class":321},"sC-r1","npx",[315,324,326],{"class":325},"sPU0x"," @itai-gendler\u002Fpdd-kit",[315,328,329],{"class":325}," view\n",[135,331,332],{},[333,334],"img",{"alt":335,"src":336},"The local report open on a Blueprint's overview page",".\u002Fdocs\u002Fimages\u002Freport-overview.webp",[135,338,339,340,345],{},"It updates as the files change, so you can keep it open while you ideate,\nreview a change, or verify. See ",[144,341,343],{"href":342},".\u002Fdocs\u002Fcli-view",[139,344,102],{}," for the options.",[156,347,349],{"id":348},"what-pdd-kit-never-does","What pdd-kit never does",[254,351,352,355,361],{},[257,353,354],{},"Run your code to check it: the skills read it, they never execute it. While\nimplementing, your agent runs your tests the way it always does.",[257,356,357,358,360],{},"Write outside ",[139,359,141],{},", or edit your AGENTS.md, CLAUDE.md or README.",[257,362,363],{},"Commit for you.",[156,365,367],{"id":366},"next","Next",[254,369,370,376],{},[257,371,372,375],{},[144,373,11],{"href":374},".\u002Fdocs\u002Finstallation",": install the skills into your coding agent.",[257,377,378,380,381,383],{},[144,379,27],{"href":150},": the ",[139,382,141],{}," folder in five\nminutes.",[385,386,387],"style",{},"html pre.shiki code .sC-r1, html code.shiki .sC-r1{--shiki-light:#972600;--shiki-default:#972600;--shiki-dark:#FFCB6B}html pre.shiki code .sPU0x, html code.shiki .sPU0x{--shiki-light:#1D5700;--shiki-default:#1D5700;--shiki-dark:#C3E88D}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":247,"searchDepth":389,"depth":389,"links":390},2,[391,392,393,394,395],{"id":158,"depth":389,"text":159},{"id":232,"depth":389,"text":233},{"id":302,"depth":389,"text":303},{"id":348,"depth":389,"text":349},{"id":366,"depth":389,"text":367},"md",{"section":398},"open-source",true,{"title":6,"description":7},"docs\u002Findex","pZkLqNmCQB_yGBEE9MJli_EVQDWvxixfxXce54Bu1iA",1791840531130]