Merge pull request #2 from matscode/draft-20251007

- Rules Optimization
- Persona Personalization
- Project Spec Management
- Features Spec Management

Author: matscode

.kiro/steering/rules.md

@@ -0,0 +1,10 @@
+# Interactive Coding Agent: Entry Point
+
+## 🚨 MANDATORY: START HERE
+
+**BEFORE ANY ACTION, YOU ARE REQUIRED TO:**
+
+1.  **OPEN** → **[../../rules/index.rules.md](../../rules/index.rules.md)**
+2.  **FOLLOW** → The mandatory onboarding process described within.
+
+**FAILURE TO DO SO = CRITICAL VIOLATION**

.trae/rules/project_rules.md

@@ -1,27 +1,10 @@
-# Interactive Coding Agent Rules
+# Interactive Coding Agent: Entry Point
 
-🚨 **MANDATORY: YOU MUST IMMEDIATELY OPEN AND READ THE COMPLETE RULES** 🚨
+## 🚨 MANDATORY: START HERE
 
-**BEFORE ANY CODING SESSION, YOU ARE REQUIRED TO:**
+**BEFORE ANY ACTION, YOU ARE REQUIRED TO:**
 
-1. **OPEN** → **[agents/index.md](../../agents/index.md)**
-2. **READ** → All mandatory standards and core principles
-3. **IMPLEMENT** → Every rule and compliance checklist
+1.  **OPEN** → **[../../rules/index.rules.md](../../rules/index.rules.md)**
+2.  **FOLLOW** → The mandatory onboarding process described within.
 
-**FAILURE TO FOLLOW THESE RULES = CRITICAL VIOLATION**
-
-This file contains:
-- ⚠️ **MANDATORY** stop points and question triggers
-- 🛑 **REQUIRED** interactive command usage
-- ✅ **ESSENTIAL** compliance checklists
-- 🚨 **CRITICAL** violation protocols
-
-**NO EXCEPTIONS. NO ASSUMPTIONS. FOLLOW THE RULES.**
-
----
-
-*Single source of truth for maintainability - MUST be followed by all agents.*
-
----
-
-*Created by [@matscode](https://www.tiktok.com/@matscode) | [LinkedIn](https://www.linkedin.com/in/matscode)*
+**FAILURE TO DO SO = CRITICAL VIOLATION**

.windsurf/rules/project_rules.md

@@ -1,31 +1,13 @@
 ---
 trigger: always_on
 ---
+# Interactive Coding Agent: Entry Point
 
-# Interactive Coding Agent Rules
+## 🚨 MANDATORY: START HERE
 
-🚨 **MANDATORY: YOU MUST IMMEDIATELY OPEN AND READ THE COMPLETE RULES** 🚨
+**BEFORE ANY ACTION, YOU ARE REQUIRED TO:**
 
-**BEFORE ANY CODING SESSION, YOU ARE REQUIRED TO:**
+1.  **OPEN** → **[../../rules/index.rules.md](../../rules/index.rules.md)**
+2.  **FOLLOW** → The mandatory onboarding process described within.
 
-1. **OPEN** → **[agents/index.md](../agents/index.md)**
-2. **READ** → All mandatory standards and core principles
-3. **IMPLEMENT** → Every rule and compliance checklist
-
-**FAILURE TO FOLLOW THESE RULES = CRITICAL VIOLATION**
-
-This file contains:
-- ⚠️ **MANDATORY** stop points and question triggers
-- 🛑 **REQUIRED** interactive command usage
-- ✅ **ESSENTIAL** compliance checklists
-- 🚨 **CRITICAL** violation protocols
-
-**NO EXCEPTIONS. NO ASSUMPTIONS. FOLLOW THE RULES.**
-
----
-
-*Single source of truth for maintainability - MUST be followed by all agents.*
-
----
-
-*Created by [@matscode](https://www.tiktok.com/@matscode) | [LinkedIn](https://www.linkedin.com/in/matscode)*
+**FAILURE TO DO SO = CRITICAL VIOLATION**

AGENTS.md

@@ -1,33 +1,10 @@
-# Interactive Coding Agent Rules
+# Interactive Coding Agent: Entry Point
 
-🚨 **MANDATORY: YOU MUST IMMEDIATELY OPEN AND READ THE COMPLETE RULES** 🚨
+## 🚨 MANDATORY: START HERE
 
-**BEFORE ANY CODING SESSION, YOU ARE REQUIRED TO:**
+**BEFORE ANY ACTION, YOU ARE REQUIRED TO:**
 
-1. **OPEN** → **[agents/index.md](./agents/index.md)**
-2. **READ** → All mandatory standards and core principles
-3. **IMPLEMENT** → Every rule and compliance checklist
+1.  **OPEN** → **[rules/index.rules.md](./rules/index.rules.md)**
+2.  **FOLLOW** → The mandatory onboarding process described within.
 
-**FAILURE TO FOLLOW THESE RULES = CRITICAL VIOLATION**
-
-## Complete Interactive Rules
-
-@./agents/index.md
-
-## Key Requirements
-
-This file contains:
-- ⚠️ **MANDATORY** stop points and question triggers
-- 🛑 **REQUIRED** interactive command usage
-- ✅ **ESSENTIAL** compliance checklists
-- 🚨 **CRITICAL** violation protocols
-
-**NO EXCEPTIONS. NO ASSUMPTIONS. FOLLOW THE RULES.**
-
----
-
-*Single source of truth for maintainability - MUST be followed by all agents.*
-
----
-
-*Created by [@matscode](https://www.tiktok.com/@matscode) | [LinkedIn](https://www.linkedin.com/in/matscode)*
+**FAILURE TO DO SO = CRITICAL VIOLATION**

GEMINI.md

@@ -0,0 +1,37 @@
+# Interactive Coding Agent: Entry Point
+
+## 🚨 MANDATORY: START HERE
+
+**BEFORE ANY ACTION, YOU ARE REQUIRED TO:**
+
+1.  **OPEN** → **[rules/index.rules.md](./rules/index.rules.md)**
+2.  **FOLLOW** → The mandatory onboarding process described within.
+
+**FAILURE TO DO SO = CRITICAL VIOLATION**
+
+---
+
+## ⚠️ CRITICAL OVERRIDE: Interactive Input Protocol
+
+**This section overrides the interactive input instructions found in `rules/interactive-input.rules.md`.** This override specifically pertains to the *mechanism* of asking questions and does not supersede other principles of interactive input, such as clarifying ambiguity or seeking explicit approval.
+
+Due to client-side rendering limitations where `run_shell_command` (the `run_command` alternative in GEMINI's environment) causes an `InvalidStreamError` and Markdown tables are not rendered, the following protocol is the **only acceptable way** for the agent to request interactive input from the user:
+
+1.  **Format:** Questions will be presented as plain text, structured within a custom ASCII-art separator and a Markdown heading.
+2.  **Separator:** A 3-line period-based separator will be used, with the longest line being a Markdown horizontal rule (`---`).
+    *   **Opening:**
+        ```
+        .
+        ..
+        ---
+        ```
+    *   **Closing:**
+        ```
+        ---
+        ..
+        .
+        ```
+3.  **Padding:** One empty line will be placed between the opening separator and the heading, and one empty line between the question body and the closing separator.
+4.  **Heading:** A Markdown H2 heading (`## **Question Title**`) will be used.
+5.  **Body:** The question text will be formatted using supported Markdown (bold, italic, lists, blockquotes, inline code).
+6.  **Interaction:** The agent will send this formatted block as a single text response. The user will provide their answer as a plain text chat message.