@riligar/agents-kit 1.5.0 → 1.5.1

package/.agent/skills/riligar-dev-clean-code/SKILL.md

@@ -1,14 +1,14 @@
 ---
 name: riligar-dev-clean-code
-description: Pragmatic coding standards - concise, direct, no over-engineering, no unnecessary comments
+description: Pragmatic coding standards - concise, direct, no over-engineering, no unnecessary comments (RiLiGar Standard)
 allowed-tools: Read, Write, Edit
-version: 2.0
+version: 2.1
 priority: CRITICAL
 ---
 
-# Clean Code - Pragmatic AI Coding Standards
+# Clean Code - Pragmatic AI Coding Standards (RiLiGar)
 
-> **CRITICAL SKILL** - Be **concise, direct, and solution-focused**.
+> **CRITICAL SKILL** - Be **concise, direct, and solution-focused**. Follow the RiLiGar Tech Stack strictly.
 
 ---
 
@@ -24,6 +24,20 @@ priority: CRITICAL
 
 ---
 
+## RiLiGar Formatting (Prettier)
+
+| Prop               | Value    |
+| ------------------ | -------- |
+| **Indent Size**    | 4 spaces |
+| **Semicolons**     | `false`  |
+| **Quotes**         | Single   |
+| **Print Width**    | 300      |
+| **Trailing Comma** | `es5`    |
+
+> 🔴 **Rule:** Never use TypeScript. Always use modern JavaScript (ES6+).
+
+---
+
 ## Naming Rules
 
 | Element       | Convention                                            |
@@ -39,13 +53,26 @@ priority: CRITICAL
 
 ## Function Rules
 
-| Rule                | Description                           |
-| ------------------- | ------------------------------------- |
-| **Small**           | Max 20 lines, ideally 5-10            |
-| **One Thing**       | Does one thing, does it well          |
-| **One Level**       | One level of abstraction per function |
-| **Few Args**        | Max 3 arguments, prefer 0-2           |
-| **No Side Effects** | Don't mutate inputs unexpectedly      |
+| Rule                | Description                                |
+| ------------------- | ------------------------------------------ |
+| **Small**           | Max 20 lines, ideally 5-10                 |
+| **One Thing**       | Does one thing, does it well               |
+| **One Level**       | One level of abstraction per function      |
+| **Few Args**        | Max 3 arguments, prefer 0-2                |
+| **No Side Effects** | Don't mutate inputs unexpectedly           |
+| **Async/Await**     | Prefer `async/await` over `.then()` chains |
+
+---
+
+## Component & Framework Rules (React/Elysia)
+
+| Situation            | Action                                           |
+| -------------------- | ------------------------------------------------ |
+| **Complex Logic**    | Extract to a Custom Hook if logic > 15 lines     |
+| **State Management** | Use **Zustand** for global, `useState` for local |
+| **UI Components**    | **ALWAYS** use Mantine. No custom/raw CSS.       |
+| **API Endpoints**    | Extract complex handler logic to `services/`     |
+| **Early Returns**    | Use Guard Clauses to avoid deep nesting          |
 
 ---
 
@@ -72,16 +99,17 @@ priority: CRITICAL
 
 ## Anti-Patterns (DON'T)
 
-| ❌ Pattern               | ✅ Fix                  |
-| ------------------------ | ----------------------- |
-| Comment every line       | Delete obvious comments |
-| Helper for one-liner     | Inline the code         |
-| Factory for 2 objects    | Direct instantiation    |
-| utils.ts with 1 function | Put code where used     |
-| "First we import..."     | Just write code         |
-| Deep nesting             | Guard clauses           |
-| Magic numbers            | Named constants         |
-| God functions            | Split by responsibility |
+| ❌ Pattern              | ✅ Fix                         |
+| ----------------------- | ------------------------------ |
+| Comment every line      | Delete obvious comments        |
+| Helper for one-liner    | Inline the code                |
+| Factory for 2 objects   | Direct instantiation           |
+| `utils.js` (1 function) | Put code where used            |
+| "First we import..."    | Just write code                |
+| Deep nesting            | Guard clauses                  |
+| Magic numbers           | Named constants                |
+| God functions           | Split by responsibility        |
+| TypeScript / `.ts`      | Use Vanilla JavaScript (`.js`) |
 
 ---
 
@@ -93,19 +121,17 @@ priority: CRITICAL
 | ------------------------------- | ------------------------ |
 | **What imports this file?**     | They might break         |
 | **What does this file import?** | Interface changes        |
-| **What tests cover this?**      | Tests might fail         |
 | **Is this a shared component?** | Multiple places affected |
 
 **Quick Check:**
 
 ```
-File to edit: UserService.ts
-└── Who imports this? → UserController.ts, AuthController.ts
+File to edit: user-service.js
+└── Who imports this? → user-controller.js
 └── Do they need changes too? → Check function signatures
 ```
 
 > 🔴 **Rule:** Edit the file + all dependent files in the SAME task.
-> 🔴 **Never leave broken imports or missing updates.**
 
 ---
 
@@ -128,43 +154,27 @@ File to edit: UserService.ts
 
 **Before saying "task complete", verify:**
 
-| Check                     | Question                          |
-| ------------------------- | --------------------------------- |
-| ✅ **Goal met?**          | Did I do exactly what user asked? |
-| ✅ **Files edited?**      | Did I modify all necessary files? |
-| ✅ **Code works?**        | Did I test/verify the change?     |
-| ✅ **No errors?**         | Lint and TypeScript pass?         |
-| ✅ **Nothing forgotten?** | Any edge cases missed?            |
-
-> 🔴 **Rule:** If ANY check fails, fix it before completing.
+| Check                 | Question                          |
+| --------------------- | --------------------------------- |
+| ✅ **Goal met?**      | Did I do exactly what user asked? |
+| ✅ **Files edited?**  | Did I modify all necessary files? |
+| ✅ **Code works?**    | Did I test/verify the change?     |
+| ✅ **No TypeScript?** | Verified no `.ts` or type syntax? |
+| ✅ **Formatting?**    | 4 spaces, no semi, single quotes? |
 
 ---
 
 ## Verification Scripts (MANDATORY)
 
-> 🔴 **CRITICAL:** Each agent runs ONLY their own skill's scripts after completing work.
+> 🔴 **CRITICAL:** Run only valid scripts found in `.agent/skills/*/scripts`.
 
 ### Agent → Script Mapping
 
-| Agent                     | Script          | Command                                                                        |
-| ------------------------- | --------------- | ------------------------------------------------------------------------------ |
-| **frontend-specialist**   | UX Audit        | `python .agent/skills/frontend-design/scripts/ux_audit.py .`                   |
-| **frontend-specialist**   | A11y Check      | `python .agent/skills/frontend-design/scripts/accessibility_checker.py .`      |
-| **backend-specialist**    | API Validator   | `python .agent/skills/api-patterns/scripts/api_validator.py .`                 |
-| **mobile-developer**      | Mobile Audit    | `python .agent/skills/mobile-design/scripts/mobile_audit.py .`                 |
-| **database-architect**    | Schema Validate | `python .agent/skills/database-design/scripts/schema_validator.py .`           |
-| **security-auditor**      | Security Scan   | `python .agent/skills/vulnerability-scanner/scripts/security_scan.py .`        |
-| **seo-specialist**        | SEO Check       | `python .agent/skills/seo-fundamentals/scripts/seo_checker.py .`               |
-| **seo-specialist**        | GEO Check       | `python .agent/skills/geo-fundamentals/scripts/geo_checker.py .`               |
-| **performance-optimizer** | Lighthouse      | `python .agent/skills/performance-profiling/scripts/lighthouse_audit.py <url>` |
-| **test-engineer**         | Test Runner     | `python .agent/skills/testing-patterns/scripts/test_runner.py .`               |
-| **test-engineer**         | Playwright      | `python .agent/skills/webapp-testing/scripts/playwright_runner.py <url>`       |
-| **Any agent**             | Lint Check      | `python .agent/skills/lint-and-validate/scripts/lint_runner.py .`              |
-| **Any agent**             | Type Coverage   | `python .agent/skills/lint-and-validate/scripts/type_coverage.py .`            |
-| **Any agent**             | i18n Check      | `python .agent/skills/i18n-localization/scripts/i18n_checker.py .`             |
-
-> ❌ **WRONG:** `test-engineer` running `ux_audit.py`
-> ✅ **CORRECT:** `frontend-specialist` running `ux_audit.py`
+| Agent                  | Script          | Command                                                                   |
+| ---------------------- | --------------- | ------------------------------------------------------------------------- |
+| **backend-specialist** | API Validator   | `python .agent/skills/riligar-dev-backend/scripts/api_validator.py .`     |
+| **database-architect** | Schema Validate | `python .agent/skills/riligar-dev-database/scripts/schema_validator.py .` |
+| **Any agent**          | Lint Check      | `bun x eslint .`                                                          |
 
 ---
 
@@ -172,33 +182,8 @@ File to edit: UserService.ts
 
 **When running a validation script, you MUST:**
 
-1. **Run the script** and capture ALL output
-2. **Parse the output** - identify errors, warnings, and passes
-3. **Summarize to user** in this format:
-
-```markdown
-## Script Results: [script_name.py]
-
-### ❌ Errors Found (X items)
-
-- [File:Line] Error description 1
-- [File:Line] Error description 2
-
-### ⚠️ Warnings (Y items)
-
-- [File:Line] Warning description
-
-### ✅ Passed (Z items)
-
-- Check 1 passed
-- Check 2 passed
-
-**Should I fix the X errors?**
-```
-
-4. **Wait for user confirmation** before fixing
-5. **After fixing** → Re-run script to confirm
+1.  **Run the script** and capture ALL output.
+2.  **Summarize results** (Errors, Warnings, Passes).
+3.  **Ask before fixing** any identified errors.
 
-> 🔴 **VIOLATION:** Running script and ignoring output = FAILED task.
 > 🔴 **VIOLATION:** Auto-fixing without asking = Not allowed.
-> 🔴 **Rule:** Always READ output → SUMMARIZE → ASK → then fix.

package/README.md

@@ -48,4 +48,4 @@ This project uses **Conventional Commits** and **Semantic Release** for fully au
 
 ---
 
-Built with ❤️ by [RiLiGar](https://github.com/ciro-maciel)
+Built with ❤️ by [RiLiGar](https://riligar.click/)

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@riligar/agents-kit",
-    "version": "1.5.0",
+    "version": "1.5.1",
     "publishConfig": {
         "access": "public"
     },