# Ai-assisted-job-descriptions



# Universal Pattern for AI-Assisted Job Descriptions

> This guide standardizes the user experience for implementing and using the AI job description generation feature within the ATS, accommodating product-specific components. The pattern is tailored for two main user groups: Admin Users and Recruiters (regular ATS users).

## Flow overview

**Admin Flow**: Guide Admins from the promotion banner to feature settings.  

![·](ai-feature-pattern/admin-flow.svg)

**Recruiter Flow**: Guide Recruiters from generating a job ad for the first time to providing AI consent. Ensure AI consent settings are always accessible in user profile settings.

![·](ai-feature-pattern/recruiter-flow.svg)

## 1. Feature Promotion for Admins

![·](ai-feature-pattern/home-view.svg)

### Banner Display
- **Purpose**: Use the AI feature banner to promote the job description generation tool to eligible Admin users.
- **Visibility**: Display only to Admin Users on the **Main Home View** if the AI feature is not yet enabled.
- **Banner Action**: Link the banner to the **AI Feature Section** on the **Settings Page**, where the Admin can enable the AI feature for the entire organization.

### Post-Enablement Behavior
- Remove the promotion banner from the **Main Home View** once the feature is enabled to avoid redundant prompts.

### Additional Considerations
- **User Experience**: Ensure Admin users clearly understand the feature trial and its functions.
- **Placement**: Position the promotion prominently within the application, ideally on the dashboard or settings page.
- **Promotion Design**: 
  - Use the **AppPromotion** component for consistent styling and behavior.
  - Display an appealing message about the feature and the trial.
  - Include a clear CTA directing Admin users to the settings page to activate the feature.

## 2. Enabling AI Access for Recruiters

![·](ai-feature-pattern/feature-settings.svg)

### Admin's Role in Feature Enablement
- Limit AI feature enablement to Admin Users only.
- Place controls for activating the AI tool in the **AI Feature Section** on the **Settings Page**.

### Result of Enabling AI Feature
- Provide Recruiters access to the AI feature in the **Job Post Settings** section within their regular job posting workflow.

### Additional Considerations
- **Settings Messaging**: Provide clear information regarding the feature, trial duration, and limitations.
- **Trial Expiry**: Explain what happens when the trial expires and how users can continue using the feature.
- **Activation Control**: 
  - Set the activation control (e.g., toggle, checkbox, button) to "off" by default.
  - Ensure the control remains "off" when the feature is inactive.
  - Hide the promotion banner once the feature is active.


## 3. Access and consent flow for recruiters

![·](ai-feature-pattern/job-add.svg)

### Recruiter Access

- **Feature Location**: Place the AI feature within the **Job Post View** under **Job Post Settings** once enabled.

### Consent Requirement

![·](ai-feature-pattern/concent-modal.svg)

- **First-Time Consent**:
  - Prompt Recruiters to provide AI consent the first time they use the feature.
  - **Consent Modal**: Trigger a modal with consent information and options when the Recruiter clicks the AI feature button.
  - Require Recruiters to agree to AI use before generating any job description text.

### Persistent Consent Setting

![·](ai-feature-pattern/concent-settings.svg)

- Make the **AI Consent Setting** accessible in **Profile Settings** once consent is provided.
- Allow each recruiter to review or revoke consent at any time, as this is a **personal setting**.

## Design and Component Guidelines

### Universal Flow and Product-Specific Components
- **Feature Banner Component**: Use the **Grade Product Design System** for consistent styling and behavior.
- **Product-Specific Views**: Ensure that other components and UI views integrate seamlessly with this universal AI feature pattern, even if they vary by product.

### Supported Features
- Adapt the universal flow to various product implementations, allowing teams to integrate the AI feature into existing workflows while ensuring a consistent user experience.


## User Interface Summary

<Markdown>
{`
| **User Type**   | **Initial Access Location**  | **Post-Enablement Access Location**  | **Consent Requirement**                   | **Consent Setting Access**           |
|-----------------|------------------------------|--------------------------------------|-------------------------------------------|---------------------------------------|
| **Admin User**  | Main Home View (Banner)      | Settings Page (AI Feature Section)   | None (Admin enables feature for all)      | N/A                                   |
| **Recruiter**   | N/A                          | Job Post View (Job Post Settings)    | First use only (per user, via modal)      | Accessible in User Profile Settings   |
`}
</Markdown>