🚀 AI Dev Tasks 🤖

English | Norsk

---

English

Welcome to AI Dev Tasks! This repository provides a collection of .mdc (Markdown Command) files designed to supercharge your feature development workflow By leveraging these commands, you can systematically approach building features, from ideation to implementation, with built-in checkpoints for verification.

Stop wrestling with monolithic AI requests and start guiding your AI collaborator step-by-step!

✨ The Core Idea

Building complex features with AI can sometimes feel like a black box. This workflow aims to bring structure, clarity, and control to the process by:

1. Defining Scope: Clearly outlining what needs to be built with a Product Requirement Document (PRD).
2. Detailed Planning: Breaking down the PRD into a granular, actionable task list.
3. Iterative Implementation: Guiding the AI to tackle one task at a time, allowing you to review and approve each change.

This structured approach helps ensure the AI stays on track, makes it easier to debug issues, and gives you confidence in the generated code.

Workflow: From Idea to Implemented Feature 💡➡️💻

Here's the step-by-step process using the .mdc files in this repository:

1️⃣ Create a Product Requirement Document (PRD)

First, lay out the blueprint for your feature. A PRD clarifies what you're building, for whom, and why.

You can create a lightweight PRD directly:

1. Ensure you have the create-prd.mdc file from this repository accessible.

2. In Agent chat, initiate PRD creation:

   Use @create-prd.mdc
   Here's the feature I want to build: [Describe your feature in detail]
   Reference these files to help you: [Optional: @file1.py @file2.ts]
   

2️⃣ Generate Your Task List from the PRD

With your PRD drafted (e.g., MyFeature-PRD.md), the next step is to generate a detailed, step-by-step implementation plan for your AI Developer.

1. Ensure you have generate-tasks.mdc accessible.

2. In Agent chat, use the PRD to create tasks:

   Now take @MyFeature-PRD.md and create tasks using @generate-tasks.mdc
   

   (Note: Replace @MyFeature-PRD.md with the actual filename of the PRD you generated in step 1.)

3️⃣ Examine Your Task List

You'll now have a well-structured task list, often with tasks and sub-tasks, ready for the AI to start working on. This provides a clear roadmap for implementation.

4️⃣ Instruct the AI to Work Through Tasks (and Mark Completion)

To ensure methodical progress and allow for verification, we'll use process-task-list.mdc. This command instructs the AI to focus on one task at a time and wait for your go-ahead before moving to the next.

1. Create or ensure you have the process-task-list.mdc file accessible.

2. In Agent chat, tell the AI to start with the first task (e.g., 1.1):

   Please start on task 1.1 and use @process-task-list.mdc
   

   (Important: You only need to reference @process-task-list.mdc for the first task. The instructions within it guide the AI for subsequent tasks.)

   The AI will attempt the task and then prompt you to review.

5️⃣ Review, Approve, and Progress ✅

As the AI completes each task, you review the changes.

• If the changes are good, simply reply with "yes" (or a similar affirmative) to instruct the AI to mark the task complete and move to the next one.
• If changes are needed, provide feedback to the AI to correct the current task before moving on.

You'll see a satisfying list of completed items grow, providing a clear visual of your feature coming to life!

While it's not always perfect, this method has proven to be a very reliable way to build out larger features with AI assistance.

🗂️ Files in this Repository

English Files:

• create-prd.mdc: Guides the AI in generating a Product Requirement Document for your feature.
• generate-tasks.mdc: Takes a PRD markdown file as input and helps the AI break it down into a detailed, step-by-step implementation task list.
• process-task-list.mdc: Instructs the AI on how to process the generated task list, tackling one task at a time and waiting for your approval before proceeding.

Norwegian Files:

• create-prd_no.mdc: Veileder AI-en i å generere et Produktkravsdokument for din funksjon.
• generate-tasks_no.mdc: Tar en PRD markdown-fil som input og hjelper AI-en med å dele den ned i en detaljert, steg-for-steg implementeringsoppgaveliste.
• process-task-list_no.mdc: Instruerer AI-en om hvordan den skal behandle den genererte oppgavelisten, takle en oppgave om gangen og vente på din godkjenning før den går videre.

🌟 Benefits

• Structured Development: Enforces a clear process from idea to code.
• Step-by-Step Verification: Allows you to review and approve AI-generated code at each small step, ensuring quality and control.
• Manages Complexity: Breaks down large features into smaller, digestible tasks for the AI, reducing the chance of it getting lost or generating overly complex, incorrect code.
• Improved Reliability: Offers a more dependable approach to leveraging AI for significant development work compared to single, large prompts.
• Clear Progress Tracking: Provides a visual representation of completed tasks, making it easy to see how much has been done and what's next.

🛠️ How to Use

1. Clone or Download: Get these .mdc files into your project or a central location where they can be accessed.
2. Follow the Workflow: Systematically use the .mdc files in Agent chat as described in the 5-step workflow above.
3. Adapt and Iterate:
   • Feel free to modify the prompts within the .mdc files to better suit your specific needs or coding style.
   • If the AI struggles with a task, try rephrasing your initial feature description or breaking down tasks even further.

💡 Tips for Success

• Be Specific: The more context and clear instructions you provide (both in your initial feature description and any clarifications), the better the AI's output will be.
• Be Specific: The more context and clear instructions you provide, the better the AI's output will be.
• Correct File Tagging: Always ensure you're accurately tagging the PRD filename (e.g., @MyFeature-PRD.md) when generating tasks.
• Patience and Iteration: AI is a powerful tool, but it's not magic. Be prepared to guide, correct, and iterate. This workflow is designed to make that iteration process smoother.

🤝 Contributing

Got ideas to improve these .mdc files or have new ones that fit this workflow? Contributions are welcome!

Please feel free to:

• Open an issue to discuss changes or suggest new features.
• Submit a pull request with your enhancements.

---

Norsk

Velkommen til AI Dev Tasks! Dette repositoriet tilbyr en samling av .mdc (Markdown Command) filer designet for å superlade din funksjonsutviklingsarbeidsflyt. Ved å utnytte disse kommandoene kan du systematisk tilnærme deg å bygge funksjoner, fra idé til implementering, med innebygde kontrollpunkter for verifisering.

Slutt å slite med monolittiske AI-forespørsler og begynn å veilede din AI-samarbeidspartner steg-for-steg!

✨ Kjernetanken

Å bygge komplekse funksjoner med AI kan noen ganger føles som en svart boks. Denne arbeidsflyten har som mål å bringe struktur, klarhet og kontroll til prosessen ved:

1. Definere omfang: Tydelig skissere hva som må bygges med et Produktkravsdokument (PRD).
2. Detaljert planlegging: Bryte ned PRD-en til en detaljert, handlingsrettet oppgaveliste.
3. Iterativ implementering: Veilede AI-en til å takle en oppgave om gangen, slik at du kan gjennomgå og godkjenne hver endring.

Denne strukturerte tilnærmingen hjelper med å sikre at AI-en holder seg på sporet, gjør det lettere å feilsøke problemer og gir deg tillit til den genererte koden.

Arbeidsflyt: Fra idé til implementert funksjon 💡➡️💻

Her er steg-for-steg prosessen ved å bruke .mdc filene i dette repositoriet:

1️⃣ Opprett et Produktkravsdokument (PRD)

Først, legg ut planen for din funksjon. En PRD klargjør hva du bygger, for hvem og hvorfor.

Du kan opprette en lett PRD direkte:

1. Sørg for at du har create-prd_no.mdc filen fra dette repositoriet tilgjengelig.

2. I Agent chat, initier PRD-opprettelse:

   Bruk @create-prd_no.mdc
   Her er funksjonen jeg vil bygge: [Beskriv din funksjon i detalj]
   Referer til disse filene for å hjelpe deg: [Valgfritt: @fil1.py @fil2.ts]
   

2️⃣ Generer oppgavelisten din fra PRD-en

Med din PRD utarbeidet (f.eks. MinFunksjon-PRD.md), er neste steg å generere en detaljert, steg-for-steg implementeringsplan for din AI-utvikler.

1. Sørg for at du har generate-tasks_no.mdc tilgjengelig.

2. I Agent chat, bruk PRD-en til å opprette oppgaver:

   Nå ta @MinFunksjon-PRD.md og opprett oppgaver ved å bruke @generate-tasks_no.mdc
   

   (Merk: Erstatt @MinFunksjon-PRD.md med det faktiske filnavnet til PRD-en du genererte i steg 1.)

3️⃣ Undersøk oppgavelisten din

Du vil nå ha en godt strukturert oppgaveliste, ofte med oppgaver og under-oppgaver, klar for AI-en å begynne å jobbe med. Dette gir et klart veikart for implementering.

4️⃣ Instruer AI-en til å arbeide gjennom oppgaver (og markere fullføring)

For å sikre metodisk fremgang og tillate verifisering, vil vi bruke process-task-list_no.mdc. Denne kommandoen instruerer AI-en til å fokusere på en oppgave om gangen og vente på din godkjenning før den går videre til neste.

1. Opprett eller sørg for at du har process-task-list_no.mdc filen tilgjengelig.

2. I Agent chat, fortell AI-en å starte med den første oppgaven (f.eks. 1.1):

   Vennligst start på oppgave 1.1 og bruk @process-task-list_no.mdc
   

   (Viktig: Du trenger bare å referere til @process-task-list_no.mdc for den første oppgaven. Instruksjonene i den veileder AI-en for påfølgende oppgaver.)

   AI-en vil forsøke oppgaven og deretter be deg om å gjennomgå.

5️⃣ Gjennomgå, godkjenn og gå videre ✅

Etter som AI-en fullfører hver oppgave, gjennomgår du endringene.

• Hvis endringene er gode, svar bare med "ja" (eller lignende bekreftelse) for å instruere AI-en til å markere oppgaven som fullført og gå videre til neste.
• Hvis endringer trengs, gi tilbakemelding til AI-en for å korrigere den nåværende oppgaven før du går videre.

Du vil se en tilfredsstillende liste med fullførte elementer vokse, som gir et klart visuelt bilde av funksjonen din som kommer til live!

Selvom det ikke alltid er perfekt, har denne metoden vist seg å være en svært pålitelig måte å bygge ut større funksjoner med AI-assistanse.

🗂️ Filer i dette repositoriet

Engelske filer:

• create-prd.mdc: Veileder AI-en i å generere et Produktkravsdokument for din funksjon.
• generate-tasks.mdc: Tar en PRD markdown-fil som input og hjelper AI-en med å dele den ned i en detaljert, steg-for-steg implementeringsoppgaveliste.
• process-task-list.mdc: Instruerer AI-en om hvordan den skal behandle den genererte oppgavelisten, takle en oppgave om gangen og vente på din godkjenning før den går videre.

Norske filer:

• create-prd_no.mdc: Veileder AI-en i å generere et Produktkravsdokument for din funksjon.
• generate-tasks_no.mdc: Tar en PRD markdown-fil som input og hjelper AI-en med å dele den ned i en detaljert, steg-for-steg implementeringsoppgaveliste.
• process-task-list_no.mdc: Instruerer AI-en om hvordan den skal behandle den genererte oppgavelisten, takle en oppgave om gangen og vente på din godkjenning før den går videre.

🌟 Fordeler

• Strukturert utvikling: Håndhever en klar prosess fra idé til kode.
• Steg-for-steg verifisering: Lar deg gjennomgå og godkjenne AI-generert kode på hvert lille steg, sikrer kvalitet og kontroll.
• Håndterer kompleksitet: Bryter ned store funksjoner til mindre, fordøyelige oppgaver for AI-en, reduserer sjansen for at den blir tapt eller genererer altfor kompleks, feil kode.
• Forbedret pålitelighet: Tilbyr en mer pålitelig tilnærming til å utnytte AI for betydelig utviklingsarbeid sammenlignet med enkle, store forespørsler.
• Klar fremgangssporing: Gir en visuell representasjon av fullførte oppgaver, gjør det enkelt å se hvor mye som er gjort og hva som kommer neste.

🛠️ Hvordan bruke

1. Klon eller last ned: Få disse .mdc filene inn i prosjektet ditt eller en sentral plassering hvor de kan få tilgang til dem.
2. Følg arbeidsflyten: Systematisk bruk .mdc filene i Agent chat som beskrevet i 5-stegs arbeidsflyten ovenfor.
3. Tilpass og iterer:
   • Følg deg fri til å modifisere forespørslene i .mdc filene for bedre å passe dine spesifikke behov eller kodestil.
   • Hvis AI-en sliter med en oppgave, prøv å omformulere din innledende funksjonsbeskrivelse eller dele opp oppgaver enda mer.

💡 Tips for suksess

• Vær spesifikk: Jo mer kontekst og klare instruksjoner du gir (både i din innledende funksjonsbeskrivelse og eventuelle avklaringer), jo bedre vil AI-ens utgang være.
• Vær spesifikk: Jo mer kontekst og klare instruksjoner du gir, jo bedre vil AI-ens utgang være.
• Korrekt filmerking: Sørg alltid for at du nøyaktig merker PRD-filnavnet (f.eks. @MinFunksjon-PRD.md) når du genererer oppgaver.
• Tålmodighet og iterasjon: AI er et kraftig verktøy, men det er ikke magi. Vær forberedt på å veilede, korrigere og iterere. Denne arbeidsflyten er designet for å gjøre den iterasjonsprosessen jevnere.

🤝 Bidra

Har du ideer til å forbedre disse .mdc filene eller har nye som passer denne arbeidsflyten? Bidrag er velkomne!

Vennligst følg deg fri til å:

• Åpne et problem for å diskutere endringer eller foreslå nye funksjoner.
• Send inn en pull request med dine forbedringer.

---

Lykke til med AI-assistert utvikling!