contributing-to-technical-strategy

Par bitwarden · ai-plugins

Comment les patterns au niveau des équipes remontent vers le backlog Technical Strategy Ideas de Bitwarden et redescendent via les BW Initiatives vers les epics et stories d'équipe. Couvre la reconnaissance des patterns d'équipe qui appartiennent au backlog TSI, la formulation d'une idée de manière suffisamment claire pour que l'Architecture puisse l'évaluer, le lien entre ARCH idea ↔ BW Initiative, et la définition du travail au niveau epic et story en descendant depuis une initiative. À utiliser lorsqu'on identifie un pattern de friction transverse dépassant le périmètre d'une seule équipe, lorsqu'on remonte des idées au groupe architecture, lorsqu'on cherche à comprendre comment une initiative se rattache à son idée d'origine, ou lorsqu'on découpe le travail au niveau epic depuis une initiative vers une équipe.

npx skills add https://github.com/bitwarden/ai-plugins --skill contributing-to-technical-strategy

La stratégie technique de Bitwarden a une forme verticale : les idées vivent au sommet, les initiatives au milieu, et les épics et histoires au niveau équipe en bas. Le tech lead est le rôle qui traverse cette verticale — repérant les motifs en bas qui méritent d'être au sommet, et traduisant le travail du sommet en histoires que l'équipe livre.

Cette compétence couvre cette verticale complète :

  • Reconnaître une idée qui mérite d'être capturée.
  • La cadrer assez bien pour qu'Architecture l'évalue.
  • Comprendre comment une idée approuvée devient une BW Initiative.
  • Définir le travail au niveau épic et histoire en descendant d'une initiative.

Les références canoniques sont Technical Strategy Ideas et Idea-Based Initiatives. Récupérez-les via get_confluence_page quand les modèles complets ou les définitions de champs complètes sont nécessaires.

Le haut de l'entonnoir : Technical Strategy Ideas

Les Technical Strategy Ideas (TSIs) sont le carnet de commandes d'idées de Bitwarden — la collection organisée des opportunités d'amélioration technique qu'Architecture maintient dans Jira Product Discovery sous le projet ARCH. Les idées sont notées au RICE, catégorisées par thème, et placées sur une feuille de route Now / Next / Later. Celles qui sont priorisées entrent dans le Software Initiative Funnel à la phase Identification.

Reconnaître une idée qui mérite d'être capturée

Créez une TSI quand ces motifs apparaissent :

  • Un motif de douleur à travers plusieurs équipes. Cinq équipes résolvent chacune un problème de gestion d'erreurs différemment. Ce ne sont pas cinq problèmes au niveau équipe ; c'est une seule idée transversale.
  • Un gap architectural ou une dette technique à impact large. La dette existe dans un code partagé, ou son absence bloque d'autres équipes.
  • Une opportunité d'améliorer l'expérience développeur ou la fiabilité opérationnelle à un niveau qu'une seule équipe ne peut pas posséder.
  • Une tendance technologique que Bitwarden devrait évaluer — pas « nous devrions utiliser GraphQL parce que c'est moderne », mais « le coût round-trip de REST est quantifiable ici et ici, et les alternatives méritent d'être évaluées ».
  • Une amélioration de sécurité qui s'étend sur plusieurs systèmes.

Restez au niveau équipe (et ne créez rien) quand :

  • Le problème est contenu au codebase d'une seule équipe et cette équipe peut le résoudre dans le travail normal.
  • Le problème est urgent et nécessite une action immédiate — ceux-ci contournent ce processus ; parlez directement au leadership.
  • C'est une demande de feature pilotée par le produit — elle appartient aux backlogs produit, pas aux TSIs.

Les ingénieurs Staff+ sont les contributeurs principaux aux TSIs, mais les tech leads peuvent absolument et devraient contribuer des idées sourcées de l'expérience de leurs équipes. Les motifs qui émergent à travers les sprints sont un signal qu'Architecture n'a souvent pas d'accès direct.

Bien cadrer une idée

Une TSI ne nécessite pas une proposition architecturale complète. Elle nécessite assez de contexte pour qu'Architecture évalue si cela vaut la recherche. Le modèle TSI a plusieurs sections — celles qui comptent le plus :

  • Problem / Opportunity Statement. Soyez spécifique sur l'état actuel, les points de douleur, et l'opportunité si résolue. « La gestion d'erreurs est incohérente » est vague ; « Cinq motifs différents de gestion d'erreurs existent à travers les clients, causant des difficultés de débogage et de la confusion utilisateur » est actionnable. Quantifiez quand possible — « ~3 bugs par trimestre liés à ceci » ou « ~4 heures par sprint perdues à ceci » rend l'impact concret.
  • Strategic Alignment. Quels OKRs, thèmes stratégiques, ou principes architecturaux cela soutient-il ? Quelles autres initiatives en dépendent-elles ou le permettent-elles ?
  • Target Audience / Stakeholders. Équipes, utilisateurs, ou systèmes qui en bénéficient ; autres affectés ; équipes avec expertise à consulter.
  • Stakeholder & Engagement Map. C'est là que les idées s'enlisent souvent si mal faite. Identifiez les décideurs par nom ou rôle (pas juste les noms d'équipes), les stakeholders à consulter obligatoirement, les stakeholders à informer obligatoirement, et — c'est l'inconfortable — les points de friction connus : où viendra le désaccord ou la résistance, et pourquoi ? Nommer la friction à l'avance est comment les bonnes idées évitent de devenir des propositions techniquement saines qui s'enlisent à l'adoption. Les idées qui reconnaissent la friction gagnent plus de confiance que celles qui ne présentent que l'avantage.
  • Proposed Direction. Haut niveau seulement — ne concevez pas la solution. C'est pour la recherche d'entonnoir. Approche conceptuelle grossière, technologies qui valent la peine d'être considérées, réflexion build/buy/integrate.
  • Operational & Quality Considerations. Métriques clés ou SLIs, contraintes de performance, implications de testabilité, implications self-hosted vs cloud, points de conformité (SOC 2, ISO 27001).
  • Validation Approach. À quoi ressemblerait une preuve de concept minimale ; quels signaux indiqueraient que cela vaut la peine de poursuivre ; quelles hypothèses ont besoin de test.
  • Rough Sizing. Taille de t-shirt, durée attendue, facteurs de complexité.
  • Score RICE pour la priorisation, plus les segments clients et le thème.

Pas tous les champs n'ont besoin d'être remplis parfaitement à la première rédaction. Le Stakeholder & Engagement Map, en particulier, est complété collaborativement entre le propriétaire principal et un examinateur pair avant qu'une idée se déplace de Backlog à Research. Quand une idée est déposée par une équipe, le groupe d'architecture associera le dépositaire à un examinateur — c'est comment la carte se réaffûte.

Ce qui se passe après le dépôt

Architecture trie les nouvelles idées hebdomadairement, met à jour les scores RICE mensuellement, gère le backlog en mid-quarter, et exécute un examen de priorisation trimestriel avec le leadership d'engineering. Les idées approuvées pour la poursuite passent dans le Software Initiative Funnel à la phase Identification.

Les idées qui ne sont pas poursuivies se déplacent à Declined — avec la justification enregistrée. Toutes les idées déclinées restent visibles pour la mémoire institutionnelle, afin que la même idée ne soit pas re-évaluée sans contexte.

Le milieu de l'entonnoir : De l'idée à l'initiative

Quand une idée ARCH est approuvée pour l'entonnoir, un artéfact séparé est créé : un problème BW Initiative dans le projet Jira Bitwarden Company. Ce sont deux records différents pour deux buts différents (voir Idea-Based Initiatives) :

  • L'idée ARCH reste dans Jira Product Discovery. Elle continue de porter le RICE, le thème, le placement sur feuille de route, le modèle TSI complet, et — critiquement — le statut de phase d'entonnoir (1️⃣ Identification jusqu'à 5️⃣ Implementation).
  • La BW Initiative est le record au niveau exécution. Résumé stratégique, shepherd comme assigné, épics enfants pour chaque équipe, liens vers travail connexe à travers les projets, commentaires Jira documentant les décisions et événements de coordination.

Ils sont liés par un travail item link : l'initiative BW « implémente » l'idée ARCH. Ce lien est ce qui laisse quelqu'un dans JPD tracer le statut d'exécution, et quelqu'un dans Jira tracer en arrière vers la justification stratégique.

Un tech lead ne créera généralement pas la BW Initiative — c'est le travail du shepherd pendant Identification. Mais les initiatives sont lues souvent : quand l'une apparaît affectant l'équipe, quand essayant de comprendre pourquoi un shepherd propose une approche spécifique, quand vérifiant le travail connexe dans les équipes adjacentes. Une initiative bien liée répond à trois questions en coup d'œil :

  1. D'où cela vient-il ? Le lien idée ARCH porte la justification stratégique.
  2. Quel travail est en cours ? Les épics enfants montrent l'exécution actuelle à travers les équipes.
  3. Quoi d'autre est connexe ? Les liens « Relates to » capturent les tentatives antérieures, dépendances, tickets opérationnels, coordination transversale.

Quand recevant un épic d'une initiative, prenez cinq minutes pour lire la BW Initiative parente et suivre le lien jusqu'à l'idée ARCH. Le contexte vaut presque toujours le temps.

Le bas de l'entonnoir : Connecter la trace au travail d'équipe

C'est là que vit le travail spécifique au tech lead. Durant Scoping & Commitment, le shepherd crée des épics enfants sous la BW Initiative — généralement un par équipe ou module majeur. L'épic de l'équipe est alors le leur à décomposer.

La mécanique de cette décomposition — règles de qualité d'histoire, quoi inclure, quoi éviter, comment la partager en arrière au shepherd — vivent dans Skill(navigating-the-initiative-funnel). Cette compétence est le foyer canonique pour la pratique de décomposition. Ce qui compte ici, dans cette compétence, est la traçabilité qui garde la décomposition connectée vers le haut à l'idée originaire :

  • Avant de lancer la session de décomposition de l'équipe, suivez l'inventaire de lien vers le haut : lisez la description de la BW Initiative, puis suivez le lien travail item à l'idée ARCH. La TSI porte la justification stratégique, la carte de stakeholder, et les points de friction connus — tout cela devrait informer comment l'équipe interprète l'épic. Cinq minutes de lecture ici sauvent des heures d'histoires mal scopées après.
  • Quand une décomposition surface des ambiguïtés qui n'étaient pas dans la description TSI ou initiative, deux options : l'ambiguïté est dans le scope de l'équipe (décidez et avancez), ou elle a des implications transversales (poussez-la au shepherd avec assez de contexte pour la résoudre sans recommencer). La section « Stakeholder & Engagement Map » de la TSI dit généralement laquelle est en jeu.
  • Quand l'équipe frappe un point de friction pendant l'implémentation qui était prédit dans la section « Known Friction Points » de la TSI, surface-le au shepherd avec cette référence. C'est un signal que la friction s'est produite là où attendu — pas un nouveau problème, mais un problème planifié qui nécessite une navigation active.

Garder la trace vivante

À mesure que le travail progresse, liez agressivement sur la BW Initiative :

  • « Relates to » les tickets SRE/BRE/TSD/PM qui touchent ce travail.
  • Tickets de tentatives antérieures découverts pendant l'implémentation.
  • Initiatives adjacentes qui interagissent avec celle-ci.
  • Tickets opérationnels qui émergent pendant le rollout.

L'inventaire de lien de l'initiative est l'une des choses les plus précieuses qu'elle fournit — c'est l'image complète du travail associé à l'effort à travers tous les projets. En cas de doute, liez-le. Quand la décomposition d'une équipe surface une ambiguïté qui affecte d'autres équipes, levez-la au shepherd plutôt que de la résoudre unilatéralement.

Erreurs courantes

  • Laisser un motif transversale rester scoped au niveau équipe parce que dépôt d'une idée semble être de la surcharge. La surcharge est réelle ; tout comme le coût de cinq équipes travaillant indépendamment autour du même gap.
  • Dépôt d'une idée sans nommer la friction. Architecture peut aider à naviguer le désaccord, mais seulement si la friction a été nommée où elle vit.
  • Confondre l'idée ARCH avec la BW Initiative. Deux artéfacts, deux audiences, liés mais séparés. Gardez les deux en sync à mesure que l'initiative progresse.
  • Ignorer l'inventaire de lien. Une initiative sans liens « Relates to » fait que chacun re-découvre le contexte la prochaine fois que quelque chose de similaire arrive.
  • Lancer une décomposition d'équipe sans lire la TSI. L'idée porte le contexte que la description d'initiative résume — justification stratégique, carte de stakeholder, friction connue. Cinq minutes de lecture en amont sauvent des heures en aval.

Références

  • Technical Strategy Ideas — le modèle TSI canonique et le modèle de backlog.
  • Idea-Based Initiatives — la structure BW Initiative canonique et l'évolution phase par phase.
  • Connexes : Skill(navigating-the-initiative-funnel) pour la mécanique de phase une fois qu'une idée est dans l'entonnoir, Skill(architecting-solutions) pour le jugement architectural à apporter à la fois au cadrage d'idée et à la décomposition d'équipe, Skill(running-work-transitions) pour la transition Phase 4→5 que cette décomposition alimente — de chaque côté de la transition.

Skills similaires