Improve persona setup and README clarity

- Enhanced README setup instructions with clearer Quick Start emphasis
- Added Gemini to editor config section in Minimal Setup
- Clarified Standalone Agent as manual process
- Updated persona setup workflow with enforcing warning rules
- Added optional personality change prompt for predefined personas
- Improved warning display for Antagonistic/Chaotic personalities

Author: matscode

README.md

@@ -42,25 +42,29 @@ Watch how the Interactive Coding Agent works:
 ## Setup
 
 ### Quick Start (Recommended)
-**Copy this `interactive-coding-agent` folder's contents** (the AGENTS.md file, rules/ folder, and others) **into your project root.** That's it! You now have interactive coding agents.
+**🚀 Easiest and fastest setup - works with all supported coding agents!**
+
+**Copy this `interactive-coding-agent` folder's contents** (the AGENTS.md file, rules/ folder, and others) **into your project root.** That's it! You now have interactive coding agents configured for all platforms.
 
 ### Minimal Setup
 Want just the essentials? Copy these:
 
 **Required Files and Folders:**
-- `AGENTS.md` (put in your project root)
 - `rules/` folder (the main rules)
 - `specs/` folder (for user persona and other specs)
-- `project-specs/` folder (for project specifications)
+- `feature-specs/` folder (for project specifications)
 
 **Your Editor Config:**
 - **Trae AI**: Copy `.trae/` folder
 - **Cursor**: Copy `.cursor/` folder
 - **Windsurf**: Copy `.windsurf/` folder
 - **Kiro**: Copy `.kiro/` folder
+- **Gemini**: Copy `GEMINI.md` file
 
 ### Standalone Agent
-For those who prefer a single, self-contained set of rules, the `standalone-agent.rules.md` file offers a streamlined setup. Instead of copying multiple folders, you can use this single file.
+**⚙️ Manual setup flow** - For those who prefer a single, self-contained set of rules, the `standalone-agent.rules.md` file offers a streamlined setup. Instead of copying multiple folders, you can use this single file.
+
+**This requires manual configuration following the instructions below:**
 
 **Setup Instructions:**
 1.  Download the `standalone-agent.rules.md` file from this repository.
@@ -188,7 +192,7 @@ The persona system ensures you get exactly the right level of detail and communi
 **Problem**: The agent is not creating specs for major decisions, or references are incorrect.
 
 *   **Check the Rules:** Ask the agent to "read `spec-management.rules.md`" to re-familiarize itself with the mandatory workflow.
-*   **Verify the Index:** Ensure that `project-specs/index.json` is not corrupted and that all recent specs are correctly listed.
+*   **Verify the Index:** Ensure that `feature-specs/index.json` is not corrupted and that all recent specs are correctly listed.
 *   **Force a Sync:** If you suspect a mismatch, ask the agent to "verify and synchronize the spec index with the spec files."
 
 ---

rules/user-persona.rules.md

@@ -29,14 +29,21 @@ After getting the nickname, you MUST offer the user a choice of predefined perso
     *   If a predefined persona is chosen:
         1.  Copy the selected file to `specs/user-persona.spec.md`.
         2.  **Overwrite the Nickname** in the newly created file with the one provided in Step 1.
-    *   If `"Custom"` is chosen, proceed to Step 3.
+        3.  **Ask for Personality Change:** `"Would you like to change the coding agent personality? (y/n)"`
+        4.  **If Yes:**
+            *   Present the AI Personality options: `[Professional | Casual | Playful | Goofy | Antagonistic | Chaotic]`
+            *   Show a short description for each personality
+            *   **MANDATORY:** Display warning indicators (⚠️) and warning text for Antagonistic and Chaotic personalities
+            *   Update the `AI Personality` field in `specs/user-persona.spec.md` with their selection
+        5.  **If No:** Proceed with the current personality setting from the predefined persona
+    *   If `"Custom"` is chosen, proceed to Step 3: Interactive Persona Creation.
 
 ### Step 3: Interactive Persona Creation
 If the user opts for a custom persona, you MUST use the `rules/templates/persona.template.md` to create the `specs/user-persona.spec.md` file. You MUST ask the following questions interactively and populate the template with the answers:
 
 1.  **Role:** `"What is your primary role (e.g., Engineer, Designer, etc.)?"`
 2.  **Experience Level:** `"Please choose your experience level: [Beginner | Intermediate | Senior | Expert]"`
-3.  **AI Personality:** `"Please choose your desired AI personality: [Professional | Casual | Playful | Goofy | Antagonistic | Chaotic]"`. Show the description for each personality. (If no selection is made, `Professional` is the default.)
+3.  **AI Personality:** `"Please choose your desired AI personality: [Professional | Casual | Playful | Goofy | Antagonistic | Chaotic]"`. Show the description for each personality. **MANDATORY:** Display warning indicators (⚠️) and warning text for Antagonistic and Chaotic personalities. (If no selection is made, `Professional` is the default.)
 
 Upon completion, save the answers (including the nickname from Step 1) to `specs/user-persona.spec.md`.