@jeancodogno/specforce-kit 1.0.0-beta.3 → 1.0.0-rc.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.es.md CHANGED
@@ -2,13 +2,15 @@
2
2
  <p align="center">
3
3
  <a href="https://github.com/jeancodogno/specforce-kit/">
4
4
  <picture>
5
- <img src="assets/logo.png" alt="Logotipo de Specforce" height="128">
5
+ <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/jeancodogno/specforce-kit/main/assets/brand/lockup-dark-256.png">
6
+ <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/jeancodogno/specforce-kit/main/assets/brand/lockup-light-256.png">
7
+ <img src="https://raw.githubusercontent.com/jeancodogno/specforce-kit/main/assets/brand/app-icon-256.png" alt="Logotipo de Specforce" height="128">
6
8
  </picture>
7
9
  </a>
8
10
  </p>
9
- <p align="center">Ecosistema para el desarrollo asistido por IA.</p>
11
+ <p align="center">Spec-Driven Development para agentes de IA.</p>
10
12
 
11
- # Specforce Kit
13
+ # Specforce
12
14
 
13
15
  <p align="center">
14
16
  <a href="https://github.com/jeancodogno/specforce-kit/releases"><img src="https://img.shields.io/github/v/release/jeancodogno/specforce-kit?style=flat-square" alt="Latest Release"></a>
@@ -27,9 +29,9 @@
27
29
  <a href="README.es.md"><img src="https://img.shields.io/badge/lang-es-yellow.svg?style=flat-square" alt="Español"></a>
28
30
  </p>
29
31
 
30
- > **La Capa de Orquestación para la Ingeniería Nativa de IA.**
32
+ > **La capa de orquestación para la ingeniería nativa de IA.**
31
33
 
32
- Specforce Kit es un marco de trabajo de nivel profesional diseñado para coordinar agentes de IA (Claude Code, Cursor, KiloCode) a través del **Desarrollo Orientado por Especificaciones (SDD - Spec-Driven Development)**. Proporciona los **Kits**, la **Constitución** y las **Herramientas de Orquestación** estandarizadas necesarias para transformar la IA de un asistente "basado en vibras" en una fuerza de ingeniería determinista.
34
+ Specforce Kit es un framework de nivel profesional diseñado para coordinar agentes de IA (Claude Code, Cursor, Codex, KiloCode y más) a través del **Desarrollo Orientado por Especificaciones (SDD, Spec-Driven Development)**. Proporciona las **Skills**, la **Constitución** y las **Herramientas de Orquestación** estandarizadas necesarias para transformar la IA de un asistente "basado en vibras" en una fuerza de ingeniería determinista.
33
35
 
34
36
  ---
35
37
 
@@ -37,87 +39,90 @@ Specforce Kit es un marco de trabajo de nivel profesional diseñado para coordin
37
39
 
38
40
  En la era de la IA, la implementación es un commodity, pero el diseño es una responsabilidad. **La implementación sin una especificación está estrictamente prohibida en Specforce.**
39
41
 
40
- El Desarrollo Orientado por Especificaciones (SDD) desacopla el diseño de la implementación. Una especificación actúa como un contrato estricto entre los diseñadores humanos y los ejecutores de máquinas. Al hacerlo, evitamos el "vibe coding" (la acumulación de decisiones ad-hoc y no verificadas), asegurando que su sistema permanezca coherente, seguro y mantenible, independientemente de qué agente de IA escriba el código.
42
+ El Desarrollo Orientado por Especificaciones (SDD) desacopla el diseño de la implementación. Una especificación actúa como un contrato estricto entre los diseñadores humanos y los ejecutores máquina. Así evitamos el "vibe coding" (la acumulación de decisiones improvisadas y no verificadas), garantizando que tu sistema siga siendo coherente, seguro y mantenible sin importar qué agente de IA escriba el código.
41
43
 
42
44
  ---
43
45
 
44
46
  ## 📊 ¿Por qué usar Specforce?
45
47
 
46
- La codificación con IA sin guías estrictas conduce inevitablemente al "vibe coding": prompts vagos, resultados impredecibles y una montaña de deuda técnica que se acumula rápidamente. Aunque otras herramientas intentan resolver esto, a menudo te obligan a entrar en nuevos ecosistemas de IDE, requieren configuraciones pesadas o saturan la ventana de contexto de tu IA.
48
+ Programar con IA sin barreras estrictas conduce inevitablemente al "vibe coding": prompts vagos, resultados impredecibles y una montaña de deuda técnica que crece rápidamente. Aunque otras herramientas intentan resolverlo, a menudo te obligan a entrar en nuevos ecosistemas de IDE, requieren configuraciones pesadas o inflan la ventana de contexto de tu IA.
47
49
 
48
- Specforce está diseñado para ser la **capa de orquestación invisible**. Aporta previsibilidad, control arquitectónico y verificación estricta a tus flujos de trabajo de IA, actuando como una máquina de estados activa en lugar de una simple colección de plantillas estáticas.
50
+ Specforce está diseñado para ser la **capa de orquestación invisible**. Aporta previsibilidad, control arquitectónico y verificación estricta a tus flujos de trabajo con IA, actuando como una máquina de estados activa y no solo como una colección de plantillas estáticas.
49
51
 
50
- ### Fortalezas Clave:
52
+ ### Fortalezas clave:
51
53
 
52
- - **Constitución Segmentada**: En lugar de un único prompt masivo, las reglas se dividen en dominios especializados (Arquitectura, UI/UX, Seguridad). El agente solo carga el contexto exacto que necesita, manteniendo bajos los costos de tokens y reduciendo las alucinaciones.
53
- - **Hooks de Verificación Dinámica**: Ejecuta pruebas, linters o scripts personalizados automáticamente antes de que un agente pueda marcar una tarea como finalizada.
54
- - **Soporte de Git Worktree**: Descubre y visualiza de forma nativa las especificaciones en múltiples ramas de git simultáneamente sin cambiar de contexto.
55
- - **Instrucciones Sensibles al Contexto**: Inyecta reglas y restricciones específicas de forma dinámica en función del artefacto o la fase en la que el agente esté trabajando.
56
- - **Agnóstico a Herramientas e IDE**: Lleva el Desarrollo Orientado por Especificaciones directamente a tu terminal. Funciona a la perfección con tu IDE favorito y agentes de IA basados en CLI (Gemini, Claude, Cursor, KiloCode, etc.).
57
- - **Ultrarrápido y Sin Dependencias**: Distribuido como un único binario, no requiere pesadas configuraciones de Python ni ecosistemas forzados para arrancar tu proyecto.
54
+ - **Constitución segmentada**: en lugar de un único prompt enorme, las reglas se dividen en dominios especializados (Arquitectura, UI/UX, Seguridad). El agente solo carga el contexto exacto que necesita, manteniendo bajo el coste en tokens y reduciendo las alucinaciones.
55
+ - **Especificaciones con tamaño y deltas de módulo**: los cambios pequeños solo necesitan una lista de tareas; los más grandes añaden requisitos, diseño y un delta que mantiene al día las living specs de módulo.
56
+ - **QA independiente**: después de la implementación, un tester que no escribió código comprueba cada criterio de aceptación; un veredicto fallido bloquea el archivado.
57
+ - **Hooks de verificación dinámicos**: ejecuta tests, linters o scripts personalizados automáticamente antes de que un agente pueda marcar una tarea como finalizada.
58
+ - **Soporte para Git Worktrees**: descubre y visualiza de forma nativa especificaciones de varias ramas de git a la vez sin cambiar de contexto.
59
+ - **Instrucciones según el contexto**: inyecta reglas y restricciones específicas de forma dinámica según el artefacto o la fase en la que trabaja el agente.
60
+ - **Agnóstico respecto a la herramienta**: la Constitución y las especificaciones viven en `.specforce/`, no en archivos propios de cada herramienta, así que puedes cambiar de herramienta de IA sin perder el contexto del proyecto.
61
+ - **Ultrarrápido y sin dependencias**: se distribuye como un único binario, sin configuraciones pesadas de Python ni ecosistemas forzados para arrancar tu proyecto.
58
62
 
59
63
  ---
60
64
 
61
- ## 🤖 Uso del Agente (Comandos Slash)
65
+ ## 🤖 Uso del agente (Skills)
62
66
 
63
- Specforce interactúa a la perfección con tu agente de IA preferido a través de comandos slash sencillos. Este es el flujo de trabajo estándar:
67
+ Specforce instala sus skills de forma nativa en tu herramienta de IA. Pide una skill por su nombre, en lenguaje natural, en el chat de tu agente; la sintaxis explícita de cada herramienta está en [Invocar las skills](docs/es/supported-tools.md#invocar-las-skills). Este es el ciclo de vida estándar:
64
68
 
65
- ### 1. Descubrimiento (`/spf:discovery`)
66
- **Comando:** `/spf:discovery {idea o informe de error}`
69
+ ### 1. La Constitución (`spf.constitution`)
70
+ **Ejemplo:** "Usa spf.constitution para configurar la constitución: {descripción del proyecto y stack}"
67
71
 
68
- La fase de exploración temprana. Úsalo para intercambiar ideas sobre nuevas funciones o investigar problemas técnicos sin modificar ningún archivo.
69
- - **Exploración de Solo Lectura:** El agente tiene estrictamente prohibido escribir código o artefactos. Se centra en la investigación, el análisis de la causa raíz y la estrategia técnica.
70
- - **Personas Expertas:** Cambia automáticamente entre "Arquitecto Senior de Producto" (Lluvia de ideas) e "Ingeniero Senior de Sistemas" (Detective) según tu entrada.
71
- - **Alineación con el Proyecto:** Lee la Constitución de tu proyecto (`.specforce/docs/`) para asegurar que todas las ideas se alineen con tus principios y arquitectura.
72
+ El primer paso en cualquier proyecto. Genera la Constitución de tu proyecto en `.specforce/docs/`: principios, arquitectura, UI/UX, seguridad, ingeniería, gobernanza y especificaciones de los módulos de dominio (`modules/`).
73
+ - **Segmentada:** Specforce mantiene sus propios documentos especializados en lugar de archivos de reglas propios de cada herramienta. El agente solo carga lo que necesita, y el contexto se mantiene intacto cuando cambias de herramienta.
74
+ - **Configuración interactiva:** describe la idea de tu proyecto y su stack. El agente hará preguntas aclaratorias para ayudarte a tomar las decisiones fundacionales.
75
+ - **Flexible:** ejecútala una vez para la configuración inicial, o vuelve a ejecutarla en cualquier momento para actualizar la constitución. Puedes usarla con ideas totalmente nuevas o dirigirla a un proyecto existente para analizar y documentar su arquitectura actual.
72
76
 
73
- ### 2. La Constitución (`/spf:constitution`)
74
- **Comando:** `/spf:constitution {descripción del proyecto}`
77
+ ### 2. Discovery (`spf.discovery`)
78
+ **Ejemplo:** "Usa spf.discovery para investigar: {idea o reporte de bug}"
75
79
 
76
- El primer paso en cualquier proyecto. Esto genera la Constitución de tu proyecto, que contiene todas las reglas, principios, pautas de UI/UX, arquitectura, seguridad y memoria del agente.
77
- - **Agnóstico a Herramientas y Segmentado:** En lugar de volcar las reglas en archivos específicos de la herramienta (como `.clauderc` o `.gemini/GEMINI.md`) o mantener todo en el contexto, Specforce mantiene sus propios archivos de memoria especializados y segmentados. El agente solo carga lo que necesita. Puedes cambiar de herramienta (por ejemplo, de Gemini CLI a Claude Code) y la memoria del proyecto permanece completamente intacta.
78
- - **Configuración Interactiva:** Describe tu idea de proyecto y stack. El agente te hará preguntas aclaratorias para ayudarte a tomar decisiones fundamentales.
79
- - **Flexible:** Ejecútalo una vez para configurar, o vuelve a ejecutarlo en cualquier momento para actualizar la constitución. Puedes usarlo en ideas nuevas o apuntarlo a un proyecto existente para analizar y documentar su arquitectura actual.
80
+ La fase de exploración. Úsala para hacer una lluvia de ideas sobre nuevas funcionalidades o investigar problemas técnicos antes de comprometerte con un plan.
81
+ - **Solo lectura para el código del producto:** el agente nunca edita tus archivos existentes. La evidencia desechable (tests, scripts, capturas de pantalla) vive en `.specforce/scratch/`.
82
+ - **Consultivo:** el agente da opiniones, compensaciones y opciones recomendadas, y encuentra las causas raíz de los bugs.
83
+ - **Formalización:** cuando estés listo, pídele que formalice el resultado en una propuesta que la planificación reutiliza.
80
84
 
81
- ### 2. Creación de una Spec (`/spf:spec`)
82
- **Comando:** `/spf:spec {descripción de qué añadir o modificar}`
85
+ ### 3. Creación de una especificación (`spf.spec`)
86
+ **Ejemplo:** "Usa spf.spec para planificar: {descripción de lo que hay que añadir o modificar}"
83
87
 
84
- ¿Listo para construir? El agente aclarará tus requisitos y generará tres documentos principales: `requirements.md`, `design.md` y `tasks.md`.
88
+ ¿Listo para construir? El agente aclara tus requisitos y escribe los artefactos requeridos por el tamaño de la especificación: `requirements.md`, `design.md`, `tasks.md` y los deltas de módulo. Tú los revisas y los apruebas.
85
89
 
86
- ### 3. Implementación (`/spf:implement`)
87
- **Comando:** `/spf:implement`
90
+ ### 4. Implementación (`spf.implement`)
91
+ **Ejemplo:** "Usa spf.implement para implementar {spec}"
88
92
 
89
- Después de validar los documentos de especificación generados, ejecuta este comando. El agente seguirá estrictamente las tareas planificadas en la especificación para implementar la función, garantizando una desviación cero del diseño acordado.
93
+ Después de que apruebas la especificación, el agente sigue estrictamente las tareas planificadas, ejecuta tus hooks de verificación y termina con un paso de QA independiente que registra un veredicto para cada criterio de aceptación.
90
94
 
91
- ### 4. Archivado (`/spf:archive`)
92
- **Comando:** `/spf:archive`
95
+ ### 5. Archivado (`spf.archive`)
96
+ **Ejemplo:** "Usa spf.archive para archivar {spec}"
93
97
 
94
- Una vez que la implementación está completada y verificada, este comando analiza qué debe actualizarse en la Constitución global del proyecto basándose en la nueva implementación, y archiva la especificación completada. Sigue las **Instrucciones de Archivado** estandarizadas que aseguran que las lecciones aprendidas se capturen en el memorial del proyecto y que se realice cualquier limpieza específica del proyecto.
98
+ Una vez que la implementación está completa y verificada, el agente aplica los deltas de módulo a las living specs (`.specforce/docs/modules/`), actualiza la Constitución si es necesario y archiva la especificación. El archivado se rechaza mientras haya tareas pendientes, el delta no esté aplicado o el QA haya fallado.
99
+
100
+ Para flujos y consejos sobre bugs, redimensionamiento, cambios después de la implementación, QA fallido y otros casos límite, consulta [Flujos de trabajo y consejos](docs/es/workflows.md).
95
101
 
96
102
  ---
97
103
 
98
- ## ⚡ Toque Humano
104
+ ## ⚡ Puntos de contacto humanos
99
105
 
100
- Mientras Specforce potencia a tus agentes de IA, los humanos interactúan principalmente a través de dos comandos de terminal:
106
+ Mientras Specforce impulsa tus agentes de IA, las personas interactúan principalmente a través de dos comandos de terminal:
101
107
 
102
- ### 1. Inicialización del Proyecto
103
- Configura la gobernanza y los kits de agentes para tu proyecto.
108
+ ### 1. Inicialización del proyecto
109
+ Configura la gobernanza y las skills del agente para tu proyecto.
104
110
  ```bash
105
111
  specforce init
106
112
  ```
107
113
 
108
114
  ### 2. La Consola (TUI)
109
- Inicia el centro de mando para supervisar la salud del proyecto, el progreso de las especificaciones y las implementaciones de los agentes en tiempo real.
115
+ Lanza el centro de mando para seguir en tiempo real la salud del proyecto, el progreso de las especificaciones y las implementaciones de los agentes.
110
116
  ```bash
111
117
  specforce console
112
118
  ```
113
119
 
114
120
  ---
115
121
 
116
- ## 🛠️ Agentes de IA y Herramientas Soportadas
122
+ ## 🛠️ Agentes y herramientas de IA soportados
117
123
 
118
- Specforce Kit está diseñado para ser agnóstico a las herramientas, pero viene con kits preconstruidos y soporte nativo de comandos slash para los asistentes de codificación de IA más populares:
124
+ Specforce Kit está diseñado para ser agnóstico respecto a la herramienta e instala sus skills de forma nativa para los asistentes de programación con IA más populares:
119
125
 
120
- - **Gemini CLI** (Google)
121
126
  - **Claude Code** (Anthropic)
122
127
  - **Qwen** (Alibaba)
123
128
  - **Kimi Code** (Moonshot AI)
@@ -125,26 +130,28 @@ Specforce Kit está diseñado para ser agnóstico a las herramientas, pero viene
125
130
  - **KiloCode**
126
131
  - **Codex**
127
132
  - **Antigravity**
133
+ - **Cursor**
128
134
 
129
135
  *¿No ves tu herramienta favorita? ¡Aceptamos PRs para añadir nuevos kits!*
130
136
 
131
137
  ---
132
138
 
133
- ## 🚀 Primeros Pasos
139
+ ## 🚀 Primeros pasos
134
140
 
135
141
  ### Instalación
136
142
 
137
- **Usando NPM (Recomendado)**
143
+ **Usando NPM (recomendado)**
138
144
  ```bash
139
145
  npm i -g @jeancodogno/specforce-kit
140
146
  ```
141
147
 
142
- **Desde el Código Fuente (Requiere Go 1.26+ y Make)**
148
+ **Desde el código fuente (requiere Go 1.26+ y Make)**
143
149
  ```bash
144
150
  git clone https://github.com/jeancodogno/specforce-kit.git
145
151
  cd specforce-kit
146
152
  make build
147
- make install
153
+ # Binary 'specforce' is created in the root.
154
+ # You can move it to your PATH manually or run it from here.
148
155
  ```
149
156
 
150
157
  ---
@@ -153,22 +160,23 @@ make install
153
160
 
154
161
  Para profundizar en Specforce Kit, consulta nuestra documentación oficial:
155
162
 
156
- - [Primeros Pasos y Flujo de Trabajo](docs/es/getting-started.md): Configuración del entorno, primeros pasos y el ciclo de vida recomendado del Desarrollo Orientado por Especificaciones.
157
- - [Soporte de Git Worktree](docs/es/git-worktrees.md): Guía para el descubrimiento de especificaciones entre ramas, consola unificada y restricciones de solo lectura.
158
- - [Artefactos](docs/es/artifacts.md): Detalles sobre los archivos generados (Constitución, Requisitos, Diseño, Tareas).
159
- - [Configuración](docs/es/configuration.md): Guía para personalizar hooks e instrucciones.
160
- - [Referencia de la CLI](docs/es/cli.md): Uso de la terminal y comandos slash.
161
- - [Herramientas Soportadas](docs/es/supported-tools.md): Lista de agentes de IA y asistentes de codificación soportados de forma nativa.
163
+ - [Primeros pasos y flujo de trabajo](docs/es/getting-started.md): configuración del entorno, primeros pasos, actualizaciones y el ciclo de vida recomendado del Desarrollo Orientado por Especificaciones.
164
+ - [Flujos de trabajo y consejos](docs/es/workflows.md): flujos paso a paso, consejos y qué hacer cuando un paso queda bloqueado.
165
+ - [Soporte para Git Worktrees](docs/es/git-worktrees.md): guía del descubrimiento de especificaciones entre ramas, la consola unificada y las restricciones de solo lectura.
166
+ - [Artefactos](docs/es/artifacts.md): los archivos generados (Constitución, Requisitos, Diseño, Tareas), los tamaños de especificación, los deltas de módulo y el informe de QA.
167
+ - [Configuración](docs/es/configuration.md): guía para personalizar hooks e instrucciones.
168
+ - [Referencia de la CLI](docs/es/cli.md): todos los comandos y flags de la terminal.
169
+ - [Herramientas soportadas](docs/es/supported-tools.md): agentes de IA soportados de forma nativa y cómo invocar las skills en cada uno.
162
170
 
163
171
  ---
164
172
 
165
- ## 🔍 Resolución de Problemas
173
+ ## 🔍 Solución de problemas
166
174
 
167
175
  ### "command not found: specforce"
168
- Si te encuentras con este error después de la instalación, suele significar que el directorio bin global de npm no está en el `PATH` de tu sistema.
176
+ Si encuentras este error después de la instalación, normalmente significa que el directorio bin global de npm no está en el `PATH` de tu sistema.
169
177
 
170
178
  **Solución para macOS/Linux:**
171
- Añade la siguiente línea a tu perfil de shell (por ejemplo, `~/.zshrc` o `~/.bashrc`):
179
+ Añade la siguiente línea al perfil de tu shell (por ejemplo, `~/.zshrc` o `~/.bashrc`):
172
180
  ```bash
173
181
  export PATH="$(npm config get prefix)/bin:$PATH"
174
182
  ```
@@ -176,14 +184,14 @@ export PATH="$(npm config get prefix)/bin:$PATH"
176
184
  **Solución para Windows:**
177
185
  Asegúrate de que `%AppData%\npm` esté en tus variables de entorno.
178
186
 
179
- Para una resolución de problemas más detallada, consulta [Primeros Pasos: Resolución de Problemas](docs/es/getting-started.md#troubleshooting).
187
+ Para una solución de problemas más detallada, consulta [Primeros pasos: Solución de problemas](docs/es/getting-started.md#solución-de-problemas).
180
188
 
181
189
  ---
182
190
 
183
191
  ## 🤝 Contribuir
184
- ¡Agradecemos las contribuciones! Consulta nuestro [CONTRIBUTING.md](CONTRIBUTING.md) para aprender cómo añadir soporte para nuevos agentes de IA o mejorar los kits existentes.
192
+ ¡Las contribuciones son bienvenidas! Consulta nuestro [CONTRIBUTING.es.md](CONTRIBUTING.es.md) para saber cómo añadir soporte para nuevos agentes de IA o mejorar los kits existentes.
185
193
 
186
194
  ---
187
195
 
188
196
  ## 📜 Licencia
189
- Specforce Kit se publica bajo la **Licencia MIT**. Consulta [LICENSE](LICENSE) para más detalles.
197
+ Publicado bajo la **Licencia MIT**. Consulta [LICENSE](LICENSE) para más detalles.
package/README.md CHANGED
@@ -2,13 +2,15 @@
2
2
  <p align="center">
3
3
  <a href="https://github.com/jeancodogno/specforce-kit/">
4
4
  <picture>
5
- <img src="assets/logo.png" alt="Specforce logo" height="128">
5
+ <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/jeancodogno/specforce-kit/main/assets/brand/lockup-dark-256.png">
6
+ <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/jeancodogno/specforce-kit/main/assets/brand/lockup-light-256.png">
7
+ <img src="https://raw.githubusercontent.com/jeancodogno/specforce-kit/main/assets/brand/app-icon-256.png" alt="Specforce logo" height="128">
6
8
  </picture>
7
9
  </a>
8
10
  </p>
9
- <p align="center">Ecosystem for AI-assisted development.</p>
11
+ <p align="center">Spec-Driven Development for AI agents.</p>
10
12
 
11
- # Specforce Kit
13
+ # Specforce
12
14
 
13
15
  <p align="center">
14
16
  <a href="https://github.com/jeancodogno/specforce-kit/releases"><img src="https://img.shields.io/github/v/release/jeancodogno/specforce-kit?style=flat-square" alt="Latest Release"></a>
@@ -29,13 +31,13 @@
29
31
 
30
32
  > **The Orchestration Layer for AI-Native Engineering.**
31
33
 
32
- Specforce Kit is a professional-grade framework designed to coordinate AI agents (Claude Code, Cursor, KiloCode) through **Spec-Driven Development (SDD)**. It provides the standardized **Kits**, **Constitution**, and **Orchestration Tools** required to transform AI from a "vibe-based" assistant into a deterministic engineering force.
34
+ Specforce Kit is a professional-grade framework designed to coordinate AI agents (Claude Code, Cursor, Codex, KiloCode and more) through **Spec-Driven Development (SDD)**. It provides the standardized **Skills**, **Constitution**, and **Orchestration Tools** required to transform AI from a "vibe-based" assistant into a deterministic engineering force.
33
35
 
34
36
  ---
35
37
 
36
38
  ## 🧠 Philosophy
37
39
 
38
- In the age of AI, implementation is a commodity, but design is a liability. **Implementation without a specification is strictly forbidden in Specforce.**
40
+ In the age of AI, implementation is a commodity, but design is a liability. **Implementation without a specification is strictly forbidden in Specforce.**
39
41
 
40
42
  Spec-Driven Development (SDD) decouples design from implementation. A specification acts as a strict contract between human designers and machine executors. By doing so, we prevent "vibe coding" - the accumulation of ad-hoc, unverified decisions - ensuring your system remains coherent, secure, and maintainable no matter which AI agent writes the code.
41
43
 
@@ -50,48 +52,52 @@ Specforce is designed to be the **invisible orchestration layer**. It brings pre
50
52
  ### Key Strengths:
51
53
 
52
54
  - **Segmented Constitution**: Instead of a single massive prompt, rules are broken down into specialized domains (Architecture, UI/UX, Security). The agent only loads the exact context it needs, keeping token costs low and reducing hallucinations.
55
+ - **Sized Specs & Module Deltas**: Small changes need only a task list; larger ones add requirements, design and a delta that keeps the module living specs up to date.
56
+ - **Independent QA**: After implementation, a tester that wrote no code checks every acceptance criterion; a failed verdict blocks archiving.
53
57
  - **Dynamic Verification Hooks**: Run tests, linters, or custom scripts automatically before an agent is allowed to mark a task as finished.
54
58
  - **Git Worktree Support**: Natively discover and view specifications across multiple git branches simultaneously without switching contexts.
55
59
  - **Context-Aware Instructions**: Inject specific rules and constraints dynamically based on the artifact or phase the agent is currently working on.
56
- - **Tool & IDE Agnostic**: Bring Spec-Driven Development directly to your terminal. Works flawlessly with your favorite IDE and CLI-based AI agents (Gemini, Claude, Cursor, KiloCode, etc).
60
+ - **Tool Agnostic**: The Constitution and specs live in `.specforce/`, not in tool-specific files, so you can switch AI tools without losing project context.
57
61
  - **Lightning Fast & Zero Dependencies**: Distributed as a single binary, requiring no heavy Python setups or forced ecosystems to bootstrap your project.
58
62
 
59
63
  ---
60
64
 
61
- ## 🤖 Agent Usage (Slash Commands)
65
+ ## 🤖 Agent Usage (Skills)
62
66
 
63
- Specforce interacts seamlessly with your preferred AI agent via simple slash commands. Here is the standard workflow:
67
+ Specforce installs its skills natively in your AI tool. Ask for a skill by name, in plain language, in your agent's chat; the explicit syntax for each tool is in [Invoking skills](docs/en/supported-tools.md#invoking-skills). Here is the standard lifecycle:
64
68
 
65
- ### 1. Discovery (`/spf:discovery`)
66
- **Command:** `/spf:discovery {idea or bug report}`
69
+ ### 1. The Constitution (`spf.constitution`)
70
+ **Example:** "Use spf.constitution to set up the constitution: {project description and stack}"
67
71
 
68
- The early exploration phase. Use this to brainstorm new features or investigate technical issues without modifying any files.
69
- - **Read-Only Exploration:** The agent is strictly forbidden from writing code or artifacts. It focuses on research, root cause analysis, and technical strategy.
70
- - **Expert Personas:** Automatically switches between "Senior Product Architect" (Brainstorming) and "Senior Systems Engineer" (Detective) based on your input.
71
- - **Project Alignment:** Reads your project's Constitution (`.specforce/docs/`) to ensure all ideas align with your principles and architecture.
72
-
73
- ### 2. The Constitution (`/spf:constitution`)
74
- **Command:** `/spf:constitution {project description}`
75
-
76
- The first step in any project. This generates your project's Constitution, containing all rules, principles, UI/UX guidelines, architecture, security, and domain module specifications.
77
- - **Tool Agnostic & Segmented:** Instead of dumping rules into tool-specific files (like `.clauderc` or `.gemini/GEMINI.md`) or keeping everything in context, Specforce maintains its own specialized, segmented specification files. The agent only loads what it needs. You can switch tools (e.g., from Gemini CLI to Claude Code) and the project context remains completely intact.
72
+ The first step in any project. This generates your project's Constitution in `.specforce/docs/`: principles, architecture, UI/UX, security, engineering, governance and domain module specifications (`modules/`).
73
+ - **Segmented:** Specforce keeps its own specialized documents instead of tool-specific rule files. The agent only loads what it needs, and the context stays intact when you switch tools.
78
74
  - **Interactive Setup:** Describe your project idea and stack. The agent will ask clarifying questions to help you make foundational decisions.
79
75
  - **Flexible:** Run it once to set up, or rerun it anytime to update the constitution. You can use it on brand new ideas or point it at an existing project to analyze and document its current architecture.
80
76
 
81
- ### 2. Creating a Spec (`/spf:spec`)
82
- **Command:** `/spf:spec {description of what to add or modify}`
77
+ ### 2. Discovery (`spf.discovery`)
78
+ **Example:** "Use spf.discovery to investigate: {idea or bug report}"
79
+
80
+ The exploration phase. Use this to brainstorm new features or investigate technical issues before committing to a plan.
81
+ - **Read-Only for Product Code:** The agent never edits your existing files. Disposable evidence (tests, scripts, screenshots) lives in `.specforce/scratch/`.
82
+ - **Consultative:** The agent gives opinions, trade-offs and recommended picks, and finds root causes for bugs.
83
+ - **Formalization:** When you are ready, ask it to formalize the result into a proposal that planning reuses.
84
+
85
+ ### 3. Creating a Spec (`spf.spec`)
86
+ **Example:** "Use spf.spec to plan: {description of what to add or modify}"
87
+
88
+ Ready to build? The agent clarifies your requirements and writes the artifacts required by the spec size: `requirements.md`, `design.md`, `tasks.md` and the module deltas. You review and approve them.
83
89
 
84
- Ready to build? The agent will clarify your requirements and generate three core documents: `requirements.md`, `design.md`, and `tasks.md`.
90
+ ### 4. Implementation (`spf.implement`)
91
+ **Example:** "Use spf.implement to implement {spec}"
85
92
 
86
- ### 3. Implementation (`/spf:implement`)
87
- **Command:** `/spf:implement`
93
+ After you approve the spec, the agent strictly follows the planned tasks, runs your verification hooks, and finishes with an independent QA step that records a verdict for every acceptance criterion.
88
94
 
89
- After you validate the generated spec documents, execute this command. The agent will strictly follow the planned tasks in the spec to implement the feature, ensuring zero drift from the agreed design.
95
+ ### 5. Archiving (`spf.archive`)
96
+ **Example:** "Use spf.archive to archive {spec}"
90
97
 
91
- ### 4. Archiving (`/spf:archive`)
92
- **Command:** `/spf:archive`
98
+ Once implementation is complete and verified, the agent applies the module deltas to the living specs (`.specforce/docs/modules/`), updates the Constitution if needed, and archives the spec. Archiving is refused while tasks are pending, the delta is not applied, or QA failed.
93
99
 
94
- Once implementation is fully complete and verified, this command synthesizes domain living specifications (`.specforce/docs/modules/`), analyzes what needs to be updated in the project's global Constitution, and archives the completed spec. It follows standardized **Archiving Instructions** that ensure as-built reality is captured into living specs and any project-specific cleanup is performed.
100
+ For workflows and tips covering bugs, resizing, changes after implementation, failed QA and other edge cases, see [Workflows & Tips](docs/en/workflows.md).
95
101
 
96
102
  ---
97
103
 
@@ -100,7 +106,7 @@ Once implementation is fully complete and verified, this command synthesizes dom
100
106
  While Specforce powers your AI agents, humans interact primarily through two terminal commands:
101
107
 
102
108
  ### 1. Project Initialization
103
- Set up the governance and agent kits for your project.
109
+ Set up the governance and agent skills for your project.
104
110
  ```bash
105
111
  specforce init
106
112
  ```
@@ -115,9 +121,8 @@ specforce console
115
121
 
116
122
  ## 🛠️ Supported AI Agents & Tools
117
123
 
118
- Specforce Kit is designed to be tool-agnostic but comes with pre-built kits and native slash command support for the most popular AI coding assistants:
124
+ Specforce Kit is designed to be tool-agnostic and installs its skills natively for the most popular AI coding assistants:
119
125
 
120
- - **Gemini CLI** (Google)
121
126
  - **Claude Code** (Anthropic)
122
127
  - **Qwen** (Alibaba)
123
128
  - **Kimi Code** (Moonshot AI)
@@ -125,6 +130,7 @@ Specforce Kit is designed to be tool-agnostic but comes with pre-built kits and
125
130
  - **KiloCode**
126
131
  - **Codex**
127
132
  - **Antigravity**
133
+ - **Cursor**
128
134
 
129
135
  *Don't see your favorite tool? We welcome PRs to add new kits!*
130
136
 
@@ -139,12 +145,12 @@ Specforce Kit is designed to be tool-agnostic but comes with pre-built kits and
139
145
  npm i -g @jeancodogno/specforce-kit
140
146
  ```
141
147
 
142
- **From Source (Requires Go 1.24+ & Make)**
148
+ **From Source (Requires Go 1.26+ & Make)**
143
149
  ```bash
144
150
  git clone https://github.com/jeancodogno/specforce-kit.git
145
151
  cd specforce-kit
146
152
  make build
147
- # Binary 'specforce' is created in the root.
153
+ # Binary 'specforce' is created in the root.
148
154
  # You can move it to your PATH manually or run it from here.
149
155
  ```
150
156
 
@@ -154,12 +160,13 @@ make build
154
160
 
155
161
  For a deeper dive into Specforce Kit, check out our official documentation:
156
162
 
157
- - [Getting Started & Workflow](docs/en/getting-started.md): Environment setup, first steps, and the recommended Spec-Driven Development lifecycle.
163
+ - [Getting Started & Workflow](docs/en/getting-started.md): Environment setup, first steps, updates, and the recommended Spec-Driven Development lifecycle.
164
+ - [Workflows & Tips](docs/en/workflows.md): Step-by-step workflows, tips and what to do when a step is blocked.
158
165
  - [Git Worktree Support](docs/en/git-worktrees.md): Guide to cross-branch specification discovery, unified console, and read-only constraints.
159
- - [Artifacts](docs/en/artifacts.md): Details about the generated files (Constitution, Requirements, Design, Tasks).
166
+ - [Artifacts](docs/en/artifacts.md): The generated files (Constitution, Requirements, Design, Tasks), spec sizes, module deltas and the QA report.
160
167
  - [Configuration](docs/en/configuration.md): Guide to customize hooks and instructions.
161
- - [CLI Reference](docs/en/cli.md): Terminal and slash command usage.
162
- - [Supported Tools](docs/en/supported-tools.md): List of natively supported AI agents and coding assistants.
168
+ - [CLI Reference](docs/en/cli.md): Every terminal command and flag.
169
+ - [Supported Tools](docs/en/supported-tools.md): Natively supported AI agents and how to invoke skills in each one.
163
170
 
164
171
  ---
165
172
 
@@ -187,4 +194,4 @@ We welcome contributions! See our [CONTRIBUTING.md](CONTRIBUTING.md) to learn ho
187
194
  ---
188
195
 
189
196
  ## 📜 License
190
- Specforce Kit is released under the **MIT License**. See [LICENSE](LICENSE) for details.pecforce Kit is released under the **MIT License**. See [LICENSE](LICENSE) for details.
197
+ Released under the **MIT License**. See [LICENSE](LICENSE) for details.
package/README.pt.md CHANGED
@@ -2,13 +2,15 @@
2
2
  <p align="center">
3
3
  <a href="https://github.com/jeancodogno/specforce-kit/">
4
4
  <picture>
5
- <img src="assets/logo.png" alt="Logo Specforce" height="128">
5
+ <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/jeancodogno/specforce-kit/main/assets/brand/lockup-dark-256.png">
6
+ <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/jeancodogno/specforce-kit/main/assets/brand/lockup-light-256.png">
7
+ <img src="https://raw.githubusercontent.com/jeancodogno/specforce-kit/main/assets/brand/app-icon-256.png" alt="Logo do Specforce" height="128">
6
8
  </picture>
7
9
  </a>
8
10
  </p>
9
- <p align="center">Ecossistema para desenvolvimento assistido por IA.</p>
11
+ <p align="center">Spec-Driven Development para agentes de IA.</p>
10
12
 
11
- # Specforce Kit
13
+ # Specforce
12
14
 
13
15
  <p align="center">
14
16
  <a href="https://github.com/jeancodogno/specforce-kit/releases"><img src="https://img.shields.io/github/v/release/jeancodogno/specforce-kit?style=flat-square" alt="Latest Release"></a>
@@ -29,7 +31,7 @@
29
31
 
30
32
  > **A Camada de Orquestração para Engenharia Nativa de IA.**
31
33
 
32
- O Specforce Kit é um framework de nível profissional projetado para coordenar agentes de IA (Claude Code, Cursor, KiloCode) através do **Desenvolvimento Orientado por Especificação (SDD - Spec-Driven Development)**. Ele fornece os **Kits**, a **Constituição** e as **Ferramentas de Orquestração** padronizadas necessárias para transformar a IA de um assistente "baseado em vibes" em uma força de engenharia determinística.
34
+ O Specforce Kit é um framework de nível profissional projetado para coordenar agentes de IA (Claude Code, Cursor, Codex, KiloCode e outros) através do **Desenvolvimento Orientado por Especificação (SDD - Spec-Driven Development)**. Ele fornece as **Skills**, a **Constituição** e as **Ferramentas de Orquestração** padronizadas necessárias para transformar a IA de um assistente "baseado em vibes" em uma força de engenharia determinística.
33
35
 
34
36
  ---
35
37
 
@@ -50,48 +52,52 @@ O Specforce foi projetado para ser a **camada de orquestração invisível**. El
50
52
  ### Principais Diferenciais:
51
53
 
52
54
  - **Constituição Segmentada**: Em vez de um único prompt massivo, as regras são divididas em domínios especializados (Arquitetura, UI/UX, Segurança). O agente carrega apenas o contexto exato de que precisa, mantendo os custos de tokens baixos e reduzindo alucinações.
55
+ - **Especificações com Tamanho e Deltas de Módulo**: Mudanças pequenas precisam apenas de uma lista de tarefas; as maiores acrescentam requisitos, design e um delta que mantém as especificações vivas dos módulos atualizadas.
56
+ - **QA Independente**: Após a implementação, um testador que não escreveu nenhum código verifica cada critério de aceitação; um veredito de falha bloqueia o arquivamento.
53
57
  - **Hooks de Verificação Dinâmica**: Execute testes, linters ou scripts personalizados automaticamente antes que um agente seja autorizado a marcar uma tarefa como finalizada.
54
58
  - **Suporte a Git Worktree**: Descubra e visualize nativamente especificações em múltiplas branches git simultaneamente, sem trocar de contexto.
55
59
  - **Instruções Sensíveis ao Contexto**: Injete regras e restrições específicas dinamicamente com base no artefato ou fase em que o agente está trabalhando.
56
- - **Agnóstico a Ferramentas e IDEs**: Traga o Desenvolvimento Orientado por Especificação diretamente para o seu terminal. Funciona perfeitamente com sua IDE favorita e agentes de IA baseados em CLI (Gemini, Claude, Cursor, KiloCode, etc).
60
+ - **Agnóstico a Ferramentas**: A Constituição e as especificações ficam em `.specforce/`, não em arquivos específicos de ferramentas, então você pode trocar de ferramenta de IA sem perder o contexto do projeto.
57
61
  - **Rápido e Sem Dependências**: Distribuído como um único binário, sem necessidade de configurações pesadas de Python ou ecossistemas forçados para iniciar seu projeto.
58
62
 
59
63
  ---
60
64
 
61
- ## 🤖 Uso pelo Agente (Comandos Slash)
65
+ ## 🤖 Uso pelo Agente (Skills)
62
66
 
63
- O Specforce interage perfeitamente com seu agente de IA preferido através de comandos slash simples. Aqui está o fluxo de trabalho padrão:
67
+ O Specforce instala suas skills nativamente na sua ferramenta de IA. Peça uma skill pelo nome, em linguagem natural, no chat do seu agente; a sintaxe explícita de cada ferramenta está em [Invocando skills](docs/pt/supported-tools.md#invocando-skills). Este é o ciclo de vida padrão:
64
68
 
65
- ### 1. Descoberta (`/spf:discovery`)
66
- **Comando:** `/spf:discovery {ideia ou relatório de erro}`
69
+ ### 1. A Constituição (`spf.constitution`)
70
+ **Exemplo:** "Use spf.constitution para configurar a constituição: {descrição do projeto e stack}"
67
71
 
68
- A fase inicial de exploração. Use isso para debater novas funcionalidades ou investigar problemas técnicos sem modificar nenhum arquivo.
69
- - **Exploração Somente Leitura:** O agente é estritamente proibido de escrever código ou artefatos. Ele se concentra em pesquisa, análise de causa raiz e estratégia técnica.
70
- - **Personas Especialistas:** Alterna automaticamente entre "Arquiteto de Produto Sênior" (Brainstorming) e "Engenheiro de Sistemas Sênior" (Detetive) com base na sua entrada.
71
- - **Alinhamento com o Projeto:** Lê a Constituição do seu projeto (`.specforce/docs/`) para garantir que todas as ideias estejam alinhadas com seus princípios e arquitetura.
72
+ O primeiro passo em qualquer projeto. Isso gera a Constituição do seu projeto em `.specforce/docs/`: princípios, arquitetura, UI/UX, segurança, engenharia, governança e especificações dos módulos de domínio (`modules/`).
73
+ - **Segmentada:** O Specforce mantém seus próprios documentos especializados em vez de arquivos de regras específicos de ferramentas. O agente carrega apenas o que precisa, e o contexto permanece intacto quando você troca de ferramenta.
74
+ - **Configuração Interativa:** Descreva sua ideia de projeto e stack. O agente fará perguntas esclarecedoras para ajudá-lo a tomar decisões fundamentais.
75
+ - **Flexível:** Execute uma vez para configurar, ou execute novamente a qualquer momento para atualizar a constituição. Você pode usá-la em ideias novas ou apontá-la para um projeto existente para analisar e documentar sua arquitetura atual.
72
76
 
73
- ### 2. A Constituição (`/spf:constitution`)
74
- **Comando:** `/spf:constitution {descrição do projeto}`
77
+ ### 2. Descoberta (`spf.discovery`)
78
+ **Exemplo:** "Use spf.discovery para investigar: {ideia ou relato de bug}"
75
79
 
76
- O primeiro passo em qualquer projeto. Isso gera a Constituição do seu projeto, contendo todas as regras, princípios, diretrizes de UI/UX, arquitetura, segurança e memória do agente.
77
- - **Agnóstico a Ferramentas e Segmentado:** Em vez de despejar regras em arquivos específicos de ferramentas (como `.clauderc` ou `.gemini/GEMINI.md`) ou manter tudo no contexto, o Specforce mantém seus próprios arquivos de memória especializados e segmentados. O agente carrega apenas o que precisa. Você pode trocar de ferramenta (ex: de Gemini CLI para Claude Code) e a memória do projeto permanece completamente intacta.
78
- - **Configuração Interativa:** Descreva sua ideia de projeto e stack. O agente fará perguntas esclarecedoras para ajudá-lo a tomar decisões fundamentais.
79
- - **Flexível:** Execute uma vez para configurar, ou execute novamente a qualquer momento para atualizar a constituição. Você pode usá-lo em ideias novas ou apontá-lo para um projeto existente para analisar e documentar sua arquitetura atual.
80
+ A fase de exploração. Use-a para fazer brainstorming de novas funcionalidades ou investigar problemas técnicos antes de se comprometer com um plano.
81
+ - **Somente Leitura para o Código do Produto:** O agente nunca edita seus arquivos existentes. As evidências descartáveis (testes, scripts, capturas de tela) ficam em `.specforce/scratch/`.
82
+ - **Consultiva:** O agente dá opiniões, trade-offs e escolhas recomendadas, e encontra a causa raiz de bugs.
83
+ - **Formalização:** Quando estiver pronto, peça para formalizar o resultado em uma proposta que o planejamento reaproveita.
84
+
85
+ ### 3. Criando uma Especificação (`spf.spec`)
86
+ **Exemplo:** "Use spf.spec para planejar: {descrição do que adicionar ou modificar}"
80
87
 
81
- ### 2. Criando uma Spec (`/spf:spec`)
82
- **Comando:** `/spf:spec {descrição do que adicionar ou modificar}`
88
+ Pronto para construir? O agente esclarece seus requisitos e escreve os artefatos exigidos pelo tamanho da especificação: `requirements.md`, `design.md`, `tasks.md` e os deltas de módulo. Você os revisa e aprova.
83
89
 
84
- Pronto para construir? O agente esclarecerá seus requisitos e gerará três documentos principais: `requirements.md`, `design.md` e `tasks.md`.
90
+ ### 4. Implementação (`spf.implement`)
91
+ **Exemplo:** "Use spf.implement para implementar {especificação}"
85
92
 
86
- ### 3. Implementação (`/spf:implement`)
87
- **Comando:** `/spf:implement`
93
+ Depois que você aprova a especificação, o agente segue rigorosamente as tarefas planejadas, executa seus hooks de verificação e termina com uma etapa de QA independente que registra um veredito para cada critério de aceitação.
88
94
 
89
- Após validar os documentos de especificação gerados, execute este comando. O agente seguirá estritamente as tarefas planejadas na spec para implementar a funcionalidade, garantindo desvio zero do design acordado.
95
+ ### 5. Arquivamento (`spf.archive`)
96
+ **Exemplo:** "Use spf.archive para arquivar {especificação}"
90
97
 
91
- ### 4. Arquivamento (`/spf:archive`)
92
- **Comando:** `/spf:archive`
98
+ Assim que a implementação estiver concluída e verificada, o agente aplica os deltas de módulo às especificações vivas (`.specforce/docs/modules/`), atualiza a Constituição se necessário e arquiva a especificação. O arquivamento é recusado enquanto houver tarefas pendentes, o delta não estiver aplicado ou o QA tiver falhado.
93
99
 
94
- Assim que a implementação estiver totalmente concluída e verificada, este comando analisa o que precisa ser atualizado na Constituição global do projeto com base na nova implementação e arquiva a spec concluída. Ele segue **Instruções de Arquivamento** padronizadas que garantem que as lições aprendidas sejam capturadas no memorial do projeto e qualquer limpeza específica do projeto seja realizada.
100
+ Para fluxos e dicas que cobrem bugs, redimensionamento, mudanças após a implementação, QA com falha e outros casos especiais, veja [Fluxos de Trabalho e Dicas](docs/pt/workflows.md).
95
101
 
96
102
  ---
97
103
 
@@ -100,7 +106,7 @@ Assim que a implementação estiver totalmente concluída e verificada, este com
100
106
  Enquanto o Specforce potencializa seus agentes de IA, os humanos interagem principalmente através de dois comandos de terminal:
101
107
 
102
108
  ### 1. Inicialização do Projeto
103
- Configure a governança e os kits de agentes para o seu projeto.
109
+ Configure a governança e as skills dos agentes para o seu projeto.
104
110
  ```bash
105
111
  specforce init
106
112
  ```
@@ -115,9 +121,8 @@ specforce console
115
121
 
116
122
  ## 🛠️ Agentes de IA e Ferramentas Suportadas
117
123
 
118
- O Specforce Kit foi projetado para ser agnóstico a ferramentas, mas vem com kits pré-construídos e suporte nativo a comandos slash para os assistentes de codificação de IA mais populares:
124
+ O Specforce Kit foi projetado para ser agnóstico a ferramentas e instala suas skills nativamente para os assistentes de programação com IA mais populares:
119
125
 
120
- - **Gemini CLI** (Google)
121
126
  - **Claude Code** (Anthropic)
122
127
  - **Qwen** (Alibaba)
123
128
  - **Kimi Code** (Moonshot AI)
@@ -125,6 +130,7 @@ O Specforce Kit foi projetado para ser agnóstico a ferramentas, mas vem com kit
125
130
  - **KiloCode**
126
131
  - **Codex**
127
132
  - **Antigravity**
133
+ - **Cursor**
128
134
 
129
135
  *Não vê sua ferramenta favorita? Aceitamos PRs para adicionar novos kits!*
130
136
 
@@ -139,12 +145,13 @@ O Specforce Kit foi projetado para ser agnóstico a ferramentas, mas vem com kit
139
145
  npm i -g @jeancodogno/specforce-kit
140
146
  ```
141
147
 
142
- **A partir do Código Fonte (Requer Go 1.26+ e Make)**
148
+ **A partir do Código-Fonte (Requer Go 1.26+ e Make)**
143
149
  ```bash
144
150
  git clone https://github.com/jeancodogno/specforce-kit.git
145
151
  cd specforce-kit
146
152
  make build
147
- make install
153
+ # Binary 'specforce' is created in the root.
154
+ # You can move it to your PATH manually or run it from here.
148
155
  ```
149
156
 
150
157
  ---
@@ -153,12 +160,13 @@ make install
153
160
 
154
161
  Para um mergulho mais profundo no Specforce Kit, confira nossa documentação oficial:
155
162
 
156
- - [Primeiros Passos e Fluxo de Trabalho](docs/pt/getting-started.md): Configuração do ambiente, primeiros passos e o ciclo de vida recomendado do Desenvolvimento Orientado por Especificação.
157
- - [Suporte a Git Worktree](docs/pt/git-worktrees.md): Guia para descoberta de especificações entre branches, console unificado e restrições de apenas leitura.
158
- - [Artefatos](docs/pt/artifacts.md): Detalhes sobre os arquivos gerados (Constituição, Requisitos, Design, Tarefas).
163
+ - [Primeiros Passos e Fluxo de Trabalho](docs/pt/getting-started.md): Configuração do ambiente, primeiros passos, atualizações e o ciclo de vida recomendado do Desenvolvimento Orientado por Especificação.
164
+ - [Fluxos de Trabalho e Dicas](docs/pt/workflows.md): Fluxos passo a passo, dicas e o que fazer quando uma etapa fica bloqueada.
165
+ - [Suporte a Git Worktree](docs/pt/git-worktrees.md): Guia para descoberta de especificações entre branches, console unificado e restrições de somente leitura.
166
+ - [Artefatos](docs/pt/artifacts.md): Os arquivos gerados (Constituição, Requisitos, Design, Tarefas), tamanhos de especificação, deltas de módulo e o relatório de QA.
159
167
  - [Configuração](docs/pt/configuration.md): Guia para personalizar hooks e instruções.
160
- - [Referência da CLI](docs/pt/cli.md): Uso do terminal e comandos slash.
161
- - [Ferramentas Suportadas](docs/pt/supported-tools.md): Lista de agentes de IA e assistentes de codificação suportados nativamente.
168
+ - [Referência da CLI](docs/pt/cli.md): Todos os comandos e flags do terminal.
169
+ - [Ferramentas Suportadas](docs/pt/supported-tools.md): Agentes de IA suportados nativamente e como invocar as skills em cada um.
162
170
 
163
171
  ---
164
172
 
@@ -176,14 +184,14 @@ export PATH="$(npm config get prefix)/bin:$PATH"
176
184
  **Correção para Windows:**
177
185
  Certifique-se de que `%AppData%\npm` esteja em suas variáveis de ambiente.
178
186
 
179
- Para uma resolução de problemas mais detalhada, veja [Primeiros Passos: Resolução de Problemas](docs/pt/getting-started.md#troubleshooting).
187
+ Para uma resolução de problemas mais detalhada, veja [Primeiros Passos: Solução de problemas](docs/pt/getting-started.md#solução-de-problemas).
180
188
 
181
189
  ---
182
190
 
183
191
  ## 🤝 Contribuindo
184
- Contribuições são bem-vindas! Veja nosso [CONTRIBUTING.md](CONTRIBUTING.md) para aprender como adicionar suporte para novos agentes de IA ou melhorar os kits existentes.
192
+ Contribuições são bem-vindas! Veja nosso [CONTRIBUTING.pt.md](CONTRIBUTING.pt.md) para aprender como adicionar suporte para novos agentes de IA ou melhorar os kits existentes.
185
193
 
186
194
  ---
187
195
 
188
196
  ## 📜 Licença
189
- O Specforce Kit é lançado sob a **Licença MIT**. Veja [LICENSE](LICENSE) para detalhes.
197
+ Lançado sob a **Licença MIT**. Veja [LICENSE](LICENSE) para detalhes.
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@jeancodogno/specforce-kit",
3
- "version": "1.0.0-beta.3",
4
- "description": "SpecForce Kit CLI - Distributed via Native Binaries",
3
+ "version": "1.0.0-rc.1",
4
+ "description": "Specforce — Spec-Driven Development for AI agents",
5
5
  "repository": {
6
6
  "type": "git",
7
7
  "url": "git+https://github.com/jeancodogno/specforce-kit.git"
@@ -22,11 +22,11 @@
22
22
  "LICENSE"
23
23
  ],
24
24
  "optionalDependencies": {
25
- "@jeancodogno/specforce-kit-linux-x64": "1.0.0-beta.3",
26
- "@jeancodogno/specforce-kit-linux-arm64": "1.0.0-beta.3",
27
- "@jeancodogno/specforce-kit-darwin-x64": "1.0.0-beta.3",
28
- "@jeancodogno/specforce-kit-darwin-arm64": "1.0.0-beta.3",
29
- "@jeancodogno/specforce-kit-win32-x64": "1.0.0-beta.3"
25
+ "@jeancodogno/specforce-kit-linux-x64": "1.0.0-rc.1",
26
+ "@jeancodogno/specforce-kit-linux-arm64": "1.0.0-rc.1",
27
+ "@jeancodogno/specforce-kit-darwin-x64": "1.0.0-rc.1",
28
+ "@jeancodogno/specforce-kit-darwin-arm64": "1.0.0-rc.1",
29
+ "@jeancodogno/specforce-kit-win32-x64": "1.0.0-rc.1"
30
30
  },
31
31
  "author": "Jean Codogno <jeancarlo.eng.comp@gmail.com>",
32
32
  "license": "MIT"