specforge-mcp 0.6.1 → 0.7.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "specforge-mcp",
-  "version": "0.6.1",
+  "version": "0.7.0",
   "description": "SpecForge — MCP Server for Spec Driven Development. Manages specs, estimations, reverse engineering, and auto-learning across any language/framework.",
   "type": "module",
   "main": "dist/index.js",

package/src/i18n/messages/en.json

@@ -70,7 +70,7 @@
       "notImplemented": "set_locale is not yet implemented"
     },
     "init_project": {
-      "description": "Initialize a project — detects language, framework, architecture, and stores project knowledge. IMPORTANT: Before running this, ask the user about their profile (developer, product owner, designer, or non-technical user). Store the answer in userProfile. This determines how detailed and technical all subsequent SpecForge interactions will be",
+      "description": "Initialize a project — detects language, framework, architecture, and stores project knowledge. IMPORTANT: Before running this, explain to the user: 'First, I need to scan your project so SpecForge understands what you are building — the language, framework, and structure. This only takes a few seconds and everything stays on your machine.' Then ask about their role (developer, product owner, designer, or non-technical) to set userProfile. After initialization, summarize what was detected in plain language: 'I found a [language] project using [framework]. Your project ID is [id] — I will use this from now on. You are ready to start creating specs!'",
       "success": "Project initialized at {projectPath}",
       "notImplemented": "init_project is not yet implemented"
     },
@@ -85,7 +85,7 @@
       "notImplemented": "clarify_requirements is not yet implemented"
     },
     "create_spec": {
-      "description": "Create a full SDD spec (HU.md + FICHA-TECNICA.md) from a description. Call this directly — no need to run clarify_requirements first. SpecForge uses project context to generate complete specs automatically",
+      "description": "Create a full SDD spec from a description. Call this directly — no need to run clarify_requirements first. IMPORTANT: Before calling this tool, explain to the user in simple terms: 'Based on what you described, I'm going to create a spec — think of it as a detailed plan for your feature with a checklist of what done looks like. This includes: a user story (who needs this and why), acceptance criteria (how we know it works), a technical sheet (architecture, files, risks), and diagrams. Everything stays local on your machine. Let me generate it now.' Keep it friendly and non-technical. After creation, summarize the key points: what will be built, estimated effort, and next steps.",
       "success": "Spec {id} created: {title}",
       "notImplemented": "create_spec is not yet implemented"
     },

package/src/i18n/messages/es.json

@@ -70,7 +70,7 @@
       "notImplemented": "set_locale aún no está implementado"
     },
     "init_project": {
-      "description": "Inicializar un proyecto — detecta lenguaje, framework, arquitectura y almacena conocimiento del proyecto. IMPORTANTE: Antes de ejecutar esto, pregunta al usuario su perfil (desarrollador, product owner, diseñador, o usuario no técnico). Guarda la respuesta en userProfile. Esto determina qué tan detalladas y técnicas serán todas las interacciones posteriores de SpecForge",
+      "description": "Inicializar un proyecto — detecta lenguaje, framework, arquitectura y almacena conocimiento del proyecto. IMPORTANTE: Antes de ejecutar esto, explícale al usuario: 'Primero necesito escanear tu proyecto para que SpecForge entienda qué estás construyendo — el lenguaje, framework y estructura. Solo toma unos segundos y todo queda en tu máquina.' Luego pregunta su rol (desarrollador, product owner, diseñador, o no técnico) para configurar userProfile. Después de inicializar, resume lo detectado en lenguaje simple: 'Encontré un proyecto en [lenguaje] usando [framework]. Tu ID de proyecto es [id] — lo usaré de ahora en adelante. ¡Ya puedes empezar a crear specs!'",
       "success": "Proyecto inicializado en {projectPath}",
       "notImplemented": "init_project aún no está implementado"
     },
@@ -85,7 +85,7 @@
       "notImplemented": "clarify_requirements aún no está implementado"
     },
     "create_spec": {
-      "description": "Crear una spec SDD completa (HU.md + FICHA-TECNICA.md) desde una descripción. Llamar directamente — no necesita ejecutar clarify_requirements primero. SpecForge usa el contexto del proyecto para generar specs completas automáticamente",
+      "description": "Crear una spec SDD completa desde una descripción. Llamar directamente — no necesita ejecutar clarify_requirements primero. IMPORTANTE: Antes de llamar este tool, explícale al usuario de forma simple: 'Basándome en lo que me describiste, voy a crear una spec — piénsala como un plan detallado para tu feature con una lista de verificación de qué significa que esté terminada. Incluye: una historia de usuario (quién lo necesita y por qué), criterios de aceptación (cómo sabemos que funciona), una ficha técnica (arquitectura, archivos, riesgos) y diagramas. Todo se guarda local en tu máquina. Déjame generarla.' Sé amigable y no técnico. Después de crearla, resume los puntos clave: qué se va a construir, esfuerzo estimado y próximos pasos.",
       "success": "Spec {id} creada: {title}",
       "notImplemented": "create_spec aún no está implementado"
     },

package/src/i18n/messages/pt.json

@@ -70,7 +70,7 @@
       "notImplemented": "set_locale ainda não está implementado"
     },
     "init_project": {
-      "description": "Inicializar um projeto — detecta linguagem, framework, arquitetura e armazena conhecimento do projeto. IMPORTANTE: Antes de executar isso, pergunte ao usuário sobre seu perfil (desenvolvedor, product owner, designer, ou usuário não-técnico). Armazene a resposta em userProfile. Isso determina o nível de detalhe técnico de todas as interações posteriores do SpecForge",
+      "description": "Inicializar um projeto — detecta linguagem, framework, arquitetura e armazena conhecimento do projeto. IMPORTANTE: Antes de executar, explique ao usuário: 'Primeiro preciso escanear seu projeto para que o SpecForge entenda o que você está construindo — a linguagem, framework e estrutura. Leva só alguns segundos e tudo fica na sua máquina.' Depois pergunte o papel (desenvolvedor, product owner, designer, ou não-técnico) para configurar userProfile. Após inicializar, resuma o que foi detectado: 'Encontrei um projeto em [linguagem] usando [framework]. Seu ID de projeto é [id] — vou usar ele a partir de agora. Você já pode começar a criar specs!'",
       "success": "Projeto inicializado em {projectPath}",
       "notImplemented": "init_project ainda não está implementado"
     },
@@ -85,7 +85,7 @@
       "notImplemented": "clarify_requirements ainda não está implementado"
     },
     "create_spec": {
-      "description": "Criar uma spec SDD completa (HU.md + FICHA-TECNICA.md) a partir de uma descrição. Chamar diretamente — não precisa executar clarify_requirements antes. SpecForge usa o contexto do projeto para gerar specs completas automaticamente",
+      "description": "Criar uma spec SDD completa a partir de uma descrição. Chamar diretamente — não precisa executar clarify_requirements antes. IMPORTANTE: Antes de chamar este tool, explique ao usuário de forma simples: 'Com base no que você descreveu, vou criar uma spec — pense nela como um plano detalhado para sua feature com uma checklist do que significa estar pronta. Inclui: uma história de usuário (quem precisa e por quê), critérios de aceitação (como sabemos que funciona), uma ficha técnica (arquitetura, arquivos, riscos) e diagramas. Tudo fica salvo local na sua máquina. Deixa eu gerar agora.' Seja amigável e não técnico. Depois de criar, resuma os pontos-chave: o que será construído, esforço estimado e próximos passos.",
       "success": "Spec {id} criada: {title}",
       "notImplemented": "create_spec ainda não está implementado"
     },