Multi-Language Guide
Configure OpenSpec to generate artifacts in languages other than English.
Quick Setup
Add a language instruction to your openspec/config.yaml:
yaml
schema: spec-driven
context: |
Language: Portuguese (pt-BR)
All artifacts must be written in Brazilian Portuguese.
# Your other project context below...
Tech stack: TypeScript, React, Node.jsThat's it. All generated artifacts will now be in Portuguese.
Language Examples
Portuguese (Brazil)
yaml
context: |
Language: Portuguese (pt-BR)
All artifacts must be written in Brazilian Portuguese.Spanish
yaml
context: |
Idioma: Español
Todos los artefactos deben escribirse en español.Chinese (Simplified)
yaml
context: |
语言:中文(简体)
所有产出物必须用简体中文撰写。Japanese
yaml
context: |
言語:日本語
すべての成果物は日本語で作成してください。French
yaml
context: |
Langue : Français
Tous les artefacts doivent être rédigés en français.German
yaml
context: |
Sprache: Deutsch
Alle Artefakte müssen auf Deutsch verfasst werden.Tips
Handle Technical Terms
Decide how to handle technical terminology:
yaml
context: |
Language: Japanese
Write in Japanese, but:
- Keep technical terms like "API", "REST", "GraphQL" in English
- Code examples and file paths remain in EnglishCombine with Other Context
Language settings work alongside your other project context:
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 ORMVerification
To verify your language config is working:
bash
# Check the instructions - should show your language context
openspec instructions proposal --change my-change
# Output will include your language contextRelated Documentation
- [[[[Customization Guide]]]] - Project configuration options
- [[[[Workflows Guide]]]] - Full workflow documentation