UX: AI Prompts: Improve UX around initial setup
>>> [!note] Migrated issue <!-- Drupal.org comment --> <!-- Migrated from issue #3567796. --> Reported by: [robloach](https://www.drupal.org/user/61114) Related to !1208 >>> <p>[Tracker]<br> <strong>Update Summary: </strong>Improve UX around AI Prompts<br> <strong>Short Description: </strong>Improve UX around AI Prompts<br> <strong>Check-in Date: </strong>01/15/2026<br> <em>Metadata is used by the <a href="https://www.drupalstarforge.ai/" title="AI Tracker">AI Tracker.</a> Docs and additional fields <a href="https://www.drupalstarforge.ai/ai-dashboard/docs" title="AI Issue Tracker Documentation">here</a>.</em><br> [/Tracker]</p> <h3 id="summary-problem-motivation">Problem/Motivation</h3> <p>When you initially set up the AI Prompts at <em>admin/config/ai/prompts</em>, you're presented with...</p> <blockquote><p>There are no AI Prompts yet.</p></blockquote> <p>When you click the "Add Prompt" button, you're presented with the following text...</p> <blockquote><p>No AI Prompt Types exist. These are normally provided by modules within the AI Ecosystem; however, you can also create your own for use in your own project implementations. <strong>Manage Prompt Types</strong></p></blockquote> <p>When you click the "Manage Prompt Types" button, you're brought to another screen that says...</p> <blockquote><p>There are no AI Prompt types yet.</p></blockquote> <p>Finally, you're able to click the "Add AI Prompt Type" button. This is 3 or 4 different clicks blocking the user from being able to add their first AI Prompt.</p> <p><img src="https://www.drupal.org/files/issues/2026-01-15/Screenshot%20from%202026-01-15%2012-58-40.png" alt="UI of the AI Prompts screen"></p> <p><img src="https://www.drupal.org/files/issues/2026-01-15/Screenshot%20from%202026-01-15%2012-59-24.png" alt="Add AI Prompt without types"></p> <h4 id="summary-steps-reproduce">Steps to reproduce (required for bugs, but not feature requests)</h4> <ol> <li>Install the AI Module</li> <li>Visit the AI Prompts screen at <em>admin/config/ai/prompts</em></li> <li>Try to add your first AI Prompt, and it takes about 4 clicks to get to be able to add the first prompt. Optimally, it should take them straight to add their first type.</li> </ol> <h3 id="summary-proposed-resolution">Proposed resolution</h3> <p>Clean up the user experience so that it's more straight forward into what you need to do first. Some ideas...</p> <ul> <li>Use Tabs instead of Local Action buttons to switch between AI Prompts and AI Prompt Types</li> <li>When the user visits the AI Prompts screen when there are no Prompt Types, direct them to add their first prompt type directly</li> <li>Add some help text to describe what a AI Prompt and AI Prompt Text is</li> </ul> <h3 id="summary-remaining-tasks">Remaining tasks</h3> <ol> <li>Determine which user experience enhancement we'll bring in</li> <li>Do it</li> <li>Review with <code>Needs UX review</code></li> </ol> <h3>Optional: Other details as applicable (e.g., User interface changes, API changes, Data model changes)</h3> <p>Exclusively user interface changes.</p>
issue