Empezar

Un primer paso pequeño y gobernado.

El recorrido útil más corto contiene un artefacto aceptado, una cita desde un documento consumidor y una dependencia obsoleta visible tras un cambio. Los comandos usan la versión publicada compatible actual, leída de los metadatos del paquete al generar el sitio.

1 · Instala en tu repositorio

La CLI comienza con un núcleo pequeño. Las plantillas y los esquemas están disponibles cuando los necesites; amplía la estructura solo si ayuda a tu equipo.

npm install --save-dev --save-exact @prodshape/cli@0.22.1
npx --no-install prodshape init
npx --no-install prodshape validate
npx --no-install prodshape change create CHG-INITIAL

2 · Propón la definición inicial

Añade los primeros artefactos al cambio CHG-INITIAL activo, decláralos en sus operaciones y valida la propuesta. Revísala con las personas que conocen el producto.

3 · Aplica y acepta mediante revisión

Cuando una persona haya aprobado el cambio, aplícalo en una rama y abre una solicitud de cambios. La integración acepta la definición; aplicarla no equivale a aceptarla.

4 · Cita la definición en el trabajo de entrega

Guarda la cita junto al texto consumidor que respalda. Si cambias el artefacto aceptado en otro Product Change, la verificación informará de que la cita está obsoleta.

prodshape inspect ACT-USER
prodshape cite --id ACT-USER --digest <digest>
prodshape citations verify

Las funciones que solo existen en la rama main del repositorio pueden ser más recientes que este paquete publicado.

Guías de adopción

Elige el recorrido que encaja con tu producto.

Empieza un producto nuevo, recupera lo que has aprendido de uno existente o añade ProductShape con cuidado a un repositorio que ya tiene sus herramientas y convenciones.

  1. PRODUCTO NUEVO →Empieza un producto nuevo

    Crea la primera definición del producto y acéptala con el mismo proceso de revisión que usarás para los cambios posteriores.

  2. PRODUCTO EXISTENTE →Recupera un modelo a partir de evidencias

    Propón y revisa un modelo para un producto en uso a partir de documentación, pruebas, conversaciones y otras evidencias.

  3. REPOSITORIO EXISTENTE →Añade ProductShape a un repositorio existente

    Descubre qué cambia durante la inicialización, qué sigue bajo tu control y cómo configurar ProductShape.