Puntos Clave de Colaboración con Stakeholders
Enviar software de Solana es solo la mitad del trabajo de un líder técnico. La otra mitad es colaborar con el producto y un conjunto más amplio de stakeholders: ejecutivos, auditores, comunidad, poseedores de tokens y proveedores. Esa colaboración no es un teatro de habilidades blandas. Es la disciplina de convertir peticiones ambiguas en diseños construibles, dimensionar el riesgo honestamente, adaptar el proceso a las realidades de mainnet, financiar el trabajo de la plataforma y dar forma a la hoja de ruta, y comunicar bajo presión.
Esta página es el mapa conceptual para Colaboración con Producto y Stakeholders: requisitos a especificaciones técnicas, estimación y riesgo, proceso (Scrum / Kanban / SAFe), priorización de plataforma y deuda técnica, contribuciones a la hoja de ruta y comunicación con stakeholders.
Resumen
- La colaboración con stakeholders es el bucle continuo que convierte los resultados de negocio en especificaciones técnicas de Solana, adjunta rangos y riesgos honestos, prioriza características frente al trabajo de endurecimiento, y comunica el estado sin falsa certeza.
- Por Qué Importa: El código que compila y se despliega aún falla el producto si resuelve el problema equivocado, llega después de un retraso sorpresa de auditoría, o se envía sobre rutas RPC y de actualización frágiles que nadie financió.
- Conceptos Clave: requisito, especificación técnica, no-objetivos, criterios de aceptación, estimación de tres puntos, registro de riesgos, Definición de Hecho, deuda como riesgo, temas de hoja de ruta (crecer / endurecer / escalar), hechos-impacto-acciones-desconocidos.
- Cuándo Usar Este Modelo: Cualquier característica que toque fondos, autoridades, tokenomics, integraciones CPI, o fechas de mainnet; cualquier ciclo de planificación donde el producto necesite una fecha de envío antes de que ingeniería tenga un diseño escrito.
- Limitaciones / Compensaciones: Las especificaciones, rangos y ceremonias cuestan tiempo de calendario. El acuerdo verbal ligero está bien para tickets pequeños y reversibles; el rigor completo se gana su costo cuando hay dinero, seguridad o compromisos públicos involucrados.
- Temas Relacionados: De Requisitos a Especificaciones Técnicas, Estimación y Riesgo, Priorización de Plataforma y Deuda Técnica, Contribuciones a la Hoja de Ruta, Comunicación con Stakeholders, Haciendo que el Proceso Funcione (Scrum/Kanban/SAFe).
Fundamentos
Un requisito establece un resultado de negocio: "los usuarios hacen staking de SOL y obtienen rendimiento del pool". No nombra PDAs, gráficos CPI, autoridades de pausa, ni clientes IDL, y no debería hacerlo. El producto es dueño del resultado y la métrica de éxito; ingeniería es dueña del cambio de estado en cadena y el piso de seguridad.
Una especificación técnica es la traducción de ingeniería: cuentas y propiedad, instrucciones y códigos de error, CPIs, impacto en el cliente e indexador, modelo de autoridad para cualquier cambio de tokenomics, no-objetivos para esta fase, y criterios de aceptación que sean comprobables (casos LiteSVM, fallos de simulación, UX confirmado-antes-de-toast). Sin ese documento, producto e ingeniería pueden creer que acordaron mientras tienen imágenes diferentes de "hecho".
La brecha entre el requisito y la especificación es donde vive el juicio. Solana añade ambigüedad específica que el CRUD web rara vez expone:
requisito: "los usuarios hacen staking y obtienen rendimiento"
preguntas abiertas que ingeniería debe forzar a la luz
-> ¿qué estándar de token y decimales?
-> autoridad de la bóveda: ¿semillas PDA vs multisig vs gobernanza?
-> ¿ruta de pausa / emergencia y quién puede invocarla?
-> ruta de lectura: ¿stream de eventos del indexador vs RPC getAccountInfo?
-> puerta de lanzamiento: ¿solo devnet, aprobación de auditoría, multisig mainnet?La ambigüedad del producto es cualquier pregunta abierta sobre el comportamiento previsto que ninguna cantidad de cargo test o restricciones de Anchor puede resolver. Escribir no-objetivos ("auto-compound es v2", "sin wallet móvil en esta fase") no es evasión; es un límite comprobable que evita que el alcance a mitad de sprint se expanda silenciosamente.
Los stakeholders en esta sección son más amplios que "el PM". Los ejecutivos se preocupan por el riesgo y las fechas. Los auditores necesitan diffs y pasos de reproducción. La comunidad y los poseedores de tokens se preocupan por la honestidad del lanzamiento y la seguridad de los fondos. Los proveedores de RPC y wallets se preocupan por el tráfico y las interrupciones. Los líderes técnicos traducen una verdad interna a un lenguaje apropiado para la audiencia sin inventar una segunda verdad para cada canal.
Mecánicas e Interacciones
La colaboración es un pipeline, no una sola reunión. Cada paso detecta un modo de fallo diferente.
requisito (resultado + métrica)
-> descubrimiento (volumen, fondos en riesgo, cumplimiento, carga pico, tolerancia a fallos)
-> alcance + no-objetivos (esta fase vs más tarde)
-> especificación técnica (cuentas, ix, CPI, autoridades, ruta de lectura)
-> criterios de aceptación (pruebas, simulación, errores UX)
-> rango de estimación + registro de riesgos (no una única fecha heroica)
-> compromiso de proceso (tarjetas de sprint/PI con puertas de DoD)
-> ubicación en la hoja de ruta (crecer / endurecer / escalar + dependencias)
-> estado continuo y comunicaciones de incidentes (hechos, impacto, acciones, desconocidos)Especificaciones antes del compromiso
El compromiso de sprint o PI sin un diseño escrito es cómo los equipos inventan fechas que las auditorías y las ventanas de multisig destruyen más tarde. Incluso un one-pager es suficiente para trabajo pequeño. Las características que tocan fondos merecen una revisión de diseño con el producto presente para que las compensaciones (alcance vs seguridad vs fecha) se elijan deliberadamente. Las especificaciones se enlazan a un ADR cuando la arquitectura se bifurca (por ejemplo, cuenta Borsh vs zero-copy book, o ruta nativa vs Anchor).
Estimación y riesgo
Las estimaciones de Solana fallan cuando se tratan como CRUD simple. Las integraciones CPI, las colas de auditoría, el tiempo de preparación de Squads u otros multisigs, los mercados de tarifas y la fiabilidad de aterrizaje, el IDL y los trenes de lanzamiento de clientes, y los backfills de indexadores añaden varianza. Utilice estimaciones de tres puntos (optimista / probable / pesimista) con suposiciones explícitas, y coloque buffers de auditoría y despliegue fuera de la línea de características para que el producto no confunda "código completo" con "mainnet en vivo".
Un registro de riesgos nombra la probabilidad, el impacto y la mitigación por separado de la lista de tareas. La obsolescencia de oráculos CPI, la clasificación regulatoria de un token, o "auditoría Crítica bloquea el lanzamiento" son entradas del plan, no sorpresas a mitad de lanzamiento. Los spikes limitan el tiempo de una incógnita nombrada con un resultado binario de pasar/fallar antes del compromiso; no reemplazan la especificación.
Proceso que respeta la cadena
Scrum, Kanban y SAFe funcionan si el proceso sirve a la entrega en lugar de al teatro de certificación. Adaptaciones prácticas:
| Mecanismo | Práctica adaptada a Solana |
|---|---|
| Definición de Hecho | Pruebas en verde, IDL publicado si el programa cambió, despliegue en devnet con tx enlazada, runbook/monitor si hay impacto en ops |
| Columnas del tablero | Spec/RFC → En Desarrollo → Revisión → Devnet → Listo para Mainnet → Hecho |
| Límites de WIP | Los PRs de programas son pesados; limitar trabajo concurrente en desarrollo |
| Expedite | Solo Sev-1 y auditoría Crítica; un único comandante de incidente tira del carril |
| Capacidad | Reservar ~20% para incidentes, revisiones y endurecimiento; no planificar el 100% del tiempo de calendario |
El despliegue en Mainnet no es una casilla de verificación del viernes por la tarde. Las historias que solo llegan a "fusionado" sin evidencia en devnet deberían rodar automáticamente. La planificación PI de SAFe debería tratar a los habilitadores del ecosistema (Agave, Anchor, actualizaciones de kit) como de primera clase, no como ocurrencias tardías.
Deuda técnica y trabajo de plataforma
La deuda enmarcada como "limpieza" pierde todas las peleas de priorización. La deuda enmarcada como dólares de riesgo, MTTR, tasa de fallo de cambio, o "repetición de la última clase Sev-1" puede ganar un epic patrocinado. Categorías que recurren en equipos de Solana: seguridad (restricciones, backlog de auditoría, simulacros de pausa), entrega (compilaciones verificables, automatización de despliegue, sincronización de IDL), tiempo de ejecución (failover de RPC, política de aterrizaje, retraso del indexador), y ecosistema (impacto de SIMD de Agave, actualizaciones de Anchor, migraciones de @solana/kit).
La capacidad continua (a menudo ~20%, a veces 10% con un plan de pago explícito) supera los "trimestres de deuda" de gran impacto que desencadenan congelaciones de características y reacciones negativas. Cada epic de deuda necesita un resultado medible y un patrocinador de producto nombrado.
Contribuciones a la hoja de ruta
Las hojas de ruta de producto muestran naturalmente victorias orientadas al usuario. Ingeniería debe inyectar temas de crecer / endurecer / escalar o los lanzamientos se enviarán sobre cimientos frágiles. Ingeniería propone estrategia técnica, hitos de seguridad y calendarios de actualización; producto prioriza resultados con compensaciones visibles. Mantenga una hoja de ruta pública separada del grafo de dependencias interno para que las fechas de la comunidad no se inventen a partir de diapositivas de marketing.
Ejemplo de ruta crítica interna:
audit_signoff --> multisig_deploy --> withdraw_v2_mainnet
kit_migration --> mobile_client --> withdraw_v2_UXComunicación bajo estrés
El estado y las malas noticias siguen un orden: hechos, impacto, acciones, desconocidos. Los ejecutivos reciben peticiones de decisión y riesgo. La comunidad recibe versiones más cortas de los mismos hechos. Los auditores reciben diffs y repro, no vibras. Durante Sev-1, una única voz de comandante de incidente previene líneas de tiempo contradictorias. Nunca especule públicamente sobre la identidad del atacante, y no prometa compensación antes de la revisión de la política. Los ingenieros evitan comentarios ad-hoc sobre el precio del token; redirigir a producto o asesoría legal.
Consideraciones Avanzadas y Aplicaciones
A escala, el mismo bucle debe sobrevivir al cambio de requisitos, dependencias de múltiples escuadrones y escrutinio público de los poseedores de tokens.
Cambio de requisito a mitad de camino. Modifique la especificación y reestime explícitamente. La absorción silenciosa de alcance parece un fallo de entrega y quema la confianza dos veces: una con producto cuando la fecha se desliza sin explicación, y otra con ingenieros que aprendieron que la honestidad es castigada.
Veto de seguridad vs apuesta de producto. El producto es dueño de la apuesta del resultado del usuario; el líder técnico es dueño del piso de seguridad. Documente el desacuerdo y compromiso: si ingeniería no enviará un diseño sin una ruta de pausa o una puerta de auditoría, escriba el memorándum de riesgo para que un ejecutivo pueda elegir fecha versus seguridad a sabiendas, no por presión informal.
Matriz de audiencias (condensada):
| Audiencia | Necesidades | Modo de fallo si se maneja mal |
|---|---|---|
| PM / producto | Resultado, métrica, compensaciones | Caos de alcance, fechas falsas |
| Ejecutivo / junta | Riesgo, dinero, línea de tiempo | Sorprendido por costo de auditoría o incidente |
| Auditores | Diffs, alcance, repro | Escalada a liderazgo, lanzamiento bloqueado |
| Comunidad / holders | Estado honesto, seguridad de fondos | Rumor, pánico, confianza rota |
| Proveedores (RPC, wallet) | Tráfico, ventanas de rotura | Interrupciones silenciosas a mitad de lanzamiento |
DAO y gobernanza abierta añaden una superficie de RFC pública. Trate las propuestas de gobernanza como requisitos que aún necesitan especificaciones técnicas y modelos de autoridad; "la comunidad decide" sin una ruta de actualización nombrada no es un diseño.
Limitación honesta: Este modelo maneja bien los desconocidos conocidos. No puede inventar la pregunta que nadie pensó hacer. Los talleres de descubrimiento y los spikes reducen ese riesgo residual; no lo eliminan. El exceso de proceso en tickets reversibles también es un modo de fallo: igualar el rigor al riesgo irreversible de fondos y reputación.
| Enfoque | Fortaleza | Debilidad | Mejor ajuste |
|---|---|---|---|
| Solo verbal | Inicio más rápido | Sin aceptación compartida | Tickets pequeños y reversibles |
| Spec de una página + rango | Baja sobrecarga, fuerza no-objetivos | Registro de riesgos ligero | Características pequeñas con patrones conocidos |
| Spec completa + revisión de diseño + riesgos | Verdad compartida antes del código | Costo de calendario antes del primer compromiso | Rutas de fondos, autoridades, CPI |
| Temas PI / trimestrales con cuadro de mando | Vista de cartera de deuda y características | Ceremonia si el equipo es diminuto | Entrega multi-escuadrón o empresarial |
Conceptos Erróneos Comunes
- "Si las pruebas pasan, la característica está correctamente especificada." Las pruebas verifican el código contra la especificación; no verifican que la especificación coincida con el resultado del negocio.
- "Una única fecha de envío muestra confianza." Una única fecha sin rango, suposiciones o buffer de auditoría es falsa precisión. Los rangos con riesgos nombrados son más creíbles.
- "La seguridad de Rust y Anchor significa menos riesgo de producto." La memoria y las restricciones de cuenta reducen las clases de errores de código. No deciden el producto correcto, el modelo de autoridad o la puerta de lanzamiento.
- "La deuda técnica es pulido opcional." La falta de suites de regresión, URLs RPC únicas y clientes IDL obsoletos se convierten en costo de incidentes. Enmarcar la deuda como riesgo y rendimiento.
- "El proceso es una sobrecarga; solo envía." El proceso no adaptado es una sobrecarga. DoD adaptado, límites de WIP y reglas de expedite protegen el tiempo de revisión y la seguridad de mainnet.
- "Los ingenieros no deberían tocar la hoja de ruta." Sin temas de endurecimiento y escalado, producto solo planea características. Ingeniería debe proponer; producto aún prioriza.
- "Las actualizaciones a la comunidad necesitan menos precisión que las actualizaciones a ejecutivos." Mismos hechos, forma más corta. Diferentes verdades por audiencia destruyen la confianza cuando las capturas de pantalla se comparan.
- "Los no-objetivos son rechazar trabajo." Los no-objetivos protegen esta fase y casi siempre se emparejan con un ticket de seguimiento para la porción diferida.
Preguntas Frecuentes
¿Cuál es la diferencia entre un requisito y una especificación técnica?
Un requisito establece el resultado del negocio y la métrica de éxito. Una especificación técnica establece cuentas, instrucciones, CPIs, autoridades, no-objetivos y criterios de aceptación comprobables. Producto confirma que los criterios aún coinciden con el resultado antes de que el equipo se comprometa.
¿Quién debe escribir la especificación técnica?
Ingeniería la escribe porque codifica los internos del sistema. Producto revisa los criterios de aceptación y el alcance. Las rutas sensibles a la seguridad pueden añadir una revisión de diseño antes de que las estimaciones se congelen.
¿Por qué estimaciones de tres puntos en lugar de un solo número?
Los escenarios optimista, probable y pesimista exponen la varianza del trabajo CPI, auditorías y puertas de despliegue. Producto puede planificar con incertidumbre en lugar de tratar un punto medio como una promesa.
¿Qué pertenece fuera de la estimación de la característica?
Tiempo de cola de auditoría, ventanas de firma de multisig y buffers de despliegue en mainnet. Etiquételos por separado para que "devnet hecho" no se confunda con "mainnet en vivo".
¿Cómo debería cambiar Scrum o Kanban para Solana?
Incluir el despliegue en devnet y la publicación de IDL en la Definición de Hecho, separar la preparación para mainnet de la fusión, reservar capacidad para incidentes y hacer visibles los estados bloqueados como "esperando auditoría / esperando multisig".
¿Cómo consigo que producto financie deuda técnica?
Adjunte una métrica (MTTR, tasa de fallo de cambio, regresión de clase de exploit), un riesgo si se difiere, un costo claro y una compensación de características. Nombre un patrocinador de producto por epic.
¿Qué temas debería poner ingeniería en la hoja de ruta?
Crecer (resultados de usuario), endurecer (seguridad, auditorías, multisig, simulacros de pausa) y escalar (RPC, indexador, actualizaciones de kit/runtime). Muestre dependencias para que las fechas de ruta crítica sean negociables a sabiendas.
¿Cómo deben estructurarse las malas noticias?
Hechos, impacto en el usuario o negocio, acciones tomadas o propuestas, y desconocidos con un tiempo de próxima actualización. Mismos hechos para cada audiencia; ajuste la longitud y la jerga, no la sustancia.
¿Qué sucede cuando los requisitos cambian después del compromiso?
Modifique la especificación, reestime y renegocie el alcance o la fecha abiertamente. La absorción silenciosa de cambios convierte una decisión de requisitos en un fallo de ejecución falso.
¿Cuándo es un proceso completo excesivo?
Trabajo trivial, totalmente reversible con un único propietario. Use acuerdo verbal o una nota de media página. Aumente el rigor cuando aparezcan fondos, autoridades, fechas públicas o dependencias multi-equipo.
¿Quién es dueño de la fecha de la hoja de ruta para mainnet?
Producto puede ser dueño de la narrativa de marketing, pero las fechas de mainnet no deberían comprometerse sin una puerta de ingeniería como devnet-hecho más criterios acordados de auditoría o multisig. Las puertas de seguridad no son pulido opcional.
¿Cómo encajan los spikes en este modelo?
Un spike responde una pregunta nombrada del registro de riesgos en un tiempo limitado con un resultado de pasar/fallar. Alimenta una mejor estimación; no es un sustituto de escribir no-objetivos y criterios de aceptación.
Relacionados
- De Requisitos a Especificaciones Técnicas - cuentas, instrucciones, no-objetivos y criterios de aceptación
- Estimación y Riesgo - rangos de tres puntos, buffers y registros de riesgos
- Priorización de Plataforma y Deuda Técnica - deuda como métricas de riesgo y epics patrocinados
- Contribuciones a la Hoja de Ruta - temas de crecer, endurecer, escalar y grafos de dependencias
- Comunicación con Stakeholders - plantillas de estado, incidentes y matriz de audiencias
- Haciendo que el Proceso Funcione (Scrum/Kanban/SAFe) - DoD, WIP, expedite y habilitadores de PI
- Mejores Prácticas de Colaboración con Producto - lista de verificación condensada para ingeniería y producto
Versiones de Stack: Esta página es conceptual y no está vinculada a una versión específica del runtime. Los tutoriales hermanos pueden hacer referencia a las versiones actuales de Agave, Anchor, LiteSVM, Surfpool y
@solana/kitdonde la herramienta es importante.