@javierfrancoleal/conductor 0.0.0-stage → 1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 J.Franco
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,28 @@
-# Temporary Holding Version
+---
+description: "The teacher organ: detects user-AI friction and delivers micro-lessons with prompt templates."
+kind: "package-bundle"
+---
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+# @javierfrancoleal/conductor
+
+Created by **J.Franco**.
+
+## Summary
+
+For vibe coding: when the human's directions are vague and friction
+appears (repeated revisions, "no funciona", frustration), the conductor
+delivers ONE micro-lesson — the relevant basic concept (layers, flow,
+timeline, components, color, animation, design system) in the user's own
+language, with a prompt template and one clarifying question.
+
+The full curriculum lives in the suite's `docs/CONDUCTOR-GUIDE.md`.
+
+## Use this plugin
+
+Ask "conductor" or use `/conductor "what the user said"` when a request
+gets stuck. The organ detects the friction signal, teaches once, and
+returns to work.
+
+## License
+
+MIT — see the package license field.

package/assets/conductor.md

@@ -0,0 +1,60 @@
+# Conductor — the teacher organ
+
+Vibe coding means the human directs with plain words and the AI builds.
+When the directions are vague, friction appears: repeated revisions of the
+same feature, "hazlo bonito", "no me gusta", frustration. This organ turns
+that friction into education — in the moment, before it becomes a wall.
+
+## Friction signals
+
+Detect them while working:
+
+- The same feature is being revised for the 3rd time.
+- The directive has no measurable property ("bonito", "mejor", "bien").
+- The user expresses confusion or frustration ("no sé ni por dónde empezar").
+- The user describes the SYMPTOM without the LAYER ("no funciona", "no
+  pasa nada") — they cannot locate the problem.
+
+## The response: one micro-lesson, not a lecture
+
+When friction is detected, STOP editing and deliver ONE micro-lesson:
+
+1. **Name the concept** (from the conductor's guide: layers, flow, timeline,
+   components, color/transparency, animation, design system).
+2. **Explain it in one restaurant analogy** (the user's language).
+3. **Show the exact vocabulary** to describe what they want.
+4. **Give the prompt template** with their case filled in.
+5. **Ask ONE clarifying question** ("¿te refieres a la capa, al color, o
+   al ritmo?") — never three.
+
+Keep it under 150 words. The goal is a director who gives better orders,
+not a lecture they must survive.
+
+## The seven concepts (from docs/CONDUCTOR-GUIDE.md)
+
+1. Layers (z-index) — "encima de / detrás de".
+2. Flow — "una puerta, una secuencia A→B→C".
+3. Timeline — "primero… después… sin solaparse".
+4. Components — "logo, rectángulo, esquinas, tamaño".
+5. Color & transparency — "morado translúcido, alfa 0.3, contraste".
+6. Animation — "bucle sin salto, velocidad, visible por defecto".
+7. Design system — "misma estética que…".
+
+## The master template
+
+"[Acción] [componente] en [pantalla]: [propiedad] de [valor A] a [valor
+B], con [detalle], a [velocidad], [condición]. Misma estética que
+[pantalla de referencia]."
+
+## The standard
+
+This organ is Pillar 2 of EL FUEGO — the J.Franco standard
+for human-AI knowledge transfer (docs/EL-FUEGO.md in the suite repo).
+Every lesson delivered here must be recorded in the canonical format.
+
+## Rules
+
+- One lesson per friction event.
+- The human is the director: never talk down, never skip the clarifying
+  question.
+- If the user already speaks the vocabulary, do not teach — just act.

package/cordis.patch.yml

@@ -0,0 +1,4 @@
+# @javierfrancoleal/conductor — J.Franco's teacher organ.
+- insert:
+    - id: conductor
+      name: '@javierfrancoleal/conductor'

package/icon.svg

@@ -0,0 +1,6 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" width="64" height="64">
+  <rect width="64" height="64" rx="14" fill="#4D6BFE"/>
+  <circle cx="32" cy="32" r="18" fill="none" stroke="#ffffff" stroke-width="3.5"/>
+  <path d="M14 40 C 18 48, 26 52, 32 52 C 40 52, 48 48, 52 40" fill="none" stroke="#FACC15" stroke-width="3.5" stroke-linecap="round"/>
+  <circle cx="32" cy="32" r="3" fill="#ffffff"/>
+</svg>

package/lib/index.js

@@ -0,0 +1,56 @@
+// @javierfrancoleal/conductor — an organ of the J.Franco agentic workflow.
+// Created by J.Franco. Registers the conductor skill provider and, when the
+// host command registry is available, the /conductor command.
+import { readFile } from "node:fs/promises";
+import { fileURLToPath } from "node:url";
+import { BUNDLED_SKILL_RANK } from "@deepseek-ai/dsh-skill";
+
+const PROVIDER_NAME = "javierfrancoleal-conductor";
+const SKILL_BODY_URL = new URL("../assets/conductor.md", import.meta.url);
+const RESOURCE_BASE = { kind: "directory", path: fileURLToPath(new URL("../assets/", import.meta.url)) };
+
+const CANDIDATE = {
+  name: "conductor",
+  description: "The teacher organ of the J.Franco agentic workflow: detects friction between the user and the AI and delivers one micro-lesson with a prompt template and a clarifying question.",
+  invocation: { modelInvocable: true, userInvocable: true },
+  provider: PROVIDER_NAME,
+  source: "bundled",
+  resourceBase: RESOURCE_BASE,
+  rank: BUNDLED_SKILL_RANK,
+  locator: SKILL_BODY_URL,
+};
+
+const provider = {
+  name: PROVIDER_NAME,
+  list: () => Promise.resolve([CANDIDATE]),
+  async get() {
+    return {
+      name: CANDIDATE.name,
+      description: CANDIDATE.description,
+      invocation: CANDIDATE.invocation,
+      provider: CANDIDATE.provider,
+      source: CANDIDATE.source,
+      resourceBase: RESOURCE_BASE,
+      content: await readFile(SKILL_BODY_URL, "utf8"),
+    };
+  },
+};
+
+const name = "conductor";
+const inject = ["skills"];
+
+function apply(ctx) {
+  ctx.skills.registerProvider(() => provider);
+  const commands = ctx.get("commands");
+  if (commands !== undefined) {
+    commands.register({
+      definitionId: "@javierfrancoleal/conductor",
+      name: "conductor",
+      description: "Teach one concept when a request gets stuck or vague",
+      input: { hint: "[what the user said or asked]", attachments: true },
+      handler: () => ({ text: "Conductor ON. When a request gets stuck or vague, I teach one concept in your language, give you the exact words, and ask one clarifying question." }),
+    });
+  }
+}
+
+export { apply, inject, name };

package/locale/ar.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "مُعلّم",
+    "description": "يكتشف الاحتكاك بين المستخدم والذكاء الاصطناعي ويعلّم مفهومًا واحدًا في كل مرة."
+  }
+}

package/locale/de.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "Lehrer",
+    "description": "Erkennt Reibung zwischen Nutzer und KI und lehrt ein Konzept nach dem anderen."
+  }
+}

package/locale/en.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "Teacher",
+    "description": "Detects user-AI friction and teaches one concept at a time."
+  }
+}

package/locale/es.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "Maestro",
+    "description": "Detecta la fricción usuario-IA y enseña un concepto a la vez."
+  }
+}

package/locale/fr.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "Professeur",
+    "description": "Détecte les frictions utilisateur-IA et enseigne un concept à la fois."
+  }
+}

package/locale/it.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "Maestro",
+    "description": "Rileva l'attrito utente-IA e insegna un concetto alla volta."
+  }
+}

package/locale/ja.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "教師",
+    "description": "ユーザーとAIの摩擦を検出し、一度に一つの概念を教えます。"
+  }
+}

package/locale/ko.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "교사",
+    "description": "사용자-AI 마찰을 감지하고 한 번에 한 개념을 가르칩니다."
+  }
+}

package/locale/pt.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "Mestre",
+    "description": "Deteta o atrito utilizador-IA e ensina um conceito de cada vez."
+  }
+}

package/locale/zh.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "导师",
+    "description": "检测用户与 AI 之间的摩擦，并一次教授一个概念。"
+  }
+}

package/package.json

@@ -1,6 +1,55 @@
 {
   "name": "@javierfrancoleal/conductor",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.1",
+  "description": "The teacher organ of the J.Franco agentic workflow: detects friction between the user and the AI (repeated revisions, vague directives, frustration) and delivers micro-lessons from the conductor's guide, with prompt templates. Created by J.Franco.",
+  "author": "J.Franco",
+  "license": "MIT",
+  "type": "module",
+  "main": "lib/index.js",
+  "exports": {
+    ".": "./lib/index.js",
+    "./cordis.patch.yml": "./cordis.patch.yml",
+    "./package.json": "./package.json",
+    "./locale/*.json": "./locale/*.json"
+  },
+  "icon": "./icon.svg",
+  "files": [
+    "icon.svg",
+    "locale/*.json",
+    "lib/index.js",
+    "assets",
+    "cordis.patch.yml",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=24",
+    "dsh": ">=0.2.1-rc.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/JavierFrancoLeal/jfranco-agentic-suite.git",
+    "directory": "jfranco-conductor"
+  },
+  "homepage": "https://github.com/JavierFrancoLeal/jfranco-agentic-suite",
+  "keywords": [
+    "deepseek-harness",
+    "agentic-workflow",
+    "super-agent",
+    "education",
+    "vibe-coding",
+    "friction"
+  ],
+  "dsh": {
+    "manifestVersion": 1,
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "~4.0.5",
+    "@deepseek-ai/dsh-skill": ">=0.2.1-rc.5"
+  }
+}