---
title: "Cómo contribuir"
description: "Por qué Tanrei no acepta contribuciones externas, cómo informar de un error o hacer una pregunta, y dónde están las reglas."
url: "https://tanrei.chnotchy.com/es/project/contributing/"
last_updated: 2026-10-18T00:51:38.000Z
---

# Cómo contribuir

> Por qué Tanrei no acepta contribuciones externas, cómo informar de un error o hacer una pregunta, y dónde están las reglas.

> [!NOTE]
> **No se aceptan contribuciones externas**
>
> El repositorio es público en [github.com/chnotchy/tanrei](https://github.com/chnotchy/tanrei), para que cualquiera pueda leer cómo se hace Tanrei. Todos los cambios los hacen los mantenedores: las pull requests externas se cierran sin fusionarse, y no se aceptan propuestas de componentes ni de tokens nuevos. El motivo es la cadena de suministro: Tanrei es código que se ejecuta dentro de los productos de otras personas, cada cambio externo es una vía para que llegue a ellos código que sus mantenedores no escribieron, y la situación actual de la seguridad hace de eso un riesgo que el proyecto no asume. Para informar de un error o hacer una pregunta, [abre una incidencia](https://github.com/chnotchy/tanrei/issues). Informa de un problema de seguridad en privado, como describe el `SECURITY.md` del repositorio, nunca en una incidencia.

## Dónde están las reglas

El `AGENTS.md` de la raíz del repositorio es la guía de referencia para quien modifica el repositorio, sea una persona o una IA. Es breve, y leerlo primero ahorra tiempo. Cada paquete y cada directorio de código fuente puede añadir un `AGENTS.md` anidado con reglas locales; se aplica el archivo más cercano, y ninguno puede debilitar el de la raíz. El `CONTRIBUTING.md` de la raíz es la versión extensa.

El material más extenso está en el directorio `docs/` del repositorio: la descripción general de la arquitectura y la gobernanza, que dice quién decide qué.

## La forma de un cambio

Todo cambio sigue estos pasos, lo haga quien lo haga.

1. **Parte de la fuente de verdad.** Los cambios en la superficie pública de un componente empiezan en `specs/`. Los cambios en un valor de diseño empiezan en `tokens/`. El código de las plataformas viene después.
2. **Ejecuta las comprobaciones en local.** `pnpm validate`, `pnpm generate` y luego `pnpm check`. Si la comprobación de desviaciones falla, regenera; no edites el archivo generado.
3. **No dejes que una plataforma diga más de lo que hay.** Si no puedes terminar una plataforma, deja su estado como realmente es. La matriz se genera a partir del repositorio y no debe afirmar más de lo que existe.
4. **Añade un changeset** para todo lo que los usuarios puedan ver, y usa Conventional Commits (`feat(web): …`, `fix(tokens): …`, `docs: …`).

## Lo que ningún cambio puede contener

- Colores, radios, tipografía, espaciado, movimiento u opacidad escritos a mano dentro de un componente.
- Imágenes de referencia de las instantáneas actualizadas para que una prueba pase.
- Umbrales de contraste o de accesibilidad rebajados.
- Texto de documentación copiado de otro sistema de diseño. Toda la prosa de Tanrei es original.

## Cambios en la documentación

Este sitio está en `apps/docs/`. La prosa es MDX escrito a mano: el inglés es el idioma de origen, y cada página se traduce a los demás idiomas del sitio (`apps/docs/i18n/README.md` los enumera, e indica cómo registra una traducción a partir de qué se hizo). Las tablas que pueden salir de una especificación, de un archivo de tokens o de la matriz de estado se representan a partir de esos datos y nunca se escriben a mano. Consulta `apps/docs/AGENTS.md` para ver las reglas locales.