Skip to content

Instantly share code, notes, and snippets.

@burkeholland
Created April 10, 2025 19:50
Show Gist options
  • Save burkeholland/24802296b5bfaaf7fb775c81cd626512 to your computer and use it in GitHub Desktop.
Save burkeholland/24802296b5bfaaf7fb775c81cd626512 to your computer and use it in GitHub Desktop.
TheUrlist PRD

Project Requirements Document: The Urlist Website

The following table outlines the detailed functional requirements of The Urlist website.

Requirement ID Description User Story Expected Behavior/Outcome
FR001 Creating a New URL List As a user, I want to be able to start a new, empty list so I can begin adding URLs. The system should provide a clear way for the user to initiate the creation of a new list, potentially presenting an empty list view or an "add new list" button.
FR002 Adding URLs to a List As a user, I want to be able to input or paste URLs into my list so I can compile the resources I want to share. The system should provide an input field or mechanism for users to enter URLs. Upon submission, the URL should be added to the list.
FR003 Viewing URLs in a List As a user, I want to be able to see all the URLs I have added to my list so I can review and manage them. The system should display the list of added URLs, potentially with their automatically fetched titles and descriptions.
FR004 Editing URLs in a List As a user, I want to be able to edit a URL in my list if I made a mistake or if the link has changed. The system should provide a way for users to modify the URL of an existing item in the list.
FR005 Deleting URLs from a List As a user, I want to be able to remove a URL from my list if it's no longer relevant or if I added it by mistake. The system should provide a mechanism for users to delete individual URLs from their list.
FR006 Customizing the List URL As a user, I want to be able to choose a custom URL for my list so it's easy to remember and share. The system should provide an input field where users can specify their desired custom URL. It should also handle cases where the chosen URL is already taken.
FR007 Automatic URL Generation As a user, if I don't want to think of a custom URL, I want the system to automatically create one for my list so I can still share it. The system should generate a unique and shareable URL for the list if the user doesn't provide one.
FR008 Publishing a List As a user, I want to be able to publish my list so that others can view the collection of URLs. Upon publishing, the list should be saved and made publicly accessible at the associated URL.
FR009 Sharing a List As a user, I want to be able to easily share the link to my list with others through various channels. The system should provide the user with the URL of their list, potentially with options for copying it.
FR010 Accessing a Shared List As a recipient, I want to be able to view the collection of URLs by clicking on or entering the shared link. When a user visits a The Urlist link, they should be presented with the list of URLs.
FR011 Viewing all lists As a user, I want to be able to see all the lists I have created so I can manage them easily. The system should provide a dashboard or overview page where users can see all their created lists.
FR012 Deleting a List As a user, I want to be able to delete an entire list if I no longer need it. The system should provide a way for users to delete their entire list, including all associated URLs.
@KevinKenya
Copy link

I hadn't watched the chose your models part esp Ollama on local. Its 4am but am trying that right now

@ducnm9
Copy link

ducnm9 commented Apr 11, 2025

WOW! I try MCP in VScode. Good!!

@pathum-kalhan
Copy link

Awesome!!!

@HafizaShamza
Copy link

You are doing game chaining things

@DrunkTrader
Copy link

mcp is a great tool.

@Wasaanyi
Copy link

Thanks for sharing. I'm glad I can set rules, use MCP, and provide project requirements.

@rluvaton
Copy link

rluvaton commented Apr 11, 2025

Can you share the current repo with the copilot instructions as well as the database schema and the drizzle folder? I want to replicate this and see if I get the same results

@julianobarbosa
Copy link

til

@albertocavalcante
Copy link

Thanks for sharing this!

@jwvanderbeck
Copy link

Is there an official format for this PRD, or is this mostly handled with NLP?

@chevy-fleetsportsai
Copy link

This has been the best PRD I have seen. Combine this with Linear, Notion, and GitHub MCP to maximize your agent output.

@Priyangshu139
Copy link

great! vscode is catching up

@MB34
Copy link

MB34 commented Apr 11, 2025

Can you share the current repo with the copilot instructions as well as the database schema and the drizzle folder? I want to replicate this and see if I get the same results

Find it here: https://github.com/burkeholland?tab=repositories

@ifalfahri
Copy link

this is so great! really excited to make some projects with this

@iamhtmldeveloper
Copy link

Hey, thanks for this video! helpful—covered key points like Agent Mode, MCP Servers, and Project Requirements Document. Great job, super useful for everyone! 🙌🔥

@ChiRho-AI
Copy link

Fantastic work and thank you for sharing the video. Will be testing this all weekend.

@sascharo
Copy link

Does Copilot discover the prd.md automatically in the project?

@jpyrz
Copy link

jpyrz commented Apr 12, 2025

Does Copilot discover the prd.md automatically in the project?

You can add it as an attachment in the copilot chat window. Or simply open the prd doc and highlight the entirety of its contents (not sure you need to highlight it or not)

@MKGAURAB
Copy link

I tired out the Agent Mode in VS Code today. Absolutely fantastic!!!

@Mohsen467
Copy link

Agent Mode is really the next step. I love it.

@jammsen
Copy link

jammsen commented Apr 13, 2025

Awesome thanks @burkeholland

@tarikmanoar
Copy link

Thanks for sharing

@IhwanID
Copy link

IhwanID commented Apr 15, 2025

thanks!

@titobundy
Copy link

Can you share the current repo with the copilot instructions as well as the database schema and the drizzle folder? I want to replicate this and see if I get the same results

Find it here: https://github.com/burkeholland?tab=repositories

The repo the-urlist-astro is empty

@titobundy
Copy link

titobundy commented Apr 16, 2025

Can you share the current repo with the copilot instructions as well as the database schema and the drizzle folder? I want to replicate this and see if I get the same results

I've found similar copilot-instructions here: https://gist.github.com/burkeholland/bfa38d14b3ec4d5f1ec509656370d62e

But I used this version combined with the one in the video and the missing parts:
https://gist.github.com/titobundy/25d5a0557a02e40f4b28c0ddb4fff0b3

@sascharo
Copy link

sascharo commented Apr 17, 2025

You can add it as an attachment in the copilot chat window. Or simply open the prd doc and highlight the entirety of its contents (not sure you need to highlight it or not)

Okay, thanks. So, the location (and name) of prd.md doesn't actually matter. It can be in the solution's root or in a subdirectory like Doc/. Is that correct?

@SuperArwenAntoinette
Copy link

thank you for this!

@conradwt
Copy link

Okay, thanks. So, the location (and name) of prd.md doesn't actually matter. In can be in the solution's root or in a subdirectory like Doc. Is that correct?

Yes, you're correct that the name and the location of the PRD doesn't matter here. One just needs to drag & drop the PRD into the agent panel and instruct the agent to use it to build out the project.

@sascharo
Copy link

Okay, thanks. So, the location (and name) of prd.md doesn't actually matter. In can be in the solution's root or in a subdirectory like Doc. Is that correct?

Yes, you're correct that the name and the location of the PRD doesn't matter here. One just needs to drag & drop the PRD into the agent panel and instruct the agent to use it to build out the project.

Thanks!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment