workflow.md

Project Start ➝ Workflow Overview

1. 1⃣ Start with Your Idea
   Write your project description as a markdown file (e.g., idea.md).

2. 2⃣ Generate a Project Plan
   Use the following prompts to transform your project description into a detailed project plan:

   • Create Plan Prompt: create-plan.md
   • Guidelines Prompt: guidelines.md
   • Combine the two prompts above with your idea prompt idea.md.
   • Example "Full Create Plan Prompt": full-create-plan-prompt.md
   • Example output from o1-mini: Plan.md

3. 3⃣ Iterative Development
   Utilize the provided prompts and tools to iteratively refine your codebase and address issues:

   • Next Story Prompt: next-story.md
   • Fix Resume Prompt: fix-resume.md
   • Post-Mortem Prompt: post-mortem.md

4. 4⃣ Unit Testing and Codebase Maintenance
   For comprehensive testing, run the full codebase evaluation prompt:

   • Fix Codebase Prompt: fix-codebase.md

5. 5⃣ Tagging for Rollback
   After completing each story, tag your Git commit for easy versioning.

   • Example: After finishing story 1.1, tag the commit as v0.1.1.
   • For rollbacks, revert to the desired tag, uncheck relevant story tasks, and adjust lessons learned in the post-mortem.

🔄 Suggested Workflow Rotation

To complete a project efficiently:

1. New Cascade: If using Windsurf, start a new cascade before you run the next story prompt.
2. Next Story Prompt: Start with the current development task.
3. Fix Resume Prompt: Iterate to refine and fix issues until all unit tests pass.
4. Post-Mortem Prompt: Capture lessons learned and prepare for the next story.