Skip to content

Instantly share code, notes, and snippets.

@decagondev

decagondev/PROJECT-GENERATION.md

Created October 30, 2025 22:09
Show Gist options
  • Save decagondev/2d570e3a7d1d1ab00f6a9b19fa77153e to your computer and use it in GitHub Desktop.
Save decagondev/2d570e3a7d1d1ab00f6a9b19fa77153e to your computer and use it in GitHub Desktop.
Download ZIP
Raw
PROJECT-GENERATION.md

A Workflow to Generate a new Project

Steps

  • Think of a persona (Name, Job Title) and a Software Tech Stack.
  • Go To DecaDeas Input your Persona, Job Title and Tech Stack frm the previous step.
  • Download the generated markdown files to your local computer.
  • Go to Grok and attach all of the Markdown files from the previous step as context.
  • add a prompt to the conversation in grok along with th context from the previous step Using all of these md files Lets build out a really comprehensive PRD markdown file that holds all of the data in depth of this project, make sure to include executive summary and technical summary and diagrams and elaborate on the data where relevant
  • Create a GitHub repsitory to hold the project
  • Create a new file in the repository docs/PRD.md and paste the generated PRD from Grok.
  • Go back to your conversation in Grok and use this prompt: based on all of the files and the new PRD can you now make a Tasks markdown file that splits the tasks in to Epics, PRs and commits to make them a manageable project for a developer or an llm to take on the commits in a granular fashion to get the project done in a clean manner.
  • Go back to your GitHub Repo and add a new file docs/TASKS.md and paste the generated Tasks markdown from the previous step.
  • Go back to the Grok conversation and paste this prompt for the next message to generate code snippets: now please make a CODE-SNIPPETS markdown file for this project
  • Go back to Github and add a new file docs/CODE-SNIPPETS.md then paste the generated markdown from the previous step.
  • Go back to the Grok conversation and if you need an API / Backend you will paste this prompt: now can you make an API markdown file with api docs for this project to generate the api docs f the project.
  • Go Back to the Github repo and make a new file docs/API.md and paste the generated API Docs from the previous step.
  • Go back to the Grok conversation and paste this Prompt: the PRD.md, TASKS.md, API.md and CODE-Snippets.md files are in a docs folder in the repo https://github.com/<YOUR-USER>/<YOUR-REPO> please make a README markdown file for this project with general setup instructions and a good quality introduction to the project changing the repository out for the repo you created on github for this project and ammend any file names based on your project.
  • Go back to your Github Repo and edit the README.md file pasting the new readme in and commiting it.
  • Go back to the Grok conversation and paste this prompt: and now please make a CONTRIBUTING markdown file for this project at the GitHub repository of: https://github.com/<YOUR-USER>/<YOUR-REPO> replacing the repo url with your actual repo url and generate the CONTRIBUTING markdown file.
  • Go back to the GitHub repo and make a new file CONTRIBUTING.md then paste the generated CONTRINBUTING markdown and commit the file.
  • You now have a starter project repository to start working on your new project!

Remember to make sure to read over the docs that are generated and make sure they are following your vision of what the project should be and change them accordingly.

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