XS ◾ public/uploads/rules/start vibe-coding-best-practices/rule (PR from TinaCMS) (#11998)

<!-- **Tip: Use [SSW Rule Writer
GPT](https://chat.openai.com/g/g-cOvrRzEnU-ssw-rules-writer) for help
with writing rules 🤖** -->
>
> 1. What triggered this change? (PBI link, Email Subject, conversation
+ reason, etc)

Feedback on the rule during brainstorming


> 2. What was changed?

A few small tweaks, check diff for more details.

> 3. I paired or mob programmed with: <!-- list names or remove if not
relevant -->

N/A

<!-- E.g. I paired or mob programmed with: @GordonBeeming and
@sethdailyssw -->

<!-- 
Check out the relevant rules
- https://www.ssw.com.au/rules/rules-to-better-pull-requests
- https://www.ssw.com.au/rules/write-a-good-pull-request
- https://www.ssw.com.au/rules/over-the-shoulder-prs 
- https://www.ssw.com.au/rules/do-you-use-co-creation-patterns
-->

---------

Co-authored-by: Eddie Kranz [SSW] <ed@kranz.au>
Co-authored-by: Eddie Kranz <EddieKranz@ssw.com.au>
Co-authored-by: Tiago Araújo [SSW] <tiagov8@gmail.com>

Author: 3 people

public/uploads/rules/start-vibe-coding-best-practices/rule.mdx

@@ -18,9 +18,9 @@ seoDescription: 'Learn the best practices for starting vibe coding to ensure you
 created: 2025-11-21T04:05:21.000Z
 createdBy: Copilot
 createdByEmail: 198982749+Copilot@users.noreply.github.com
-lastUpdated: 2026-04-01T01:11:51.359Z
-lastUpdatedBy: Tiago Araujo
-lastUpdatedByEmail: TiagoAraujo@ssw.com.au
+lastUpdated: 2026-02-12T23:31:46.481Z
+lastUpdatedBy: Eddie Kranz
+lastUpdatedByEmail: EddieKranz@ssw.com.au
 isArchived: false
 archivedreason: null
 ---
@@ -29,6 +29,15 @@ Vibe coding empowers non-developers to build software using AI agents. However,
 
 <endIntro />
 
+<boxEmbed
+  body={<>
+    This rule was written with non-devs in mind, who are interested in getting on the tools. If you are a dev, check out [the best workflow for AI assisted development](/ai-assisted-development-workflow).
+  </>}
+  figurePrefix="none"
+  figure=""
+  style="info"
+/>
+
 The key to successful vibe coding is starting with the right foundation. This means ensuring your code lives in a proper repository, uses proven architectural patterns, and leverages existing AI guidance.
 
 ## Getting started
@@ -53,14 +62,13 @@ Starting your project in GitHub, specifically within your organization, ensures:
 
 Don't start from scratch! Use one of these battle-tested SSW templates that already include comprehensive AI guidance.
 
-### Clean Architecture Template
+### Clean Architecture template
 
 Use the [SSW Clean Architecture template](https://github.com/SSWConsulting/SSW.CleanArchitecture) which includes:
 
 * Proper separation of concerns (Domain, Application, Infrastructure, Presentation layers)
 * Built-in dependency injection
-* Comprehensive `agents.md` files guiding AI on architectural decisions
-* `.github/copilot-instructions.md` for GitHub Copilot integration
+* Comprehensive `AGENTS.md` files guiding AI on architectural decisions (See more on [writing an AGENTS.md file](/write-agents-md))
 * Pre-configured with best practices and patterns
 
 <boxEmbed
@@ -72,7 +80,7 @@ Use the [SSW Clean Architecture template](https://github.com/SSWConsulting/SSW.C
   figure=""
 />
 
-### Vertical Slice Architecture Template
+### Vertical Slice Architecture template
 
 Alternatively, use the [SSW Vertical Slice Architecture template](https://github.com/SSWConsulting/SSW.VerticalSliceArchitecture) which offers: