diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index bd8b443..8cd534c 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -23,6 +23,18 @@ Consider a prompt you frequently use in your day-to-day work as a ServiceNow pro For inspiration, you can view the top-voted prompts in the library [here](https://communityresources.service-now.com/ai?id=library&display=10&sort=true). +### Use the RISEN Framework 🧠 + +For the best results, structure your prompts using the **RISEN framework**: + +- **Role** – Set the AI's expert persona +- **Instructions** – State clearly what you want +- **Steps** – List sequential actions for the AI to follow +- **End Goal** – Define the desired output +- **Narrowing** – Add constraints to keep the response focused + +Prompts following RISEN tend to get more upvotes in the library. 👍 + ### 2. Submit a Prompt 📥 To submit your prompt, follow these steps: diff --git a/README.md b/README.md index 915b26d..37f4d21 100644 --- a/README.md +++ b/README.md @@ -8,6 +8,26 @@ This repository is an entry point to submit prompts directly from this GitHub repo, so that they can appear at https://devlink.sn/PromptLibrary The Prompt Library itself, is a community-driven hub for ServiceNow professionals to gather Generative AI prompts that we use to make our lives easier. **This is not a Now Assist product**. These are prompts we use inside GenAi Service Providers like ChatGPT, Claude Anthropic, or Google Gemini. +## ✍️ Prompt Frameworks + +When writing prompts for this library, we recommend using the **RISEN framework** for clear, effective results. + +| Component | Description | +|-----------|-------------| +| **R**ole | Define the AI's persona (e.g., "You are a ServiceNow ITSM architect") | +| **I**nstructions | Describe what the AI should do | +| **S**teps | Break the task into sequential steps | +| **E**nd Goal | State the desired outcome or deliverable | +| **N**arrowing | Set constraints — what to exclude, avoid, or limit | + +**Example:** +``` +Role: You are a ServiceNow platform architect. +Instructions: Review this Business Rule for performance issues. +Steps: 1. Check for missing query filters. 2. Flag hardcoded sys_ids. 3. Identify sync operations that could be async. +End Goal: A prioritized list of fixes with one-line explanations. +Narrowing: Server-side performance only. No UI or client-script suggestions. +``` 🔔🔔🔔
Note, this repository _can_ be installed on your ServiceNow instance but contributions to this repository are for **Prompt Submission only**.