Prompting Advice

Devin needs guidance on what your preferences are and how to check if it’s on the right track. If not specified, Devin will make its own judgment calls. We recommend following a simple structure in your prompts to make sure Devin stays on track and checks its own work:

What: describe the task you want Devin to complete
How: describe some do’s and don’t’s for Devin when completing the task (e.g. deploy using Modal, etc.)
Result: describe the expected results or behaviors Devin should test for so Devin knows when the task is complete

Prompt Library

Try in Devin

Clone the repository from https://github.com/onblog/SnowJena, specifically the snowjena-ticket-server application, and set it up locally. 
First, ensure the snowjena-ticket-server application builds and runs successfully with the current setup. You don’t need to worry about other applications in the repository. 
Next, upgrade the Spring Boot version to 3.3.2 in the snowjena-ticket-server application, making only the necessary changes related to this version upgrade. 
After the upgrade, test the snowjena-ticket-server application to confirm it still builds and runs correctly. 
You don't need to push code. Instead, share a zipped folder. 
Also share a screenshot of the application running successfully in your browser.

Try in Devin

Use this (https://github.com/muan/unicode-emoji-json) to write a function that converts a string like https://www.gstatic.com/android/keyboard/emojikitchen/20201001/u1f600/u1f600_u2615.png to "grinning_face_warm_beverage" by extracting the 2 emojis (u1f600, u2615) and converting them to actual emojis (use python for this) and then looking them up in the dictionary provided by the unicode emoji json library I linked. 
Throw an error if the emoji isn't found, including the codepoint in the error message. 
Then run the function on https://gist.githubusercontent.com/ryanseddon/0925ba915d4f865228ee3e6e0ddbe52c/raw/aa5cc2dbab3a9f3eaa1dc5d22dc1dc88d184dc4f/urls.txt and output a csv of the results.
Remember to use a csv writer library like pandas.

Try in Devin

Can you get https://github.com/markedjs/marked set up, use the command line tool with the --output/-o flag, then add a unit test to test the --output flag? 
There should already be similar tests in bin.test.js that you can add to.

Try in Devin

## Overview    
This playbook guides you through the process of creating an architectural diagram of a public GitHub repository or any source code using [C4-PlantUML](https://github.com/plantuml-stdlib/C4-PlantUML)

## What’s Needed From User
1. Provide link to your desired public github repository or a zip file containing your source code
2. Provide instructions if you want the architecture diagram to be customized

## Procedure
1. Install dependencies
    - Ensure that Java runtime is installed in your system
    - Install Graphviz using `sudo apt install graphviz`
2. Download PlantUML from the browser
    - Navigate to [https://plantuml.com/download](https://plantuml.com/download) in your browser and download [PlantUML](https://github.com/plantuml/plantuml/releases/download/v1.2024.5/plantuml-1.2024.5.jar)
    - Ensure that it is included in your PATH
3. Extract the source code (if zip file is provided)
- Download the zip file provided by the user directly to the current working directory
- Extract the source code from the zip file using `unzip <file_name.zip>` 
4. Setup the GitHub repository (if provided)
    - Clone the GitHub repository provided by the user
    - Navigate to the correct directory
5. Analyze the functionality of different components in the app carefully
    - Analyze the app directory
    - Understand the functionality of each component in the app very carefully
6. Generate the `.puml` file
    - Keep `Person` element outside `System_Boundary`
    - Make sure to add all the essential components and their relevant details in the diagram
    - Refer to [https://github.com/plantuml-stdlib/C4-PlantUML/blob/master/README.md](https://github.com/plantuml-stdlib/C4-PlantUML/blob/master/README.md) for detailed instructions
    - Include the following in the `.puml` file after `@startuml`:
    !include  https://raw.githubusercontent.com/plantuml-stdlib/C4-PlantUML/master/C4_Container.puml
    !include https://raw.githubusercontent.com/plantuml-stdlib/C4-PlantUML/master/C4_Component.puml
7. Generate the architecture diagram
    - Generate the architecture diagram from the `.puml` file
    - Make sure that the command is run without errors
8. Share the final deliverables
    - Share the architecture diagram with the user as an attachment

## Deliverables
1. The architecture diagram of the GitHub repository or the source code

## Advice and Pointers
1. Ensure that the diagram is clear and easy to understand

Try in Devin

## Overview
The task is to order items, such as food, on DoorDash. You should access your DoorDash account, search the requested restaurant or item to order, select the items for the order, and confirm the order with the user who started the session.

## Procedure
1. Go to doordash.com 
2. Search for the food or restaurant requested by the user
3. If the user requested to order food
	3.1 Select the 3 most highly rated options within the delivery radius
	3.2 Share the food options and name of the restaurant with the user
	3.3 Ask them to confirm their selection
4. If the user requested to order from a specific restaurant
	4.1 Select the restaurant closest to the default delivery location
	4.2 If the restaurant requested is not within the delivery zone of the default delivery address, let the user know and ask for an alternative restaurant 
5. Before ordering, check that the restaurant is open and delivers to the default delivery address on the DoorDash account
6. Select the item or items requested by the users
7. If the item(s) asks for additional required selections, share the options with the user and ask them to decide
8. If the item(s) offers optional add-ons, share a screenshot of those options with the user and ask them if they’d like to add anything else to their order
9. Add the order to cart once the user confirmed the selection
10. By default, select a 20% tip
11. Go to cart and request confirmation on the ordered items, total price and delivery address from the user
12. Once the user confirms the price, order and address, complete the order
13. Once ordered, confirm the order has been placed with the user and share an estimated delivery time

## Specifications
- You must see the order confirmation page and have an estimated delivery time in order to complete the task

## Forbidden Actions
- You cannot complete the order without receiving explicit confirmation from the user
- You may not add items to the order that haven’t been requested by the user
- You may not modify or remove items from the order unless the user specifically requests it 

## Advice and Pointers
- You are already signed into your account on DoorDash (via cookies). If not, you can use the DoorDash cookies saved in Secrets.
- Do NOT ask clarifying questions until you perform at least one search for a relevant item.

Split complex tasks into simpler sub-tasks, across multiple sessions

As with any entry-level engineer, Devin is more likely to succeed if complex projects are broken down into clear sub-tasks.

We also recommend working with Devin across multiple separate sessions as Devin’s performance can sometimes degrade as the session gets longer. If this happens, consider using snapshots as a way to maintain the progress on Devin’s machine image in your new sessions.

Tell Devin how to check its progress

Devin works best when it can independently test or verify that it’s on the right track.

Give Devin checkpoints to verify its work before moving on, and specify how Devin should sanity check its progress. For example, if you ask Devin to find a dataset, make sure Devin finds the right one by specifying dataset characteristcs it should expect (e.g. there should be more than 500 rows).

Be clear and specific

Provide clear, detailed instructions and requirements for Devin. For example, try to:

Specify the key steps necessary to complete a task
Name specific repos, libraries, branches, etc you want Devin to work with

Nothing is “too obvious” for Devin, but it will do its best to clarify and ask questions along the way.

Use Playbooks

For repetitive or complex tasks, we suggest using and iterating on Playbooks. Playbooks are easily reusable and shareable prompts.

Provide references or examples

When available, link documentation or examples that are relevant for the task. If you don’t provide any resources, Devin may search for documentation independently.

Jump in!

Ask Devin questions and give Devin instructions while it’s working, just as you would with any other teammate!

Get Started

Learn about Devin

Onboard Devin

Collaborate with Devin

Working with Teams

Tutorials

Integrations

API Reference

Other

Troubleshooting

Prompt Library

Split complex tasks into simpler sub-tasks, across multiple sessions

Tell Devin how to check its progress

Be clear and specific

Use Playbooks

Provide references or examples

Jump in!

Get Started

Learn about Devin

Onboard Devin

Collaborate with Devin

Working with Teams

Tutorials

Integrations

API Reference

Other

Troubleshooting

​Prompt Library

​Split complex tasks into simpler sub-tasks, across multiple sessions

​Tell Devin how to check its progress

​Be clear and specific

​Use Playbooks

​Provide references or examples

​Jump in!

Prompt Library

Split complex tasks into simpler sub-tasks, across multiple sessions

Tell Devin how to check its progress

Be clear and specific

Use Playbooks

Provide references or examples

Jump in!