Promptivity is a collection of interactive games designed to help users practice giving crystal-clear instructions, mirroring how we must guide AI with explicit, unambiguous prompts. The games are built using React and are intended to be both educational and fun.
- About the Project
- Built With
- Getting Started
- Usage
- Game Modes
- Contributing
- License
- Contact
- Acknowledgments
- Screenshots
- Future Improvements
Promptivity aims to bridge the gap between human communication and AI prompting by providing a platform where users can practice crafting precise and effective instructions. Through engaging games, players learn the importance of clarity, context, and constraints when communicating with AI systems.
To get a local copy up and running, follow these steps.
Make sure you have the following installed:
-
Clone the repository:
git clone https://github.com/your-username/promptivity.git
-
Navigate to the project directory:
cd promptivity -
Install dependencies:
npm install
-
Start the development server:
npm start
-
Open the app in your browser:
Navigate to http://localhost:3000 to view the application.
Upon launching the application, you will be presented with the home screen where you can select from three different game modes.
Purpose:
To practice giving crystal-clear instructions, mirroring how we must guide AI with explicit, unambiguous prompts.
How to Play (2 players):
-
Roles:
- Player A: “Human” who knows the final structure (from the card).
- Player B: “Alien Worker” who must follow instructions literally but will “play dumb.”
-
Instructions:
- Player A describes step-by-step how to build the shape using Play-Doh.
- If any instruction is vague, Player B should misinterpret it.
-
Debrief:
- Discuss how you adapted your language.
- Relate to prompting AI: clarity and explicitness matter.
Purpose:
To learn how constraints affect communication, just as specific rules and limits shape AI prompts.
How to Play (2 or more players):
-
Setup:
- Player A draws one instruction card and three constraint cards.
-
Rules:
- Player A must follow the constraints while explaining the instruction.
- Player B (or the group) tries to guess the original instruction.
-
Debrief:
- Which constraints were hardest?
- Relate to AI prompting: complex requirements demand creative, structured instructions.
Purpose:
To highlight the importance of providing context and instructions for unfamiliar situations, similar to supplying AI with the necessary background.
How to Play (2 players):
-
Setup:
- Player A draws a scene card and a task card.
- Imagine Player A just arrived from that scene’s era/environment into our present.
-
Instructions:
- Player A must instruct Player B on how to carry out the task here and now.
- Include details (tools, steps) so Player B can document and act on it.
-
Debrief:
- Discuss how the unfamiliar setting forced more detailed explanations.
- Relate to AI: providing necessary context transforms vague prompts into actionable steps.
Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.
To contribute:
- Fork the Project
- Create your Feature Branch
git checkout -b feature/AmazingFeature
- Commit your Changes
git commit -m 'Add some AmazingFeature' - Push to the Branch
git push origin feature/AmazingFeature
- Open a Pull Request
Distributed under the MIT License. See LICENSE for more information.
David Szabo-Stuban - [email protected]
Project Link: https://github.com/ssdavidai/promptivity
- React
- Tailwind CSS
- React Router
- IBM Plex Mono Font
- Press Start 2P Font
- Unsplash (if images are used)
- Font Awesome (if icons are used)
- Create React App