specforge-mcp 0.4.0 → 0.6.0

package/src/config/db-engines.json

@@ -1,8 +1,9 @@
 {
-  "_description": "Registry of database engines with detection deps, SQL syntax, and special features",
+  "_description": "Registry of database engines with detection deps, SQL syntax, and special features (SPEC-025 + SPEC-059)",
   "engines": {
     "supabase": {
       "displayName": "Supabase (PostgreSQL + BaaS)",
+      "category": "sql",
       "detectionDeps": ["@supabase/supabase-js", "@supabase/ssr", "@supabase/auth-helpers-nextjs"],
       "features": ["RLS policies", "Auth", "Storage", "Edge Functions", "Realtime"],
       "securityRules": true,
@@ -10,24 +11,32 @@
       "timestampType": "timestamptz DEFAULT now()",
       "jsonType": "jsonb",
       "autoIncrementSyntax": "GENERATED ALWAYS AS IDENTITY",
+      "schemaFormat": "PostgreSQL DDL",
       "migrations": "supabase/migrations/",
       "installCmd": "npm install @supabase/supabase-js",
       "docsUrl": "https://supabase.com/docs"
     },
     "firebase": {
       "displayName": "Firebase (Firestore + BaaS)",
+      "category": "nosql-document",
       "detectionDeps": ["firebase", "firebase-admin", "@firebase/app"],
       "features": ["Firestore", "Auth", "Storage", "Cloud Functions", "Security Rules"],
       "securityRules": true,
       "collectionFormat": "NoSQL documents",
       "rulesFile": "firestore.rules",
       "indexFile": "firestore.indexes.json",
+      "schemaFormat": "Firestore document model",
       "installCmd": "npm install firebase",
       "docsUrl": "https://firebase.google.com/docs/firestore"
     },
     "postgresql": {
       "displayName": "PostgreSQL",
+      "category": "sql",
       "detectionDeps": ["pg", "postgres", "node-postgres", "knex", "sequelize"],
+      "detectionDepsPython": ["psycopg2", "psycopg", "asyncpg", "sqlalchemy"],
+      "detectionDepsGo": ["github.com/lib/pq", "github.com/jackc/pgx"],
+      "detectionDepsRust": ["tokio-postgres", "sqlx"],
+      "detectionDepsJava": ["postgresql"],
       "prismaDeps": ["@prisma/client"],
       "features": ["ACID", "JSON/JSONB", "Full-text search", "Extensions", "RLS"],
       "securityRules": false,
@@ -35,39 +44,423 @@
       "timestampType": "timestamptz DEFAULT now()",
       "jsonType": "jsonb",
       "autoIncrementSyntax": "SERIAL",
+      "schemaFormat": "PostgreSQL DDL",
       "docsUrl": "https://www.postgresql.org/docs/"
     },
     "mysql": {
       "displayName": "MySQL / MariaDB",
+      "category": "sql",
       "detectionDeps": ["mysql2", "mysql", "mariadb", "knex", "sequelize"],
+      "detectionDepsPython": ["mysqlclient", "pymysql", "mysql-connector-python"],
+      "detectionDepsGo": ["github.com/go-sql-driver/mysql"],
+      "detectionDepsRust": ["mysql", "sqlx"],
+      "detectionDepsJava": ["mysql-connector-java"],
       "features": ["ACID", "JSON", "Full-text search", "Stored procedures"],
       "securityRules": false,
       "idType": "CHAR(36) DEFAULT (UUID())",
       "timestampType": "DATETIME DEFAULT CURRENT_TIMESTAMP",
       "jsonType": "JSON",
       "autoIncrementSyntax": "AUTO_INCREMENT",
+      "schemaFormat": "MySQL DDL",
       "docsUrl": "https://dev.mysql.com/doc/"
     },
     "mongodb": {
       "displayName": "MongoDB",
+      "category": "nosql-document",
       "detectionDeps": ["mongoose", "mongodb", "@typegoose/typegoose"],
+      "detectionDepsPython": ["pymongo", "motor", "mongoengine"],
+      "detectionDepsGo": ["go.mongodb.org/mongo-driver"],
+      "detectionDepsRust": ["mongodb"],
+      "detectionDepsJava": ["mongodb-driver-sync"],
       "features": ["Schema validation", "Aggregation pipeline", "Atlas Search", "Change streams"],
       "securityRules": false,
       "idType": "ObjectId",
       "collectionFormat": "BSON documents",
       "validationSchema": "$jsonSchema",
+      "schemaFormat": "BSON document model",
       "docsUrl": "https://www.mongodb.com/docs/"
     },
     "sqlite": {
       "displayName": "SQLite",
+      "category": "sql",
       "detectionDeps": ["better-sqlite3", "sqlite3", "sqlite", "@libsqlite3", "libsql", "@libsql/client"],
+      "detectionDepsPython": ["sqlite3", "aiosqlite"],
+      "detectionDepsGo": ["github.com/mattn/go-sqlite3"],
+      "detectionDepsRust": ["rusqlite", "sqlx"],
       "features": ["Embedded", "Serverless", "ACID", "File-based"],
       "securityRules": false,
       "idType": "TEXT DEFAULT (lower(hex(randomblob(16))))",
       "timestampType": "TEXT DEFAULT (datetime('now'))",
       "jsonType": "TEXT",
       "autoIncrementSyntax": "AUTOINCREMENT",
+      "schemaFormat": "SQLite DDL",
       "docsUrl": "https://www.sqlite.org/docs.html"
+    },
+    "redis": {
+      "displayName": "Redis",
+      "category": "cache",
+      "detectionDeps": ["redis", "ioredis", "@redis/client"],
+      "detectionDepsPython": ["redis"],
+      "detectionDepsGo": ["github.com/redis/go-redis"],
+      "detectionDepsRust": ["redis"],
+      "detectionDepsJava": ["jedis", "lettuce-core"],
+      "features": ["In-memory", "Pub/Sub", "Streams", "Lua scripting", "Clustering"],
+      "securityRules": false,
+      "schemaFormat": "Key-value patterns",
+      "docsUrl": "https://redis.io/docs/"
+    },
+    "memcached": {
+      "displayName": "Memcached",
+      "category": "cache",
+      "detectionDeps": ["memcached", "memjs"],
+      "detectionDepsPython": ["pymemcache", "python-memcached"],
+      "detectionDepsGo": ["github.com/bradfitz/gomemcache"],
+      "features": ["In-memory", "Simple key-value", "Multi-threaded"],
+      "securityRules": false,
+      "schemaFormat": "Key-value patterns",
+      "docsUrl": "https://memcached.org/"
+    },
+    "valkey": {
+      "displayName": "Valkey",
+      "category": "cache",
+      "detectionDeps": ["valkey", "@valkey/client"],
+      "features": ["In-memory", "Redis-compatible", "Open source"],
+      "securityRules": false,
+      "schemaFormat": "Key-value patterns",
+      "docsUrl": "https://valkey.io/docs/"
+    },
+    "elasticsearch": {
+      "displayName": "Elasticsearch",
+      "category": "search",
+      "detectionDeps": ["@elastic/elasticsearch"],
+      "detectionDepsPython": ["elasticsearch"],
+      "detectionDepsGo": ["github.com/elastic/go-elasticsearch"],
+      "detectionDepsRust": ["elasticsearch"],
+      "detectionDepsJava": ["elasticsearch-rest-high-level-client"],
+      "features": ["Full-text search", "Aggregations", "ML", "Vector search"],
+      "securityRules": false,
+      "schemaFormat": "Index mappings (JSON)",
+      "docsUrl": "https://www.elastic.co/docs/elasticsearch"
+    },
+    "opensearch": {
+      "displayName": "OpenSearch",
+      "category": "search",
+      "detectionDeps": ["@opensearch-project/opensearch"],
+      "detectionDepsPython": ["opensearch-py"],
+      "features": ["Full-text search", "Observability", "Security analytics"],
+      "securityRules": false,
+      "schemaFormat": "Index mappings (JSON)",
+      "docsUrl": "https://opensearch.org/docs/"
+    },
+    "meilisearch": {
+      "displayName": "Meilisearch",
+      "category": "search",
+      "detectionDeps": ["meilisearch"],
+      "detectionDepsPython": ["meilisearch"],
+      "detectionDepsRust": ["meilisearch-sdk"],
+      "features": ["Typo-tolerant", "Instant search", "Faceted search"],
+      "securityRules": false,
+      "schemaFormat": "Index settings (JSON)",
+      "docsUrl": "https://www.meilisearch.com/docs/"
+    },
+    "algolia": {
+      "displayName": "Algolia",
+      "category": "search",
+      "detectionDeps": ["algoliasearch", "@algolia/client-search"],
+      "detectionDepsPython": ["algoliasearch"],
+      "features": ["Hosted search", "AI relevance", "Analytics"],
+      "securityRules": false,
+      "schemaFormat": "Index settings (JSON)",
+      "docsUrl": "https://www.algolia.com/doc/"
+    },
+    "typesense": {
+      "displayName": "Typesense",
+      "category": "search",
+      "detectionDeps": ["typesense"],
+      "detectionDepsPython": ["typesense"],
+      "features": ["Typo-tolerant", "Geo search", "Semantic search"],
+      "securityRules": false,
+      "schemaFormat": "Collection schema (JSON)",
+      "docsUrl": "https://typesense.org/docs/"
+    },
+    "influxdb": {
+      "displayName": "InfluxDB",
+      "category": "timeseries",
+      "detectionDeps": ["@influxdata/influxdb-client"],
+      "detectionDepsPython": ["influxdb-client"],
+      "detectionDepsGo": ["github.com/influxdata/influxdb-client-go"],
+      "detectionDepsJava": ["influxdb-client-java"],
+      "features": ["Time-series", "Flux query", "Telegraf integration"],
+      "securityRules": false,
+      "schemaFormat": "Measurement schema (tags + fields)",
+      "docsUrl": "https://docs.influxdata.com/"
+    },
+    "timescaledb": {
+      "displayName": "TimescaleDB",
+      "category": "timeseries",
+      "detectionDeps": ["pg"],
+      "detectionDepsPython": ["psycopg2", "timescale"],
+      "features": ["Hypertables", "Continuous aggregates", "Compression", "PostgreSQL extension"],
+      "securityRules": false,
+      "schemaFormat": "PostgreSQL DDL + hypertable API",
+      "docsUrl": "https://docs.timescale.com/"
+    },
+    "questdb": {
+      "displayName": "QuestDB",
+      "category": "timeseries",
+      "detectionDeps": ["@questdb/nodejs-client"],
+      "detectionDepsPython": ["questdb"],
+      "features": ["Time-series", "SQL", "High-performance ingestion"],
+      "securityRules": false,
+      "schemaFormat": "QuestDB SQL DDL",
+      "docsUrl": "https://questdb.io/docs/"
+    },
+    "neo4j": {
+      "displayName": "Neo4j",
+      "category": "graph",
+      "detectionDeps": ["neo4j-driver"],
+      "detectionDepsPython": ["neo4j", "py2neo"],
+      "detectionDepsGo": ["github.com/neo4j/neo4j-go-driver"],
+      "detectionDepsJava": ["neo4j-java-driver"],
+      "features": ["Cypher query", "ACID", "Graph algorithms", "Graph Data Science"],
+      "securityRules": false,
+      "schemaFormat": "Cypher DDL (CREATE CONSTRAINT)",
+      "docsUrl": "https://neo4j.com/docs/"
+    },
+    "arangodb": {
+      "displayName": "ArangoDB",
+      "category": "graph",
+      "detectionDeps": ["arangojs"],
+      "detectionDepsPython": ["python-arango"],
+      "features": ["Multi-model", "AQL", "Graph + Document + Key-Value"],
+      "securityRules": false,
+      "schemaFormat": "AQL + collection config",
+      "docsUrl": "https://docs.arangodb.com/"
+    },
+    "neptune": {
+      "displayName": "Amazon Neptune",
+      "category": "graph",
+      "detectionDeps": ["@aws-sdk/client-neptune", "gremlin"],
+      "detectionDepsPython": ["gremlinpython"],
+      "features": ["Managed graph", "Gremlin", "SPARQL", "openCypher"],
+      "securityRules": false,
+      "schemaFormat": "Gremlin/SPARQL/openCypher",
+      "docsUrl": "https://docs.aws.amazon.com/neptune/"
+    },
+    "dgraph": {
+      "displayName": "Dgraph",
+      "category": "graph",
+      "detectionDeps": ["dgraph-js"],
+      "detectionDepsPython": ["pydgraph"],
+      "features": ["Distributed graph", "GraphQL native", "DQL"],
+      "securityRules": false,
+      "schemaFormat": "DQL schema",
+      "docsUrl": "https://dgraph.io/docs/"
+    },
+    "pinecone": {
+      "displayName": "Pinecone",
+      "category": "vector",
+      "detectionDeps": ["@pinecone-database/pinecone"],
+      "detectionDepsPython": ["pinecone-client"],
+      "features": ["Managed vectors", "Metadata filtering", "Namespaces"],
+      "securityRules": false,
+      "schemaFormat": "Index config (JSON)",
+      "docsUrl": "https://docs.pinecone.io/"
+    },
+    "weaviate": {
+      "displayName": "Weaviate",
+      "category": "vector",
+      "detectionDeps": ["weaviate-ts-client"],
+      "detectionDepsPython": ["weaviate-client"],
+      "features": ["Vector + keyword hybrid", "Multi-modal", "GraphQL API"],
+      "securityRules": false,
+      "schemaFormat": "Class schema (JSON)",
+      "docsUrl": "https://weaviate.io/developers/weaviate"
+    },
+    "qdrant": {
+      "displayName": "Qdrant",
+      "category": "vector",
+      "detectionDeps": ["@qdrant/js-client-rest"],
+      "detectionDepsPython": ["qdrant-client"],
+      "detectionDepsRust": ["qdrant-client"],
+      "features": ["HNSW index", "Payload filtering", "Quantization"],
+      "securityRules": false,
+      "schemaFormat": "Collection config (JSON)",
+      "docsUrl": "https://qdrant.tech/documentation/"
+    },
+    "milvus": {
+      "displayName": "Milvus",
+      "category": "vector",
+      "detectionDeps": ["@zilliz/milvus2-sdk-node"],
+      "detectionDepsPython": ["pymilvus"],
+      "detectionDepsJava": ["io.milvus:milvus-sdk-java"],
+      "features": ["Distributed vectors", "GPU acceleration", "Multiple index types"],
+      "securityRules": false,
+      "schemaFormat": "Collection schema (JSON)",
+      "docsUrl": "https://milvus.io/docs/"
+    },
+    "chromadb": {
+      "displayName": "ChromaDB",
+      "category": "vector",
+      "detectionDeps": ["chromadb"],
+      "detectionDepsPython": ["chromadb"],
+      "features": ["Embedded vectors", "Multi-modal", "LangChain integration"],
+      "securityRules": false,
+      "schemaFormat": "Collection config (JSON)",
+      "docsUrl": "https://docs.trychroma.com/"
+    },
+    "cassandra": {
+      "displayName": "Apache Cassandra",
+      "category": "wide-column",
+      "detectionDeps": ["cassandra-driver"],
+      "detectionDepsPython": ["cassandra-driver"],
+      "detectionDepsGo": ["github.com/gocql/gocql"],
+      "detectionDepsJava": ["cassandra-driver-core"],
+      "features": ["Wide-column", "Distributed", "Tunable consistency", "CQL"],
+      "securityRules": false,
+      "schemaFormat": "CQL DDL",
+      "docsUrl": "https://cassandra.apache.org/doc/"
+    },
+    "scylladb": {
+      "displayName": "ScyllaDB",
+      "category": "wide-column",
+      "detectionDeps": ["cassandra-driver", "@scylladb/driver"],
+      "detectionDepsPython": ["scylla-driver"],
+      "detectionDepsRust": ["scylla"],
+      "features": ["Cassandra-compatible", "C++ performance", "Shard-per-core"],
+      "securityRules": false,
+      "schemaFormat": "CQL DDL",
+      "docsUrl": "https://docs.scylladb.com/"
+    },
+    "hbase": {
+      "displayName": "Apache HBase",
+      "category": "wide-column",
+      "detectionDepsJava": ["hbase-client"],
+      "detectionDepsPython": ["happybase"],
+      "detectionDeps": [],
+      "features": ["Hadoop ecosystem", "Wide-column", "Strong consistency"],
+      "securityRules": false,
+      "schemaFormat": "HBase shell DDL",
+      "docsUrl": "https://hbase.apache.org/book.html"
+    },
+    "clickhouse": {
+      "displayName": "ClickHouse",
+      "category": "wide-column",
+      "detectionDeps": ["@clickhouse/client"],
+      "detectionDepsPython": ["clickhouse-connect", "clickhouse-driver"],
+      "detectionDepsGo": ["github.com/ClickHouse/clickhouse-go"],
+      "detectionDepsRust": ["clickhouse"],
+      "detectionDepsJava": ["clickhouse-jdbc"],
+      "features": ["Columnar", "OLAP", "MergeTree engines", "SQL"],
+      "securityRules": false,
+      "schemaFormat": "ClickHouse SQL DDL",
+      "docsUrl": "https://clickhouse.com/docs/"
+    },
+    "cockroachdb": {
+      "displayName": "CockroachDB",
+      "category": "newsql",
+      "detectionDeps": ["pg", "@cockroachlabs/serverless"],
+      "detectionDepsPython": ["psycopg2"],
+      "detectionDepsGo": ["github.com/jackc/pgx"],
+      "features": ["Distributed SQL", "Serializable isolation", "Geo-partitioning", "PostgreSQL compatible"],
+      "securityRules": false,
+      "schemaFormat": "PostgreSQL-compatible DDL",
+      "docsUrl": "https://www.cockroachlabs.com/docs/"
+    },
+    "tidb": {
+      "displayName": "TiDB",
+      "category": "newsql",
+      "detectionDeps": ["mysql2", "@tidbcloud/serverless"],
+      "detectionDepsPython": ["pymysql"],
+      "detectionDepsGo": ["github.com/go-sql-driver/mysql"],
+      "features": ["Distributed SQL", "MySQL compatible", "HTAP", "TiKV storage"],
+      "securityRules": false,
+      "schemaFormat": "MySQL-compatible DDL",
+      "docsUrl": "https://docs.pingcap.com/"
+    },
+    "spanner": {
+      "displayName": "Google Cloud Spanner",
+      "category": "newsql",
+      "detectionDeps": ["@google-cloud/spanner"],
+      "detectionDepsPython": ["google-cloud-spanner"],
+      "detectionDepsGo": ["cloud.google.com/go/spanner"],
+      "detectionDepsJava": ["google-cloud-spanner"],
+      "features": ["Global SQL", "Strong consistency", "Horizontal scaling"],
+      "securityRules": false,
+      "schemaFormat": "Spanner DDL",
+      "docsUrl": "https://cloud.google.com/spanner/docs"
+    },
+    "planetscale": {
+      "displayName": "PlanetScale",
+      "category": "newsql",
+      "detectionDeps": ["@planetscale/database"],
+      "detectionDepsGo": ["github.com/planetscale/planetscale-go"],
+      "features": ["Serverless MySQL", "Branching", "Non-blocking schema changes"],
+      "securityRules": false,
+      "schemaFormat": "MySQL-compatible DDL",
+      "docsUrl": "https://planetscale.com/docs"
+    },
+    "neon": {
+      "displayName": "Neon",
+      "category": "newsql",
+      "detectionDeps": ["@neondatabase/serverless"],
+      "features": ["Serverless PostgreSQL", "Branching", "Auto-scaling", "Compute separation"],
+      "securityRules": false,
+      "schemaFormat": "PostgreSQL DDL",
+      "docsUrl": "https://neon.tech/docs"
+    },
+    "alloydb": {
+      "displayName": "Google AlloyDB",
+      "category": "newsql",
+      "detectionDeps": ["@google-cloud/alloydb"],
+      "detectionDepsPython": ["google-cloud-alloydb-connector"],
+      "features": ["Managed PostgreSQL", "Columnar engine", "AI/ML integration"],
+      "securityRules": false,
+      "schemaFormat": "PostgreSQL DDL",
+      "docsUrl": "https://cloud.google.com/alloydb/docs"
+    },
+    "dynamodb": {
+      "displayName": "Amazon DynamoDB",
+      "category": "cloud-managed",
+      "detectionDeps": ["@aws-sdk/client-dynamodb", "@aws-sdk/lib-dynamodb"],
+      "detectionDepsPython": ["boto3"],
+      "detectionDepsGo": ["github.com/aws/aws-sdk-go-v2/service/dynamodb"],
+      "detectionDepsJava": ["dynamodb-enhanced"],
+      "features": ["Serverless NoSQL", "Single-digit ms", "Global tables", "Streams"],
+      "securityRules": false,
+      "schemaFormat": "DynamoDB table definition (JSON)",
+      "docsUrl": "https://docs.aws.amazon.com/dynamodb/"
+    },
+    "aurora": {
+      "displayName": "Amazon Aurora",
+      "category": "cloud-managed",
+      "detectionDeps": ["@aws-sdk/client-rds-data", "aurora-data-api"],
+      "detectionDepsPython": ["boto3"],
+      "features": ["Managed PostgreSQL/MySQL", "Multi-AZ", "Serverless v2"],
+      "securityRules": false,
+      "schemaFormat": "PostgreSQL/MySQL DDL",
+      "docsUrl": "https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/"
+    },
+    "documentdb": {
+      "displayName": "Amazon DocumentDB",
+      "category": "cloud-managed",
+      "detectionDeps": ["mongodb", "@aws-sdk/client-docdb"],
+      "detectionDepsPython": ["pymongo"],
+      "features": ["MongoDB-compatible", "Managed", "Scalable"],
+      "securityRules": false,
+      "schemaFormat": "MongoDB-compatible document model",
+      "docsUrl": "https://docs.aws.amazon.com/documentdb/"
+    },
+    "cosmosdb": {
+      "displayName": "Azure Cosmos DB",
+      "category": "cloud-managed",
+      "detectionDeps": ["@azure/cosmos"],
+      "detectionDepsPython": ["azure-cosmos"],
+      "detectionDepsJava": ["azure-cosmos"],
+      "features": ["Multi-model", "Global distribution", "Multi-API", "SLA-backed"],
+      "securityRules": false,
+      "schemaFormat": "Container schema (JSON)",
+      "docsUrl": "https://learn.microsoft.com/azure/cosmos-db/"
     }
   },
   "sqlSyntax": {

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",
+      "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",
       "success": "Project initialized at {projectPath}",
       "notImplemented": "init_project is not yet implemented"
     },
@@ -80,12 +80,12 @@
       "notImplemented": "init_constitution is not yet implemented"
     },
     "clarify_requirements": {
-      "description": "Generate targeted clarification questions before creating a spec",
+      "description": "ONLY use when the user request is extremely vague (1-2 words like 'auth' or 'payments'). For most feature requests, skip this and go directly to create_spec — SpecForge infers what it needs from project context",
       "success": "Generated {count} clarification questions for topic: {topic}",
       "notImplemented": "clarify_requirements is not yet implemented"
     },
     "create_spec": {
-      "description": "Create a full SDD spec (HU.md + FICHA-TECNICA.md) from a description",
+      "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",
       "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",
+      "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",
       "success": "Proyecto inicializado en {projectPath}",
       "notImplemented": "init_project aún no está implementado"
     },
@@ -80,12 +80,12 @@
       "notImplemented": "init_constitution aún no está implementado"
     },
     "clarify_requirements": {
-      "description": "Generar preguntas de clarificación antes de crear una spec",
+      "description": "SOLO usar cuando la petición del usuario sea extremadamente vaga (1-2 palabras como 'auth' o 'pagos'). Para la mayoría de features, saltar esto e ir directo a create_spec — SpecForge infiere lo que necesita del contexto del proyecto",
       "success": "Se generaron {count} preguntas de clarificación para el tema: {topic}",
       "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",
+      "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",
       "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",
+      "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",
       "success": "Projeto inicializado em {projectPath}",
       "notImplemented": "init_project ainda não está implementado"
     },
@@ -80,12 +80,12 @@
       "notImplemented": "init_constitution ainda não está implementado"
     },
     "clarify_requirements": {
-      "description": "Gerar perguntas de clarificação antes de criar uma spec",
+      "description": "APENAS usar quando o pedido do usuário for extremamente vago (1-2 palavras como 'auth' ou 'pagamentos'). Para a maioria das features, pular e ir direto para create_spec — SpecForge infere o que precisa do contexto do projeto",
       "success": "Geradas {count} perguntas de clarificação para o tópico: {topic}",
       "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",
+      "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",
       "success": "Spec {id} criada: {title}",
       "notImplemented": "create_spec ainda não está implementado"
     },