{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["img"]},"type":"markdown"},"seo":{"title":"Project 64 - Test AI project generation prompts","llmstxt":{"hide":true,"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"project-64---test-ai-project-generation-prompts","__idx":0},"children":["Project 64 - Test AI project generation prompts"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"prompt-quality","__idx":1},"children":["Prompt quality"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Paste the exact custom prompts you used for all 3 projects.",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://app.cloud.redocly.com/org/testing_redocly/project/ai-generated-olx-hub?file=redocly.yaml&branchName=main"},"children":["Branding OLX"]}]}]},": Create a project based on the OLX developer docs. Use very similar branding and structure. The project should support ukrainian and english languages with ukrainian being a default one"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://app.cloud.redocly.com/org/testing_redocly/project/ai-generated-mercedes-benz?file=redocly.yaml&branchName=main"},"children":["Branding Mercedes"]}]}]},": Create a project based on Mercedes-Benz developer portal. Extract logo from the attached site. Please make sure you follow the exact branding of the developer portal"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://app.cloud.redocly.com/org/testing_redocly/project/ai-generated-redocly-testing-project-8?branchName=main&file=docs%2Fv1%2Fgetting-started.md"},"children":["Starter with versions"]}]}]},": Generate a minimum project that uses versioned markdown content"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Which prompt was easiest for the AI to interpret, and why? - Branding prompts."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Which prompt was too vague, too broad, or missing important context? - Starter with versions. AI probably has no knowledge about versions."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Which prompt details most clearly influenced the generated project? - Reference links, probably."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"output-quality","__idx":2},"children":["Output quality"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Did the generated project feel usable as a first draft? - yes"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Was the structure clear and appropriate for the intended audience? - ok as a starting point"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Was the generated content accurate, specific, and free of obvious filler? - seem to reflect the source link that we provided at the first glance - but only a couple of pages per generated project"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["What would you need to fix before sharing the project with someone else? - add more content, fix minor UI issues, fix translations for default language"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"feature-controls","__idx":3},"children":["Feature controls"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Did Add features feel predictable? - Yes"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Were feature suggestions relevant to the typed prompt? - Yes"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Did adding and removing features behave as expected? - No (More info in debried above)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Which features did you choose for each project?",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Localization"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["AI Assistance"]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"resource-controls","__idx":4},"children":["Resource controls"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Did Add resources clearly separate links, OpenAPI files, logos, images, and Markdown files? - Yes"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Did the generated output visibly reflect your uploaded resources and links? - Yes"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Did the OpenAPI file produce a useful API reference or API-focused structure? - Yes"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Did the brand challenge use the chosen brand color palette? - Overall yes but for one project the color of navbar was wrong"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"overall","__idx":5},"children":["Overall"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"what-made-you-smile","__idx":6},"children":["What made you smile?"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["How fast it becomes to create a website in comparison to do that manually"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"what-should-we-change-before-wider-rollout","__idx":7},"children":["What should we change before wider rollout?"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Localization functionallity was not translated text on the .tsx page (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["translations.yaml"]}," wasn't created for the default language)"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["\"@redocly/theme\": \"latest\" was added to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["package.json"]}," - not needed"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Add functionallity to edit the generated project after initial setup"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When the project is initially generated, the added files/links become hidden after clicking elsewhere."]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/focus.6c4b24f5238134f6ef15a0789ca7a8459545934da27786976440de0585b212df.9c1bb791.png","alt":"focus.png","framed":false,"withLightbox":true,"width":"","height":""},"children":[]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/no-focus.34a44e03ffb4a631052bcb4c071962d9df598f2e392b3bb2f7a547366c62df0b.9c1bb791.png","alt":"no focus.png","framed":false,"withLightbox":true,"width":"","height":""},"children":[]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Remove unnecessary functionality, such as rules, from the default-generated redocly.yaml file."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The feature selection changes randomly while you type the prompt. Even the features you have manually selected or removed can be randomly removed or added back."]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/project-ai-creation-random-features.6bdfd676a8c4439eb1abace696fddfcdba8877412e5472dd76a566247a166b80.4e2e9a94.gif","alt":"project-ai-creation-random-features.gif","framed":false,"withLightbox":true,"width":"","height":""},"children":[]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Link generated in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tsx"]}," file points to the file but it is invalid, the links on the React files should use slugs (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["<OutlineBtn as={Link} to=\"/apis/dynamic_wiring_diagram.yaml\">View API reference</OutlineBtn>"]}," -> ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/apis/dynamic_wiring_diagram"]},")"]}]}]}]},"headings":[{"value":"Project 64 - Test AI project generation prompts","id":"project-64---test-ai-project-generation-prompts","depth":1},{"value":"Prompt quality","id":"prompt-quality","depth":3},{"value":"Output quality","id":"output-quality","depth":3},{"value":"Feature controls","id":"feature-controls","depth":3},{"value":"Resource controls","id":"resource-controls","depth":3},{"value":"Overall","id":"overall","depth":2},{"value":"What made you smile?","id":"what-made-you-smile","depth":3},{"value":"What should we change before wider rollout?","id":"what-should-we-change-before-wider-rollout","depth":3}],"frontmatter":{"seo":{"title":"Project 64 - Test AI project generation prompts"}},"lastModified":"2026-07-01T10:38:37.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/debrief/archive/project-64","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}