Redactar entradas no tecnicas eficaces

DevSpeak esta diseñado para transformar requisitos informales en especificaciones tecnicas formales, pero la calidad de la salida depende en gran medida de la calidad de la entrada.

¿Por que redactar una entrada eficaz?

Redactar una entrada no tecnica eficaz es esencial para generar especificaciones tecnicas precisas y accionables. Garantiza que el LLM comprenda la intencion y el contexto de los requisitos, reduciendo el riesgo de interpretaciones incorrectas y errores.

Como redactar una entrada eficaz

Para redactar una entrada no tecnica eficaz, ten en cuenta las siguientes buenas practicas:

  • Se especifico: Proporciona descripciones claras y concisas de las funciones y funcionalidades que deben abordarse.
  • Usa lenguaje sencillo: Evita la jerga tecnica y la terminologia compleja, y centra la descripcion en el valor de negocio y la experiencia del usuario.
  • Proporciona contexto: Incluye informacion de fondo relevante, restricciones y supuestos para ayudar al LLM a comprender el contexto mas amplio.

    • Impacto en la salida

    La calidad de la entrada no tecnica influye significativamente en la estructura, el tono y el enfoque de la especificacion tecnica generada. Por ejemplo, una entrada clara y especifica puede dar como resultado una especificacion detallada y accionable, mientras que una entrada vaga y ambigua puede producir una especificacion generica y poco util.

    Buenas practicas

    Al redactar una entrada no tecnica, ten en cuenta las siguientes buenas practicas:

  • Revisa y refina: Revisa la especificacion tecnica generada y refina la entrada segun sea necesario para garantizar exactitud e integridad.
  • Itera: Experimenta con distintas entradas y refinealas segun la salida generada.