Ki jan yo ekri espesifikasyon teknik ki reyèlman anbake

Si ou li sa a, chans yo ke ou te gade nan yon espesifikasyon teknik semi-fin vye granmoun nan 2am, eseye desespere yo ranplase li anvan standup. Oswa ou te nan fen receiving - sloging nan yon lòt moun 47-page opus, wondering si san limit PTO se valab. Men, isit la se bagay la: Lè yo te fè byen, espesifikasyon teknik yo pa travay lakay ou nan teknoloji a. Yo se youn nan zouti yo ki pi fò ou gen yo kondwi karakteristik soti nan lide a nan pwodiksyon. Mwen pral montre ou ki jan mwen apwopriye ekri yo, ki baze sou eksperyans mwen nan Monzo ak lekti mwen te pran soti nan enjenyè nan AWS, Google, ak Meta. background mwen se lojisyèl enjenyè, men yon anpil nan sa a transfè nan lòt disiplin teknik. Poukisa yo ekri teknoloji espesifik nan tout fason? Jwenn li. ekri dokiman santi tankou busywork lè ou ta ka livrezon kòd. Men, rete ak mwen isit la, paske yon bon espesifikasyon teknik fè plis pase satisfè kèk kondisyon pwosesis. Si yo te itilize byen, espesifikasyon teknik ede ou: Valide lide a anvan ou pèdi semèn nan konstriksyon li - Mwen te mouri plis lide mal pandan faz la espesifikasyon pase mwen enterese admet. ekri fè ou panse nan ka edge ou ta dekouvri twa sprints nan. Jwenn buy-in soti nan moun ki reyèlman enpòtan - enjenyè anplwaye ou, manadjè pwodwi ou, ki enjenyè prensipal ki te wè tout bagay la. Jwenn poutèt yo byen bonè vle di ou pa pral defann apwòch ou nan yon revizyon kontroversièl PR pita. Itere sou plan la segondè ak moun ki pi entelijan pase ou - mwen pa moun ki pi entelijan nan chanm la, ak si ou se onèt ak tèt ou, se pa ou. Yon espèk se ki jan ou sèvi ak intelijans kolektiv. Pòtab konesans ak ekip ou - Enbore nouvo enjenyè vin "li espesifikasyon sa a" olye pou "lache m 'explain sa a arsitektur pou twazyèm fwa nan semèn sa a." Pòtab konesans ak stakeholders deyò enjenyè - Manadjè pwodwi ou, ekip konpòtman, oswa finansye moun bezwen konprann sa ou ap bati ak poukisa. Yon espesifikasyon byen ekri blòk sa a. Sèvi kòm validasyon lè travay la se konplè - Èske ou reyèlman rezoud sa ou mete yo rezoud? Spesifikasyon an se karaktè ou. Spec-Driven Devlopman ak LLMs LLM yo te chanje fason mwen panse sou espesifikasyon teknik. LLMs travay pi byen ak estrikti, espesifikasyon teknik yo. Menm ou kite jiska imajinasyon an, pi bon. Yon espesifikasyon byen definye ka manje nan yon LLM pou kreyasyon otomatik tikè oswa menm implemantasyon teknik. Ou ka jere tès soti nan espesifikasyon ou yo. Ou ka sèvi ak LLMs yo ide sou pati nan pwopozisyon ou, mande yo fè rechèch, oswa menm ede identifye mank nan logik ou. Mwen gen yon lòt atik vini nan semèn yo pwochen dedye a devlopman espesifik ak LLMs. kenbe yon gade pou li - Mwen te eksperyans ak sa a nan mas ak rezilta yo se reyèlman enspire. Men, menm si ou pa janm touche yon LLM, disiplin nan ekri yon espesifik rès peye divizyon. Li fòse clarity. Ak clarity se ki jan bon lojisyèl se bati. Anatomi nan yon bon pwopozisyon teknik (Parts 1) Yon bon espesifikasyon teknik se byen estrikti, fasil yo konprann, ak aksyonab. Li ta dwe skimmable pou ekzekitif yo ak detaye ase pou enjenyè a aplike li. Sa a se yon kouvèti estrikti pou ale, men mwen te jwenn yon modèl ki travay. Here's the first half of the anatomy. This is what you write before you get buy-in. Ki sa ou ap eseye rezoud? Kòmanse ak deklarasyon pwoblèm la. Pa solisyon an - pwoblèm la. Mwen te wè anpil espesifikasyon ki pike dirèkteman nan Pa janm eksplike sa ki te kraze. "Nou ta dwe nou bati yon microservice ak GraphQL" Nan start-up mwen an, Tandem, mwen gen yon tès senp: ka Jack, co-fondatè mwen ki pa teknik, konprann pwoblèm la, jis pa li? Si pa, rekrite li. Yon teknik ki travay: : Not but Use concrete examples "users experience latency" "users wait an average of 8 seconds for their transaction history to load, and we're seeing 23% drop-off at this screen." Montre enpak biznis: "Sa a koute nou apeprè £ 2.3M chak ane nan pèdi konvèsyon" se anpil plis konvansyonèl pase "sa a se lontan." Gen ladan sitasyon oswa done: Si ou gen rechèch itilizatè, plezi kliyan, oswa done kontwole, kite li nan. Evidans bat opinyon an. Ki sa ou pa eseye rezoud? Scope creep se reyèl, ak si ou pa eksplisitman rele sa ki soti nan jaden an, ou pral pase mwa a pwochen diskite sou ka kantite ki pa enpòtan. Imajine sa a: ou jwenn yon pwopozisyon soti nan ekip la platfòm pou upgrade nan nouvo library UI pataje yo. Li sanble senp, dwa? Jis echanj kèk enpòte, mete ajou kèk konpozan. Men, Lè sa a, ou jwenn library a nouvo sèvi ak yon sistèm routaj konplètman diferan anba a. Koulye a, ou bezwen refaktor chak wout nan aplikasyon ou. Lè sa a, ou konprann modèl navigasyon ekip pwodwi ou yo pa trè apwopriye ak modèl la nouvo, se konsa ou bezwen anbalaj Customized. Oh, ak chak product team that depends on this shared library? They're all blocked on the same changes. What started as a jis devlope nan yon efò migrasyon sis mwa ki kenbe travay karakteristik nan tout òganizasyon an. lòt "Simple ajou sèvis piblik" Yon eksplisit seksyon ka jwenn sa a byen bonè. Li ba ou pèmèt yo di non. Li kenbe kilti a nan Epi li pwoteje timeline ou soti nan sa yo sugjerasyon aparent innocents ki balon nan maladi òganizasyon. "Ki sa nou pa rezoud" «Nou-notis» nan Poukisa pwoblèm sa a ta dwe rezoud? Pa tout pwoblèm bezwen solisyon. Gen kèk ka viv ak workarounds. Gen kèk pa reyèlman pwoblèm, jis ti pwoblèm. Poukisa sa a ta dwe jwenn atansyon ak enjenyè tan? fè ka a klè: Efè sou itilizatè: Ki jan anpil moun ki afekte sa a? Ki jan mal? Efè sou biznis la: Reven, retansyon, konvèsyon, koute operasyon? : Is this tech debt that's slowing down every other project? Impact on engineering Efè sou konformite oswa risk: Sa a pral eksplore nan sis mwa si nou pa fikse li? I'm a big believer in showing your work here. Don't just say Show the math. We once based a proposal to change the text on a button on an experiment that proved a 23% uptick in conversion, which translated to +£12k ARR. That's a much easier sell than “Sa a se enpòtan.” "Kopi bouton sa a ta ka pi bon." Poukisa kounye a? Timing enpòtan pi plis pase moun panse. Mwen te wè pwopozisyon yo pafè bon yo dwe ranpli paske li pa te moman ki bon. Apre sa, mwen te wè pwopozisyon mediocre yo vin griyòz paske moman a te pafè. Ki sa ki se kounye a pi bon tan yo rezoud pwoblèm sa a? : Regulatory changes, marketing campaigns, conference demos External deadlines Preparasyon enteryè: Èske ou gen enfrastrikti a dwat nan plas? Kapasite ekip la dwat? : Are there other projects that need to ship first? Dependencies Fenèt opòtinite: Pafwa, gen yon fenèt sèk lè rezoud yon bagay se pi fasil pase li ta dwe ankò. Isit la se yon egzanp espesifik. Nou te gen yon pwopozisyon pou sèvi ak zòn tan lokal sou rapò kont bank olye pou UTC. Timing la te enpòtan - nou te vle fè li kounye a apre konsomasyon limyè jou fini nan UK la. Sa a te ba nou sis mwa lè UTC ak tan lokal te menm jan an. Nou te tou te kenbe rapò istorik nan zòn tan orijinal yo pou rezon legal yo. Kòmanse kounye a apre èdtan yo chanje te vle di nou te gen fenèt maksimòm anvan tranzisyon an pwochen, ki te diminye anpil chans pou yon moun ki ta dwe kreye yon rapò ak konvèsyon zòn tan plizyè-logik. Si nou te fè li nan mwa Mas anvan mwa Novanm, nou ta te prezante fason plis konplisite ak kantite ka. Timing pa te sèlman enpòtan - li te diferans ki genyen ant yon migrasyon limyè ak yon maladi. Requirements What's 100% non-negotiable? What are the absolute bare minimums that can't be excluded? Think of requirements as the must-haves. Not the nice-to-haves, not the maybe-we-should-also, but the core things that must be true for this to be worth doing at all. I structure requirements as testable statements: "Transaction history must load in under 2 seconds at p95" "Solisyon an dwe travay pou itilizatè sou iOS 14 ak pi wo a" "Done yo dwe enkripsyon nan repo ak nan tranzit" "Pa mande pou nenpòt kliyan re-authenticate" Notice these are specific and verifiable. You can test whether you've met them. Vague requirements like ou are useless. Pin them down. "must be fast" "Li ta dwe san danje" Yon gade zwazo nan solisyon an Li imedyatman plonje nan detay nan implemantasyon - ki baz done, ki API, ki sèvis mesh. Stop. Pa ankò. Si ou pa ka eksplike solisyon ou a nan yon moun ki pa konnen ki sa Kubernetes se, ou pa konprann li byen ou menm. Yon kèk règ pou seksyon sa a: Reyèlman. Pa ankò. Nan plas nan Dwa No tech talk. "Nou pral deplwaye yon nouvo microservice ak yon Redis cache ak ekspoze li atravè GraphQL," "Nou pral anbake done ki souvan aksè pi pre nan itilizatè a, se konsa li chaje imedyatman anvan fè yon vwayaj lontan nan baz la chak fwa." Ki sa chanjman soti nan perspektif la nan itilizatè a? Ki jan siksè sanble pou yo? Think user-centric. Kòmanse ak and then explain at a high level how you'll achieve that. Anchor on outcomes, work backwards. "Utilizatè yo pral wè istwa tranzaksyon yo chaje nan mwens pase 1 segonn" Pafwa gen reyèlman diferan apwòch. Sitou de oswa twa opsyon ak pros ak kontra. Sa a montre ke ou te panse nan li ak ba stakeholders yon chwa reyèl. If possible, offer multiple potential solutions. Nan moman sa a, ou ta dwe rete ak reevalué. Isit la se checklist mwen anvan yo avanse: [ ]Problèm deklarasyon se klè ak spesifik Business impact is quantified [ ] Non-goals are explicitly stated [ ] [ ]Requisite yo se tès [ ]Solisyon segondè-nivo gen rezon pou yon non enjenyè [ ] Mwen konfyans li se vo fè Si ou pa ka tcheke tout ka sa yo, pa avanse nan pati 2 ankò. Seri. Mwen te pèdi semèn ekri plan enplike detaye pou lide ki pa reyèlman vo fè. Jwenn yon buy-in ak kolaborasyon etap pwochèn ou a se pou jwenn repons soti nan stakeholders kle. Sa a se pa yon formalite. Sa a se kote espesifikasyon ou touche pi bon oswa desann. Yon kèk konsèy difisil pou yon pitch siksè: Mwen se yon fanatik nan Notion paske nan kòmantè tan reyèl ak kolaborasyon, men Google Docs travay tou. Mwen menm te wè kèk pyonye reyèl sèvi ak Figma pou sa a yon fwa! Li enpòtan se ke moun ka kite kòmantè nan liy ak sijere chanjman. Evite PDFs oswa dokiman Word ki anrejistre nan imel - ou vle sa a dwe yon dokiman vivan. Use a platform that makes collaboration easy. Si ou sijere chanjman nan yon vwayaj itilizatè, kreye mockups oswa wireframes. Si ou se optimize yon sèvis, montre metrik kounye a ak imaj ekran soti nan monitoring ou. Mwen rekòmande Figma (wo-fidèlite) oswa Excalidraw (low-fidèlite) pou vwayaj itilizatè yo ak imaj ekran soti nan Grafana oswa Datadog pou metrik. Vizyèl yo pa dekorasyon - yo fè argiman ou konkrè. Illustrate your points. Leave your ego at the door. Every piece of criticism you get now is a production issue you won't have later. I've had specs torn apart in review, and it sucks. But you know what's worse? Building something for three months only to have it fail in production because you missed something obvious. Getting feedback should be your main objective. If someone leaves a comment like Tanpri mande yo eksplike poukisa epi sijere yon opsyon. Negativite vye granmoun pa ede nenpòt moun. Men, pwoblèm reyèl ak rezon? Sa a se lò. Guide your contributors. "Mwen pa renmen metòd sa a," Yon moun pral mande Èske ou bezwen yon repons. Repons yo pi byen gen nimewo. Li se anpil plis enpòtan pase Be ready to defend your value proposition. "is this worth the engineering time?" "This can lead to a 27% reduction in database hosting costs, resulting in annual savings of £1.5M" "this will make things more efficient." A plan worth implementing (part 2) Èske ou trete espesifikasyon teknoloji kòm yon efò solo? ekri li sèlman, pataje li pou revizyon, jwenn kèk kòmantè, voye li? Sa a se pa jan yo ekri espesifikasyon yo pi byen. Pi bon espesifikasyon teknik yo rezilta nan kolaborasyon fò. Ou ekri drapo a premye, asire. Men, Lè sa a, ou envite moun entelijan yo fè li pi bon. Ou entegre repons yo. Ou ajiste ki baze sou sa ou aprann. Spesifikasyon an devlope. Sa a dezyèm pati nan anatomi se plis dinamik. Li varye depann sou kilti konpayi ou a, pratik ekip ou a, ak kalite pwojè. Men, gen prensip ki kenbe atravè konteks. Pi bon pratik ak estanda konpayi Your implementation plan should be an extension of your company's established practices. If you're using React and Next.js for web frontends, your spec should use React and Next.js. If your company has a standard CI/CD pipeline, use that. The exception is when you're explicitly proposing to change an established practice. Maybe you want to introduce a new framework or migrate to a different database. That's fine — but make your case with evidence. Lè mwen te pwopriyete chanjman nan pratik yo etabli, mwen toujou enkli: Outside proof of concept: Èske yon lòt konpayi te fè sa a avèk siksè? Premye atizay soti nan domèn adjacent: Èske nou te itilize apwòch menm jan an nan kontexte diferan? Klè rezonasyon pou poukisa apwòch la kounye a pa travay: pa jis di "ki sa a se pi bon." : How do we get from here to there without breaking everything? Migration path Nan Superbet, mwen te mennen yon ekip ki te bati yon livrezon UI dedye yo ranplase kontinyèlman problematik Ant Design nou te itilize anvan. Nou te fè li yon 100% drop-in ranplasman atravè yon kouch konpatibilite - teknikman pafè. Men, mwen toujou pa t 'konvèti plizyè ekip yo adopte li, paske mwen pa te kapab kondwi ka biznis la nan kay la. Sa a se lekti a isit la: ranplase teknoloji etabli se difisil menm lè solisyon ou se objektifman pi bon. Ou bezwen nimewo yo, etid ka, chemen migrasyon. Teknoloji ekselans sèlman pa genyen argiman an. Prior art and alternatives considered Èske gen yon bagay ki menm jan an ki deja egziste? Èske ou te implemante karakteristik ak atribit ki menm jan an nan tan kap vini an? Tout sa a se vle di. Best case scenario: you discover you don't need to build anything new. You can reuse an existing solution. Ajoute li nan baz la konesans ki gen rapò ak solisyon an ke ou te jwenn. Li ede manmè yo konprann ki nan stakeholders yo ak poukisa moun bezwen sa a. Si yo vle mete solèy la, transfere pwopriyete, oswa refactor lojisyèl yo, yo pral konnen ki moun yo pale ak. If this happens, don't throw away your spec. Mwen te sove mwa de tan enjenyè pa jwenn art anvan yo. Nou te itilize Statsig yo anbake eksperyans, men nou te ekri pwòp SDK nou an sou li olye pou yo sèvi ak ofisyèl la. Implemantasyon nou an pa sipòte alokasyon persistant, ki vle di nou pa ka kouri eksperyans kle. Mwen te kòmanse spekil sou ki jan yo ajoute karakteristik sa a - panse mwen ta dwe bati li soti nan zèb la - ak te ale sou yon ti kras yon chase goose. Lè sa a, mwen te jwenn yon sèvis egziste, domèn-spesifik ki deja rezoud persistans pou yon ka itilize diferan. Mwen jis kopi modèl la nan implemantasyon. Ki mwen te panse ke li ta pran semèn, jis de jou. What other approaches did you evaluate? Why didn't they make the cut? Li montre ke ou te fè travay lakay ou. Li tou anpeche moun nan sijere alternativ ou te deja konsidere ak rejeye. Mwen anjeneral enkli yon tab kout: Approach Pros Cons Why we rejected it Use existing service X Fast, proven Doesn't support feature Y Missing critical functionality Build custom solution Perfect fit High maintenance cost Not worth the ongoing burden Third-party API Easy integration Vendor lock-in, high cost £250K annually vs £30K to build Sèvi ak sèvis ki egziste X Rapid, tès Pa sipòte karakteristik Y Manke fonksyonalite kritik Kreye solisyon koutim Pwodwi pou Pwoteksyon segondè Pa valè yon pousantaj kontinyèl Third-party API Easy integration Vendor lock-in, high cost £250K annually vs £30K to build Pwosesis teknik Now — finally — you can get into the details. This is where you explain the actual implementation, architecture decisions, and tech stack choices. Architecture diagrams, sequence diagrams, data flow diagrams. I recommend (Se konsa ) paske li se gratis ak gen karakteristik kolaborasyon decent. dezavantaj la se pa gen okenn viv pataje tankou Figma, se konsa ou pral bezwen ekspòte ak embed imaj. Use diagrams. Draw.io Pwodwi pou Telefòn For sequence diagrams, I like Mermaid because you can write them in markdown and they render automatically in most tools. Here's a simple example: sequenceDiagram User->>API: Request transaction history API->>Cache: Check cache Cache-->>API: Cache miss API->>Database: Query transactions Database-->>API: Return results API->>Cache: Store in cache API-->>User: Return results Pa sèlman di Dwa Explain the "why" behind technical decisions, not just the "what." "we'll use Redis for caching." "Nou pral sèvi ak Redis pou caching paske modèl aksè nou yo trè lis-bias (95% li vs 5% ekri) ak nou bezwen latèz sub-milisekond. Nou konsidere Memcached men chwazi Redis paske nou bezwen estrikti done tankou seri seri pou karakteristik timeline." Be honest about where this will break. That's way more useful than pretending your solution scales infinitely. Call out performance characteristics and scalability limits. "Sa a apwòch travay jiska apeprè 100,000 demann pou chak sekondè. Anplis de sa, nou pral bezwen ranplase." Montre ki jan done yo sanble. Montre ki jan demand API yo ak repons yo sanble. Mwen anjeneral enkli egzanp JSON: Mention data models, API contracts, key interfaces. { "transaction_id": "tx_123", "amount": 1250, "currency": "GBP", "timestamp": "2025-01-15T14:30:00Z", "category": "groceries" } A benefit of embedding models in a transferrable format, like JSON is that this can then be copy/pasted into a test or mock service later on. Saves some time and cuts down on ambiguity. Yon benefis nan embedding modèl nan yon fòma transfere, tankou JSON se ke sa a ka Lè sa a, kopye / pase nan yon tès oswa mock sèvis pita. Sove kèk tan ak diminye ambiguïté. If this requires spinning up new services, databases, or third-party integrations, call it out. These often have cost implications and procurement delays. Highlight any new infrastructure or services needed. Breaking down the work Ki jan ou decompose solisyon sa a nan milye ak travay ki ka rastre? Sa a se jesyon pwojè, men li nan travay ou bay estrikti a. Ship something usable early. I'm a big fan of the MVP → MLP → Full Product progression: Split into phases that deliver incremental value. MVP (Minimum Viable Product): Sa a absoliman pi piti bagay ou ka bati pou valide apwòch la. Anjeneral sèlman enteryè oswa limite nan yon ti pousantaj itilizatè. MLP (Minimum Lovable Product): Vèsyon an pi piti ki se reyèlman bon ase pou itilizatè reyèl yo sèvi ak ak ak jwi. Pifò pwodwi: Tout bwat yo ak whistles. Don't try to ship everything at once. This is tough to admit, but in many cases, we ended up keeping the MLP as the end-result, because it was . “Bon ase” What must ship for this to work? What's optional? Use a prioritisation framework. I like MoSCoW (Must have, Should have, Could have, Won't have). Identify critical path items vs nice-to-haves. Can the backend and frontend teams work simultaneously? Or does the backend need to ship first? Making dependencies explicit helps with planning. Call out what can be parallelised vs must be sequential. Mwen reyèlman deteste gwosè ak mwen se mal sou li tou. Mwen prefere devlopè-ora, devlopè-jou, devlopè-semèn kòm yon sèl-medye, lè diskite sou timelines. Si ou pa asire w, ale yon sèl-medye, egzanp: pa konnen si 3 oswa 4 devlopè-jou? Sèvi ak 1 devlopè-semèn. Assign rough t-shirt sizes or story points if your team uses them. Use a simple dependency graph or just list them: Make dependencies between tasks explicit. "Task B depann sou Task A dwe konplè. Task C ka kòmanse paralèlman ak Task B." Success metrics How will you measure if the implementation actually worked? What are the KPIs? This is where you define victory conditions. And you need to be specific. is not a success metric. Li se yon metrik siksè. "Make it faster" "Reduce p95 API latans soti nan 500ms nan anba 200ms" Examples: Define measurable outcomes. Rediksyon latans: "p95 latans ba soti nan 800ms nan 200ms" Error rate decrease: "5xx errors drop from 0.3% to below 0.1%" Konvèsyon amelyore: "vitès nan konplètman tcheke ogmante soti nan 73% nan 80%" Cost savings: "database costs decrease by £40K annually" You need to know where you're starting. I take screenshots of dashboards showing current performance and attach them to the spec. It's way too easy to forget what things were like before you started. Set baseline metrics before implementation. Èske ou pral bati yon tablo? Konfigirasyon alèt? Kòmanse yon tès A / B? Se eksplisit sou metòd metòd metòd. Specify how you'll track these metrics. Manadjè pwodwi sou sou revni ak angaje. Enjenyè sou latans ak pwodiksyon. Spec ou ta dwe pale tou de lang. Include both business metrics and technical metrics. Evalyasyon risk, depans ak mitigasyon Ki sa ki ta ka ale mal? Ki sa ou anseye sou? Ki sa ou bezwen nan lòt ekip? Mwen te aprann yo dwe brutalman onèt nan seksyon sa a. Pretande risk pa egziste pa fè yo ale. Li jis vle di ou pa pral gen yon plan lè yo materialize. Èske ou bezwen yon lòt ekip livrezon yon bagay an premye? Èske ou depann sou yon sèvis twazyèm-pati ki ta ka gen limite pri oswa tan apwòch? Telefone li. Mwen te gen pwojè retardé pa semèn paske nan dependences mwen pa te anpeche byen bonè. List external dependencies. Where can this break? What happens if that one critical service goes down? If you're introducing a new database, what happens if it fails? Call out single points of failure in your design. Are you using a technology for the first time? Is this an area of the codebase nobody really understands anymore? Are you making assumptions about user behavior that might be wrong? Identify areas with high uncertainty. Pa sèlman lis risk - montre ki jan ou pral jere yo. Egzanp: For each major risk, propose a mitigation strategy or fallback plan. : Third-party API might have downtime Risk Mitigasyon: Implemantè circuit breaker ak eksponan backoff; cache repons pou 5 minit; gen yon mòd degradé ki travay san API la Li bati konfyans ak mande pou èd. is way better than pretending you have it all figured out. Be honest about what you don't know yet. "Mwen pa konnen ki jan nou pral travay ak migrasyon an nan 500GB nan done ki deja egziste - ap chèche pou envantè isit la" Pa espere pou revizyon sekirite yo jwenn ke ou bezwen yon evalyasyon enpak pwoteksyon konplè. Si ou touche done itilizatè, rele li. Si sa a bezwen SOC2 konpatibilite, non li. Mention compliance, security, or data privacy concerns early. Rollout estrateji Ki jan sa a pral reyèlman deplwaye? Etap deplwaye? Karakteristik flè? Kanaryen deplwaye? Mwen pa janm voye chanjman gwo nan 100% nan itilizatè yo sou yon sèl jou. Pa janm. If you only have two users, ship to just one. Si ou gen sèlman de itilizatè, voye nan sèlman yon sèl. Progression mwen nòmal: 5% → 10% → 50% → 100%. Nan chak etap, ou kontwole metrik ak gade pou pwoblèm. Si yon bagay breaks, ou se sèlman afekte yon ti senk itilizatè. Plan for gradual rollout. Deploy the code to production but keep it behind a flag. This lets you control who sees the new feature independent of your deployment process. I've used LaunchDarkly, Statsig, and built homegrown solutions. They all work. Pick one and use it religiously. Use feature flags to decouple deploy from release. Ki kondisyon ki pèmèt yon rollback? Se spesifik: Define rollback criteria. Si pousantaj erè depase 0,5%, roule tounen Si latèz p95 depase 1 sekondè, roule tounen Si nou resevwa plis pase 10 kliyan plent nan yon èdtan, roule tounen Ki gen kritè sa yo definye nan avanse vle di ou pa pral pran desizyon emosyonèl pandan yon incidans. Dapre trafik reyèl nan koòd la nouvo, men pa montre itilizatè yo rezilta yo. Konpare pwodiksyon an ak koòd la fin vye granmoun (yo rele tou: tès omwen). Sa a retire bugs anvan itilizatè yo wè yo. Consider dark launching to test in production without user impact. Migre dè milyon de dosye baz done se riskan. Fè li separe de livrezon karakteristik nouvo. Ideyalman, migre done an premye, Lè sa a, deplase kòd ki sèvi ak scheme a nouvo, Lè sa a, netwaye scheme a fin vye granmoun (expand-migrate-contract modèl). Plan for data migrations separately from code deploys. Ki bezwen konnen lè sa a anbake? Ekip sipò kliyan? Marketing? Patnè ekstèn? ekri plan la comms nan espesifikasyon an. Have a communication plan for internal stakeholders and customers. Rollback estrateji Ki sa ki ka pase si ou soumèt vin indisponib lè tout bagay se nan flè? Ekip ou ta konnen ki jan yo travay avèk li? Think of it like a preflight checklist for pilots. When stress is high and adrenaline is pumping, you don't want to be figuring things out. You want a list you can follow mechanically: Disable feature flag X Or: roll back to commit abc123 and deploy Run database script Y to revert schema changes Clear cache Z to remove stale data Monitor metrics A, B, C to confirm rollback successful Post in #incidents channel with status This keeps stress to a minimum in incident scenarios. Testing approach Tès inite, tès entegre, tès pwa, kantite ka - ki jan ou pral valide sa a reyèlman travay? Pòt kritik mande pou tès extensif. Karakteristik Nice-to-have ka gen yon kouvèti pi fasil. Se eksplisit sou sa ki bezwen ki nivo nan tès. Define test coverage expectations. Si sa a ap sèvi ak milyon de demann, ou bezwen teste li nan skal. Mwen sèvi ak zouti tankou k6 oswa Locust simile chaj. Pa espere jiskaske pwodiksyon yo jwenn baz baz done ou chita sou nan 10,000 QPS. Plan load/performance testing for high-traffic features. Kill dependences. Enjecte latency. Simile partitions rezo. wè sa ki fèmen. Netflix a Chaos Monkey se egzanp la kanonik, men ou pa bezwen anyen ki sofistike. Jis delibere fèmen bagay ak wè sa ki rive. Consider chaos engineering for critical systems. Ki sa ki rive lè baz done a se lontan? Lè cache a se bwat? Lè yon itilizatè voye entèlijans malformed? Sa yo se kote bugs kache. Test edge cases and failure modes, not just happy paths. Automated tests are great, but they only catch what you thought to test for. A human clicking around can find the weird stuff. Plan for manual QA/exploratory testing where needed. Pen tès, OWASP Top 10 tès, depannasyon tès. Si ou ap touche otantifikasyon, peman, oswa done pèsonèl, ou bezwen yon revizyon sekirite. Include security testing for sensitive features. Timeline ak milye Estimasyon reyèl, tampon pou non, dat livrezon kle. Here's an uncomfortable truth: your initial estimates will be wrong. They're always wrong. The question is how wrong. Si gen yon kondisyon règleman oswa yon konferans demografik, kòmanse isit la ak travay revni yo aprann si li se posib. Work backwards from hard deadlines if they exist. Si ou ap travay nan yon teritwa byen koni ak teknoloji byen koni, multiplike estime yo pa 1.2x. Si ou se nan yon teritwa byen koni oswa lè l sèvi avèk nouvo teknoloji, multiplike pa 1.5x a 2x. Mwen konnen li sanble egzèsis, men mwen pa janm te regrèt estime pa plato ak mwen te toujou regrèt yo te optimis. Pad estimates for unknowns. Yon fwa chak de semèn, ou ta dwe kapab montre yon bagay. Li kenbe momentum ak soumèt pwoblèm byen bonè. Define clear milestones with demos or checkpoints. Feri, sezon konferans, deadlines konformite, lansman maketing. Si mwatye nan ekip ou a ap ale pou yon semèn, fè sa nan. Call out external constraints. Account for on-call rotations, other commitments, the fact that nobody is productive 8 hours a day. I usually assume 6 productive hours per engineer per day, and that's being generous. Be realistic about team capacity. Initial estimates are educated guesses. As you get into implementation, you learn things. Update your timeline accordingly. A spec should be a living document, not a contract written in stone. Update estimates as you learn more. Open questions Ki sa ki toujou bezwen aprann? Ki sa ki bezwen plis rechèch? Seksyon sa a ta dwe ralanti ak tan lè ou jwenn repons, men li esansyèl yo gen li. Li montre onètite entelektyèl ak envite kolaborasyon. "Nou bezwen valide ke apwòch X ka sove volim kesyon nou an" oswa "Nou ta dwe prototip script la migrasyon sou yon dataset tès an premye." List unknowns that need research or prototyping before committing. "Need security team review on encryption approach" or "Need product input on what the fallback behavior should be." Call out decisions that need input from specific people or teams. "We're assuming users will click this button, but we should A/B test to confirm" or "We think this cache hit rate will be 80%, but we should measure real traffic patterns first." Highlight areas where you need to validate assumptions with data. "We could optimise for latency or throughput but not both — need to decide which matters more for this use case." Be explicit about trade-offs you haven't resolved yet. Nenpòt moun ta dwe responsab pou jwenn yon repons, ak gen yon peryòd. Assign owners to each open question with target resolution dates. How culture plays a role Mwen te travay nan konpayi kote espesifikasyon yo te trete kòm egzèsis bürokratik tcheke bous, ak mwen te travay nan konpayi kote yo te gen yon valè reyèlman kòm zouti nan panse. Diferans la se mitan lannwit ak jou. Li diminye chaj la kognitif ak asire ke tout moun yo sou paj la menm. Ou pa ta dwe reinvente estrikti a chak fwa. Nou te gen yon modèl nan Notion. Pou Tandem, nou itilize Google Docs modèl, ak nan Docler, nou te gen Confluence. Zouti a pa enpòtan kòm konsistans la. Technical specifications should be based on a standard template. Ki gen yon modèl estanda tou vle di revize espesifikasyon yo se pi fasil. Ou konnen ki kote yo gade pou deklarasyon pwoblèm, kondisyon yo, risk yo. Ou pa chèche nan yon esè nan fòm gratis eseye jwenn enfòmasyon baz. Pa gen okenn frè nan pataje lide ou ak yon odyans pi laj. Mwen konnen li se enkyetid mete lide ou deyò, men transparanite gen benefis masiv. Ekip lòt ta ka jwenn ke yo rezoud pwoblèm menm jan an. Yon moun ki soti nan yon vertikal diferan ta ka gen yon kontexte enpòtan ou manke. Serendipity rive lè enfòmasyon a se piblik. Make all proposals publicly available. All specs were in a shared Notion space that anyone in engineering could read. The number of times someone from a completely different squad dropped a comment that changed the whole approach was remarkable. Li sèvi pou plizyè objektif: li ede lòt moun aprann, li ankouraje kolaborasyon, li fè moun konsantre sou sa ki se bati nan tout òganizasyon an. Nou te gen chak mwa sessions where people would present proposals in progress and get feedback from a cross-functional group. Some of the best ideas came from those sessions. Schedule regular review sessions of critical proposals. “Architektur Revizyon” Praise great proposals publicly. Acknowledge all participants, even if they just left a single comment. This encourages a culture of collaboration. I've seen teams where people were afraid to comment on specs because they thought they'd be seen as obstructionists. That's poison. You want people to feel like their input is valued, even if it's critical feedback. Tell people they're doing great. When someone writes a particularly good spec, I call it out in a public channel. Li pran senk segonn ak li fè moun santi bon sou travay yo ap fè. "Sa a espesifikasyon soti nan Alex se yon egzanp ekselan nan ki jan yo estriktire yon pwopozisyon konplèks - tcheke li pou referans." Spec se travay la Isit la se konsèp final mwen an, epi li se pwobableman bagay la ki pi enpòtan nan tout atik sa a: ekri espesifikasyon an se fè travay la. Pifò enjenyè trete espesifikasyon an kòm yon overhead anvan of coding begins. That's backwards. The spec is where you do the hardest thinking. It's where you discover what you don't know. It's where you find the fatal flaws before they become production incidents. “Reyèl travay” Spesifikasyon yo pi byen mwen te ekri te kolaboratif, iteratif, ak kounye a kontroversièl. Yo te marye ak dè santèn de kòmantè. Yo te pase pa revizyon plizyè. Yo te fòse m 'refize suppositions mwen pa menm konnen mwen te fè. And every single one of them made the implementation smoother, faster, and more successful than it would have been otherwise. Se konsa, pwochen fwa ou se tès yo pase espesifikasyon an ak jis kòmanse kodaj, reziste. Louvri dokiman an. Kòmanse ak pwoblèm la. Kòmanse nan detay yo. Inite moun entelijan yo kache kouvèti nan logik ou. Itere. pwovens ou - ak rotasyon sou-kouvri ou - pral kontan. Modèl pwopriyete pwodwi mwen se disponib sou GitHub. Li retire pi fò nan lide yo diskite isit la. Si òganizasyon ou pa gen yon modèl pwopriyete teknik ankò, sèvi ak sa a kòm yon pwen kòmanse. modèl pwopozisyon pwodwi ki disponib sou GitHub