OpenSpec

Guía de Multi-Idioma ​

Configure OpenSpec para generar artefactos en idiomas distintos al inglés.

Configuración rápida ​

Para un nuevo proyecto, establezca el idioma durante la inicialización:

bash
openspec init --language "Portuguese (pt-BR)"

Esto escribe la instrucción de idioma en openspec/config.yaml. Si el proyecto ya tiene una configuración, edite directamente su campo context para preservar la orientación existente del proyecto.

También puede configurar el mismo comportamiento manualmente:

Agregue una instrucción de idioma a su openspec/config.yaml:

yaml
schema: spec-driven

context: |
  Language: Portuguese (pt-BR)
  All artifacts must be written in Brazilian Portuguese.
  Keep OpenSpec structural headings and SHALL/MUST keywords in English.

  # Your other project context below...
  Tech stack: TypeScript, React, Node.js

Eso es todo. Todos los artefactos generados ahora estarán en portugués.

La estructura de documentos de OpenSpec y las palabras clave normativas SHALL/MUST permanecen en inglés porque la validación depende de ellas. El texto circundante de los requisitos y escenarios puede usar su idioma seleccionado.

Ejemplos de idiomas ​

Portugués (Brasil) ​

yaml
context: |
  Language: Portuguese (pt-BR)
  All artifacts must be written in Brazilian Portuguese.

Español ​

yaml
context: |
  Idioma: Español
  Todos los artefactos deben escribirse en español.

Chino (simplificado) ​

yaml
context: |
  语言：中文（简体）
  所有产出物必须用简体中文撰写。

Japonés ​

yaml
context: |
  言語：日本語
  すべての成果物は日本語で作成してください。

Francés ​

yaml
context: |
  Langue : Français
  Tous les artefacts doivent être rédigés en français.

Alemán ​

yaml
context: |
  Sprache: Deutsch
  Alle Artefakte müssen auf Deutsch verfasst werden.

Consejos ​

Manejo de términos técnicos ​

Decida cómo manejar la terminología técnica:

yaml
context: |
  Language: Japanese
  Write in Japanese, but:
  - Keep technical terms like "API", "REST", "GraphQL" in English
  - Code examples and file paths remain in English

Combinar con otro contexto ​

La configuración de idioma funciona junto con el resto del contexto de su proyecto:

yaml
schema: spec-driven

context: |
  Language: Portuguese (pt-BR)
  All artifacts must be written in Brazilian Portuguese.

  Tech stack: TypeScript, React 18, Node.js 20
  Database: PostgreSQL with Prisma ORM

Verificación ​

Para verificar que su configuración de idioma funciona correctamente:

bash
# Check the instructions - should show your language context
openspec instructions proposal --change my-change

# Output will include your language context

Documentación relacionada ​