# Trabaja conmigo en ZPX Forge

Trabaja desde el repositorio con mi agente y mi suscripción. Usa Forge para consultar el acuerdo con el cliente, coordinar tareas y dejar constancia de la entrega. El equipo comparte ese historial aunque cambie de agente o de sesión. Respeta el alcance que te autorizo en este chat.

## Identifica el proyecto

1. Ejecuta `zpx version` y `zpx doctor --json`. Si falta el CLI, la persona puede instalarlo con `uv tool install zpx` o actualizarlo con `uv tool upgrade zpx`.
2. Si falta acceso, pídeme que habilite Reportes del CLI en Equipo → perfil y autorice `zpx login` en mi navegador con mi cuenta de GitHub. Conserva las credenciales en mi máquina.
3. Usa `zpx whoami` y `zpx projects` para identificar mi cuenta y proyecto. Cuando el destino esté confirmado, vincula este directorio con `zpx use EMPRESA/PROYECTO --here`. Sustituye los identificadores de ejemplo por los reales.
4. Lee `zpx context --json`. Comprueba el proyecto, tus responsabilidades, el plan y los hitos en `milestones`. Con autorización para configurar este repo, ejecuta `zpx skill install` y lee el AGENTS.md y las skills instaladas. Si `harness.sync.required` indica cambios, sincroniza y comprueba el contexto de nuevo. Consulta conmigo cualquier conflicto con archivos editados localmente.

## Antes de construir

Desde una idea, ayúdame a escribir el primer resultado que pueda demostrar al cliente. Desde un repositorio existente, con el CLI 0.2.4 puedes usar `zpx audit --json` para identificar archivos de entorno versionados y workflows de GitHub Actions en el índice local. Este diagnóstico solo examina nombres de archivos.

En Proyecto → Hitos, el editor propone un criterio comprobable, cómo demostrarlo, exclusiones, fecha y quién decide. Esa persona recibe una ficha privada y acepta la revisión o pide cambios. Trabaja contra la última revisión aceptada. Si cambia la promesa, propón otra revisión.

## Durante el trabajo

Lee `zpx today` y `zpx plan`. Abre la tarea real con `zpx task show T003`. Cuando la persona confirme la asignación, usa `zpx task take T003` y `zpx task start T003 --agent codex --branch mi-rama` con el agente y la rama reales. Registra avances con `zpx task progress T003 "resultado comprobado"`. Añade `--check tests=pass` solo después de ejecutar esas pruebas. Anota el commit probado y los pendientes. Usa `zpx task blocked T003 "motivo"` ante un bloqueo. Consulta `zpx can-publish RAMA` antes de publicar y respeta la autorización de la persona. Omite credenciales y datos del cliente en reportes.

## Respaldo de entrega y aceptación (Pro)

En el hito, vincula el repositorio y el workflow de push de la rama de producción con el archivo de prueba y los nombres exactos del job y el paso. Un revisor comprueba que esa prueba cubre el criterio. Forge consulta GitHub para ese commit. Cada nuevo commit necesita su ejecución. Cambiar el workflow o la prueba acordados requiere renovar el acuerdo.

Distingue lo **declarado** por el equipo de lo **observado** por Forge en GitHub. Un **riesgo aceptado** identifica a quien lo asume y su motivo. Cuando falte CI, indícalo como pendiente.

Desde el hito comprobado, quien tiene permiso crea la entrega. Su responsable decide si publica la ficha de solo lectura, vigente durante 30 días. El cliente designado entra con su correo verificado en la ficha privada para aceptar esa versión o pedir correcciones. Dime qué versión y commit se entregaron, qué evidencia puedo abrir y de quién depende la próxima decisión.

Para ayuda contextual usa `zpx help`, `zpx guide hito` y `zpx guide evidencia`. Consulta la documentación completa en https://www.zpxforge.com/es/llms-full.txt.
