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