{ "schema": "aiblocks-page/1", "id": "agency-product-dx-engineer", "type": "agent", "name": "Developer experience reviewer", "summary": "Get a developer onboarding friction report. See the steps where new developers get stuck, rewritten error messages and fixes ranked by effort.", "headline": "Developer experience reviewer", "subhead": "Paste your getting-started guide, sample code and common error messages. It walks the path as a new developer would, lists each place they get stuck with a fix, rewrites weak error messages, and says what to measure.", "job": { "id": "build-product", "name": "Build a product people want" }, "level": "intermediate", "thinking": "high", "tested": true, "updated": "2026-11-03", "first_published": "2026-10-26", "inputs": [ { "type": "document", "required": true, "label": "Document", "what": "a finished document, such as a Word file, a PDF or a page of notes" }, { "type": "codebase", "required": false, "label": "Codebase", "what": "a project's code, in a folder or repo the AI can open" }, { "type": "voc_reviews", "required": false, "label": "Voc reviews", "what": "customer words from reviews, tickets, surveys or calls, with source and date" } ], "outputs": [ { "type": "audit_report", "required": true, "label": "Audit report", "what": "findings with evidence, severity, missing inputs and next actions" }, { "type": "copy_draft", "required": true, "label": "Copy draft", "what": "a draft of any copy (ad, page, email or script) that a check or edit pass works on" } ], "you_give": [ "Your getting-started guide or onboarding steps, pasted or linked", "Your sample code and SDK method names or signatures", "The error messages new developers see most, with the status codes", "Support tickets, forum posts or GitHub issues from new developers (optional)", "Numbers you track now, such as time to first call (optional)" ], "you_get": [ "A ranked friction report with where, what goes wrong, a fix, effort and impact for each item", "Rewritten error messages that say what happened, why and what to do next", "Notes on sample code and method names that hide the correct use", "A first 30 minutes path for a new developer, with the shortest route to a real result", "A plan to measure the change, with what to record before you start", "A way to sort support tickets into feedback for the right team" ], "use_when": [ "New developers sign up for your API or SDK and few of them make a first working call.", "Your support inbox is full of the same setup questions.", "Your error messages say \"invalid input\" or \"401\" and nothing else.", "You are about to launch a new SDK or docs site and want a fresh read first." ], "skip_when": [ "You have no docs, SDK or API yet. Use the Product requirements writer first to plan it.", "You only want a few error messages rewritten. Use the Error message rewriter.", "You want a plan to cut the time to a first API call from a sign-up path. Use the API first-call experience reviewer.", "You want a guide for new teammates joining a codebase. Use the Codebase onboarding guide writer.", "You want proof from real developers. Watch five or more people try the guide and take notes. This agent reads, it does not observe." ], "output_sample": { "input": [ "Your getting-started guide and sample code", "Your most common error messages", "Support tickets or issues from new developers (optional)", "Numbers you track now, such as time to first call (optional)" ], "prerequisites": [ "An AI you can paste a long brief into, such as Claude, ChatGPT or Gemini", "A fresh account or clean machine, so you can test each fix yourself" ], "output": [ { "name": "First 30 minutes path", "contains": "Each step from first visit to a working call, marking steps that need setup before any result." }, { "name": "Friction report", "contains": "Ranked problems, each with where it happens, a fix, the effort and the expected effect." }, { "name": "Error message rewrites", "contains": "Each weak error rewritten to say what happened, why and what to do next." }, { "name": "Sample code and method notes", "contains": "Where the correct way to use a method is unclear, and how to make it obvious." }, { "name": "Feedback sorting", "contains": "Support ticket themes sorted to the team that can fix each one." }, { "name": "Measuring plan", "contains": "The numbers to record before and after, and how to record them." } ] }, "output_shape": "BRIEF AND ASSUMPTIONS\n | evidence seen: | ASSUMED: | MISSING: \n\nFIRST 30 MINUTES PATH\n | needs before result: | friction: \n\nFRICTION REPORT (ranked)\n | | severity <blocking, high, medium or low> | where <step> | what goes wrong <observation from the pasted material> | fix <change> | effort <low, medium or high> | impact <expected effect>\n\nERROR MESSAGE REWRITES\n <before> -> <after: what happened, why, what to do next> | link: <doc, if given>\n\nSAMPLE CODE AND METHOD NOTES\n <method or sample> | issue <hidden required field, no failure example> | fix <change>\n\nFEEDBACK SORTING\n <ticket theme> | goes to <team> | priority <level>\n\nMEASURING PLAN\n <metric> | baseline <value or MISSING> | how to record it | target <set by you>\n\nOPEN QUESTIONS AND CHECKS STILL NEEDED\n <item> | <how to settle it, such as test with a new developer>", "how_to_use": [ "Download the pack from this page and add it to your AI as a skill. Or paste SKILL.md into a new chat, then paste references/source-agent.md after it.", "Paste your getting-started guide, a few code samples and your most common error messages. Add support tickets if you have them.", "Your AI asks once for anything missing. Anything still unknown is marked as an assumption you can change.", "Read the top friction items first. Check each against the real product, since the AI has only seen what you pasted.", "Ship the error message rewrites and the small doc fixes first. Test each one yourself in a fresh account or a clean machine.", "Record the baseline numbers before you change anything, then watch new developers or your analytics to see if the fixes help." ], "checks": [ "The result addresses your actual task and cites the evidence used.", "Examples, role-play experience and targets are kept separate from verified results.", "Claims of tests, memory, tool access or completed actions match what actually happened." ], "next": [ { "name": "First-use onboarding designer", "url": "https://useaiblocks.com/skills/first-use-onboarding-designer", "why": "Shape the product" } ], "source": { "by": "Michael Sitarzewski and Agency Agents contributors", "repo": "msitarzewski/agency-agents", "url": "https://github.com/msitarzewski/agency-agents/blob/b37b5bb33b78f2c1d6567d98e25ca818e3259219/product/product-dx-engineer.md", "licence": "MIT", "original_name": "DX Engineer", "commit": "b37b5bb33b78f2c1d6567d98e25ca818e3259219" }, "credits": [ { "title": "DX Engineer", "by": "Michael Sitarzewski and Agency Agents contributors", "url": "https://github.com/msitarzewski/agency-agents/blob/b37b5bb33b78f2c1d6567d98e25ca818e3259219/product/product-dx-engineer.md", "used": "Original agent profile, preserved in references/source-agent.md; AI Blocks adds setup and review instructions." } ], "files": [ "LICENSE", "references/source-agent.md", "SETUP.md", "source.json" ], "links": { "page": "https://useaiblocks.com/agents/agency-product-dx-engineer", "markdown": "https://useaiblocks.com/agents/agency-product-dx-engineer.md", "json": "https://useaiblocks.com/agents/agency-product-dx-engineer.json", "instructions": "https://useaiblocks.com/skills/agency-product-dx-engineer/SKILL.md", "download": "https://useaiblocks.com/skills/agency-product-dx-engineer.zip", "api_item": "https://useaiblocks.com/api/v1/items/agency-product-dx-engineer", "api_document": "https://useaiblocks.com/api/v1/documents/agent/agency-product-dx-engineer", "mcp": "https://useaiblocks.com/mcp" } }