achira-wf 4.1.0 → 4.1.2

package/.achira/workflows/registry.json

@@ -1,7 +1,7 @@
 {
-  "engine": "3.x",
+  "engine": "4.x",
   "engine_min": "3.0.0",
-  "version": "4.0.0",
+  "version": "4.1.1",
   "templates": {
     "react": {
       "workflow": "react+vite.md",

package/README.md

@@ -51,62 +51,65 @@ _This command installs the agents, skills, and workflows into a `.achira` direct
 
 ## 🚀 One-Click Scaffolding
 
-Generate production-ready foundations with pre-configured directory structures, absolute imports, testing suites, and linter rules.
+Achira Workflow OS enables high-performance scaffolding directly through your AI assistant. Once `achira-wf init` is run, all templates become available as **slash commands** in your IDE.
 
 ```bash
 # Web Foundations
-achira-wf create react          # React + Vite SPA
-achira-wf create next           # Next.js App Router (Fullstack)
-achira-wf create html           # Vanilla HTML + CSS + JS (Vite)
+/react          # React + Vite SPA
+/next           # Next.js App Router (Fullstack)
+/html           # Vanilla HTML + CSS + JS (Vite)
 
 # Verticals
-achira-wf create saas           # Next.js + Supabase Auth/DB + Stripe
-achira-wf create landing-page   # SEO-Optimized Marketing Page
+/saas           # Next.js + Supabase Auth/DB + Stripe
+/landing-page   # SEO-Optimized Marketing Page
 
 # Apps & Desktop
-achira-wf create flutter        # Multi-platform Dart 3 (Riverpod)
-achira-wf create avalonia       # C# Desktop (Zafiro/MVVM)
+/flutter        # Multi-platform Dart 3 (Riverpod)
+/avalonia       # C# Desktop (Zafiro/MVVM)
 
 # specialized
-achira-wf create shopify        # Apps, Extensions, or Themes
-achira-wf create unity          # Unity 6 LTS C# Game Dev
-achira-wf create python-backend # FastAPI / Django (managed by uv)
-achira-wf create database       # Schema Design & RLS Policies
+/shopify        # Apps, Extensions, or Themes
+/unity          # Unity 6 LTS C# Game Dev
+/python-backend # FastAPI / Django (managed by uv)
+/database       # Schema Design & RLS Policies
 ```
 
 ---
 
-## 🤖 The Elite 20 Agents
+## 🤖 The Elite Agents
 
 Achira OS deploys a specialized task force for every domain.
 
-| Squadron            | Role                                                                                       |
-| :------------------ | :----------------------------------------------------------------------------------------- |
-| **The Strategists** | `orchestrator`, `project-planner`, `product-owner`, `ai-specialist`                        |
-| **The Builders**    | `frontend-specialist`, `backend-specialist`, `mobile-developer`                            |
-| **The Sentinels**   | `security-auditor`, `penetration-tester`, `qa-automation-engineer`                         |
-| **The Analysts**    | `database-architect`, `code-archae考古ologist`, `performance-optimizer`, `devops-engineer` |
+| Squadron            | Role                                                                                   |
+| :------------------ | :------------------------------------------------------------------------------------- |
+| **The Strategists** | `orchestrator`, `project-planner`, `product-owner`, `ai-specialist`                    |
+| **The Builders**    | `frontend-specialist`, `backend-specialist`, `mobile-developer`                        |
+| **The Sentinels**   | `security-auditor`, `penetration-tester`, `qa-automation-engineer`                     |
+| **The Analysts**    | `database-architect`, `code-archaeologist`, `performance-optimizer`, `devops-engineer` |
 
 ---
 
 ## 🛠 Advanced CLI Commands
 
-| Command                       | Purpose                                                      |
-| :---------------------------- | :----------------------------------------------------------- |
-| `achira-wf init`              | Install or repair the `.achira/` core in the current folder. |
-| `achira-wf create <template>` | Scaffold a project (react, next, html).                      |
-| `achira-wf list`              | View all registered workflows and templates.                 |
-| `achira-wf doctor`            | Check system integrity and agent health.                     |
+While most day-to-day work happens via slash commands, the CLI provides core lifecycle tools.
+
+| Command            | Purpose                                                      |
+| :----------------- | :----------------------------------------------------------- |
+| `achira-wf init`   | Install or repair the `.achira/` core in the current folder. |
+| `achira-wf list`   | View all registered workflows and templates.                 |
+| `achira-wf doctor` | Check system integrity and agent health.                     |
 
 ---
 
-## � Operational Workflows
+## 🍱 Operational Workflows
 
-Access powerful slash commands in your AI assistant once the OS is initialized:
+Access powerful slash commands once the OS is initialized:
 
 - `/orchestrate`: Lead a cross-domain squad of agents.
 - `/plan`: Generate deep implementation blueprints.
 - `/ui-ux-pro-max`: Access 50+ unique design styles and premium UI patterns.
+- `/debug`: Systematically investigate and resolve bugs.
+- `/test`: Generate comprehensive test suites.
 
 ## 🍱 Visual Showcase
 

package/cli.js

@@ -91,7 +91,18 @@ program
       );
     }
 
-    // 3. Print registry summary
+    // 3. Sync .cursorrules for automatic IDE rules
+    try {
+      const cursorRulesPath = path.join(target, ".cursorrules");
+      const geminiRulesPath = path.join(ACHIRA_DIR, "rules", "GEMINI.md");
+      await fs.remove(cursorRulesPath); 
+      await fs.ensureSymlink(geminiRulesPath, cursorRulesPath, "file");
+      console.log(chalk.green("  ✔  Linked .cursorrules → .achira/rules/GEMINI.md\n"));
+    } catch (err) {
+      console.log(chalk.yellow(`  ⚠  Could not link .cursorrules: ${err.message}\n`));
+    }
+
+    // 4. Print registry summary
     const registryFile = path.join(dest, "workflows", "registry.json");
     if (fs.existsSync(registryFile)) {
       try {
@@ -110,7 +121,7 @@ program
         console.log(chalk.cyan("  Project Scaffolds:\n"));
         for (const [key, val] of Object.entries(registry.templates || {})) {
           console.log(
-            chalk.white(`    achira-wf create ${key}`) +
+            chalk.white(`    /${key}`) +
               chalk.gray(`  — ${val.description}`),
           );
         }
@@ -174,14 +185,14 @@ program
       process.exit(1);
     }
 
-    console.log(chalk.cyan(`\n  achira-wf create ${template}\n`));
+    console.log(chalk.cyan(`\n  /${template}\n`));
     console.log(chalk.green(`  ✔  Template: ${entry.description}`));
     console.log(
       chalk.green(`  ✔  Workflow: .achira/workflows/${entry.workflow}`),
     );
     console.log(
       chalk.white(
-        `\n  → Open the workflow file and follow the steps, or use the /create slash command.\n`,
+        `\n  → Follow the workflow steps in the IDE, or use the /${template} slash command.\n`,
       ),
     );
   });
@@ -219,7 +230,7 @@ program
     console.log(chalk.cyan("  Project Scaffolds:\n"));
     for (const [key, val] of Object.entries(registry.templates || {})) {
       console.log(
-        chalk.white(`    achira-wf create ${key}`) +
+        chalk.white(`    /${key}`) +
           chalk.gray(`  — ${val.description}`),
       );
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "achira-wf",
-  "version": "4.1.0",
+  "version": "4.1.2",
   "description": "Achira Workflow OS — AI-driven development ecosystem with 21 agents, 7 master pillars, and 22 project scaffolds.",
   "main": "cli.js",
   "bin": {