ZynplexZPX Forgeby Zynplex
Empezar.md

Inicio rápido

1. Crea tu cuenta

Abre Crear cuenta y elige Continuar con GitHub. Usa una cuenta de GitHub con correo verificado. Si recibiste una invitación, entra con la cuenta asociada al correo invitado.

2. Registra tu empresa

En el onboarding escribe el nombre de la empresa y para qué usarán ZPX Forge. Tu empresa queda activa de inmediato.

3. Conecta GitHub

En GitHub → Instalar en GitHub eliges la cuenta u organización y los repos que ZPX Forge puede ver. Al volver, la instalación queda vinculada a tu empresa.

Para instalarla debes administrar esa cuenta en GitHub. Es la forma de evitar que alguien vincule repos que no le pertenecen.

4. Crea un proyecto y agrega sus carpetas de código

Un proyecto puede tener uno o varios repos: front, back, un monorepo app… Uno de ellos es la casa de las specs (donde vive specs/ de SpecKit).

Con Pro puedes elegir Partir de un proyecto base en el paso de arquitectura. Al crear el proyecto, la ficha incluye el diseño, la primera entrega sugerida, su prueba de aceptación y las señales que conviene medir. Claude o Codex consulta ese mismo diseño con zpx context --json.

5. Protege las ramas

En cada repo del proyecto, Proteger develop y main crea una regla en GitHub: esas ramas solo cambian por pull request, sin borrado ni force-push.

6. Invita a tu equipo

Con Pro, en Equipo invitas por correo con un rol. Cada persona puede tener además un rol distinto en un proyecto concreto.

Desde aquí, cada push, PR y check de tus repos aparece en la actividad del proyecto.

Respaldo de entrega con Pro

En Proyecto → Hitos, acuerda un resultado con la persona que va a recibirlo. Selecciona el repositorio, el workflow, el archivo de prueba y los nombres exactos del job y del paso. El workflow debe ejecutar la prueba acordada en un push a la rama de producción. Consulta CI en GitHub desde el hito. Si falta la ejecución de ese commit, la evidencia sigue pendiente.

Desde el hito comprobado, crea la entrega, revisa los riesgos y comparte la ficha aprobada. La persona designada acepta esa versión o pide correcciones en su ficha privada. Para acompañar este recorrido con tu agente, abre Instrucciones para Claude o Codex.

Ejemplo de prueba de aceptación en GitHub Actions

Para un proyecto Python con una prueba de aislamiento en unittest, este workflow ejecuta un caso concreto. Sustituye la rama, el módulo y el método por los de tu proyecto e instala sus dependencias antes del paso de prueba. Confirma con el cliente qué comportamiento demuestra el caso.

name: Acceptance
on:
  push:
    branches: [main]
jobs:
  acceptance:
    name: Customer acceptance
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-python@v5
        with:
          python-version: "3.12"
      - name: Verify customer isolation
        run: python -m unittest tests.test_isolation.IsolationTest.test_other_customer_cannot_read

Guarda el workflow en .github/workflows/acceptance.yml. En el hito selecciona ese workflow, tests/test_isolation.py, job Customer acceptance y paso Verify customer isolation. El resultado solo está observado cuando Forge encuentra la ejecución del commit y del paso acordados.

Activa Pro

Individual permite una empresa y hasta dos proyectos de uso personal. Pro cuesta US$10 por miembro y incluye empresas, proyectos y miembros sin límite, feedback del equipo y respaldo de entrega con evidencia de CI. Inicia sesión y abre Inicio de la empresa para consultar las condiciones y activar Pro.