feat: first optimization

Author: matscode

.kiro/steering/rules.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** → **[rules/index.rules.md](./rules/index.rules.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
-
-@./rules/index.rules.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**

.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** → **[rules/index.rules.md](../../rules/index.rules.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** → **[rules/index.rules.md](../rules/index.rules.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** → **[rules/index.rules.md](./rules/index.rules.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
-
-@./rules/index.rules.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**

README.md

@@ -29,14 +29,15 @@ Watch how the Interactive Coding Agent works:
 
 ## Benefits
 
-- **Proactive Clarification**: Agents must seek clarification on vague requirements before implementation
-- **Mandatory Stop Points**: Built-in triggers for ambiguous requirements, multiple approaches, and feature additions
-- **Interactive Terminal Input**: Standardized question protocols using terminal commands for user input
-- **User Persona Adaptation**: Communication style adapts based on detected user experience level (none to expert)
-- **Specification Management**: Automatic creation and maintenance of project specifications for architectural decisions
-- **Scope Preservation**: Prevents removal of existing working components during refactoring
-- **Session Closure Protocol**: Always ends with explicit user confirmation before closing sessions
-- **Violation Prevention**: Stops scope creep, unrequested features, and silent assumptions with critical failure protocols
+- **Holistic Workflow**: A master guide that orchestrates all other rules, ensuring a flexible and iterative process.
+- **Proactive Clarification**: Agents must seek clarification on vague requirements before implementation.
+- **Mandatory Stop Points**: Built-in triggers for ambiguous requirements, multiple approaches, and feature additions.
+- **Interactive Terminal Input**: Standardized "one question, one answer" protocols using terminal commands for user input.
+- **User Persona Adaptation**: Communication style adapts based on your detected experience level.
+- **Specification Management**: Automatic creation and maintenance of project specifications for significant decisions.
+- **Scope Preservation**: Prevents removal of existing working components during refactoring.
+- **Session Closure Protocol**: Always ends with explicit user confirmation before closing sessions.
+- **Violation Prevention**: Stops scope creep, unrequested features, and silent assumptions with critical failure protocols.
 
 ## Setup
 
@@ -49,21 +50,20 @@ Want just the essentials? Copy these:
 **Required Files and Folders:**
 - `AGENTS.md` (put in your project root)
 - `rules/` folder (the main rules)
-- `project-specs/` folder
-- `specs/` folder
+- `specs/` folder (for user persona and other specs)
 
 **Your Editor Config:**
 - **Trae AI**: Copy `.trae/` folder
-- **Cursor**: Copy `.cursor/` folder  
+- **Cursor**: Copy `.cursor/` folder
 - **Windsurf**: Copy `.windsurf/` folder
 - **Kiro**: Copy `.kiro/` folder
 
 ### Rule Activation
 - Close and reopen project (optional but recommended)
 - Start a new chat
-- Prompt your agent to "Read workspace rules"
+- The agent should automatically read the rules and begin the onboarding process.
 
-**First Time Expectation:** Once rules are read, the user persona creation workflow should be triggered to create your `user-persona.spec.md`
+**First Time Expectation:** The agent will guide you through creating a `user-persona.spec.md` file, which will tailor its communication style to your preferences.
 
 ## 👤 User Persona System
 
@@ -78,7 +78,7 @@ The agent will automatically ask you to set up a user persona by answering a few
 - Present technical trade-offs and performance implications
 - Assume familiarity with design patterns and best practices
 
-**📊 Product Manager** 
+**📊 Product Manager**
 - Emphasize user impact and business value
 - Focus on feature scope and timeline implications
 - Translate technical decisions into business outcomes
@@ -162,4 +162,4 @@ The persona system ensures you get exactly the right level of detail and communi
 
 ---
 
-*Created by [@matscode](https://www.tiktok.com/@matscode) | [LinkedIn](https://www.linkedin.com/in/matscode)*
+*Created by [@matscode](https://www.tiktok.com/@matscode) | [LinkedIn](https://www.linkedin.com/in/matscode)*