<?xml version='1.0' encoding='utf-8'?>
<?xml-stylesheet type="text/xsl" href="/sheet.xsl"?><rss version="2.0"><channel><title>Hacker News</title><link>https://news.ycombinator.com/</link><description>Links for the intellectually curious, ranked by readers.</description><item><title>Vercel April 2026 security incident</title><link>https://www.bleepingcomputer.com/news/security/vercel-confirms-breach-as-hackers-claim-to-be-selling-stolen-data/</link><pubDate>Sun, 19 Apr 2026 14:14:38 +0000</pubDate><comments>https://news.ycombinator.com/item?id=47824463</comments><description>&lt;a href="https://news.ycombinator.com/item?id=47824463"&gt;Comments&lt;/a&gt;</description></item><item><title>A Brief History of Fish Sauce</title><link>https://www.legalnomads.com/fish-sauce/</link><pubDate>Sun, 19 Apr 2026 08:32:53 +0000</pubDate><comments>https://news.ycombinator.com/item?id=47822734</comments><description>&lt;a href="https://news.ycombinator.com/item?id=47822734"&gt;Comments&lt;/a&gt;</description><ns0:encoded xmlns:ns0="http://purl.org/rss/1.0/modules/content/">&lt;div class="entry-content clear" itemprop="text" morss_own_score="5.227552275522755" morss_score="112.90641675594921"&gt;
&lt;p&gt;Out of the corner of my eye, I noticed something twisting and turning, rhythmic and precise. It was only when I was directly in front of the Saigon street stall that I realized what was unfolding: the owner, a smiling man in his 40s who always greeted me as I walked by, was packaging &lt;em&gt;nuoc cham&lt;/em&gt;, a condiment made from fish sauce, water, lime juice, and sugar. He was also adding thin slivers of pickled carrots to the tiny bags that piled in front of him.&lt;/p&gt;
&lt;p&gt;What he was doing happens all over the city at street stalls and restaurants. &lt;em&gt;Nuoc mam&lt;/em&gt; (pure fish sauce) is &lt;a href="https://www.ucanews.com/news/vietnams-fish-sauce-producers-swim-against-tide/84782"&gt;consumed by 95% of Vietnamese households&lt;/a&gt;. It’s also used to make &lt;em&gt;nuoc cham&lt;/em&gt;, a dipping condiment of fish sauce, water, lime juice, and sugar that accompanies many Southern Vietnamese dishes.&lt;/p&gt;
&lt;figure&gt;&lt;img title="what is the history of fish sauce" src="https://photos.smugmug.com/Asia/Vietnam/Saigon-2014/i-xdmxbnX/0/XL/P5229686-XL.jpg"&gt;&lt;figcaption&gt;Fish sauce packets, ready to be consumed.&lt;/figcaption&gt;&lt;/figure&gt;
&lt;h2&gt;A History of Fish Sauce&lt;/h2&gt;
&lt;p&gt;In my travels, I’ve heard others cite fish sauce as one of those tastes that takes some getting used to for Western palates, along with stinky tofu and durian fruit, and the bright purple fermented shrimp paste that accompanies Vietnamese &lt;a href="https://www.legalnomads.com/bun-rieu/"&gt;&lt;em&gt;bun rieu&lt;/em&gt;&lt;/a&gt; soup. Its lingering smell leaves no mystery about its strong, fishy contents.&lt;/p&gt;
&lt;p&gt;Used in Thailand as &lt;em&gt;nam pla&lt;/em&gt; and Myanmar as &lt;em&gt;ngan bya yay&lt;/em&gt;, as well as Laos, Cambodia, and the Philippines under other local names and variations, one thing is certain regardless of preference: fish sauce plays a crucial role in flavouring food in Southeast Asia.&lt;/p&gt;
&lt;p&gt;It has become my first ingredient of choice in a new city, something I use in homemade soups and curries, chicken marinates and salads, and even omelettes, adding a taste of Vietnam to my meal. To my taste buds, it is as evocative of my years in Southeast Asia as lime, garlic and chilies.&lt;/p&gt;
&lt;figure&gt;&lt;img title="fish sauce history" src="data:image/svg+xml,%3Csvg%20xmlns='http://www.w3.org/2000/svg'%20viewBox='0%200%201024%20768'%3E%3C/svg%3E"&gt;&lt;figcaption&gt;Street side banh cuon with fish sauce for dipping.&lt;/figcaption&gt;&lt;/figure&gt;
&lt;p&gt;“This is more than just a condiment,” founder of Red Boat Fish Sauce, Cuong Pham, &lt;a href="http://www.latimes.com/local/la-me-fish-sauce-20140916-story.html#page=1"&gt;has said&lt;/a&gt;. “It’s so good, it’s like gold.”&lt;/p&gt;
&lt;p&gt;In its purest form, fish sauce is made from just two ingredients: fish and salt, fermented together for months. Despite the fact that some fish sauce labels depict squid, shrimp, or even a man carrying a giant shrimp over his shoulder (my favourite, for obvious reasons), the base formula remains the same. Both fish and salt are placed into huge vats, usually three parts fish to one part salt, and weighted down to prevent the fish from floating to the surface as fermentation begins. Once liquid begins to seep out of the fish, it is drained and reintroduced to the vat for the full fermentation process, which lasts long enough for it to reach concentration, but not so long that off-flavours develop. Usually this process takes nine months to a year, with the vats sitting in the sun as the sauce takes form.&lt;/p&gt;
&lt;h3&gt;Fish Sauce in Ancient Times&lt;/h3&gt;
&lt;p&gt;The earliest origins of fish sauce go back further than most people realize, and its actual beginnings is remarkably hard to pinpoint even in 2026.&lt;/p&gt;
&lt;p&gt;Did fermenting fish begin as a tradition in China or Vietnam? Or as some suggest in Ancient Rome? Historians remain divided on the topic.&lt;/p&gt;
&lt;p&gt;One such food historian, Sally Grainger, notes in her 2021 book &lt;a href="https://amzn.to/4uuUMyB"&gt;The Story of Garum: Fermented Fish Sauce and Salted Fish in the Ancient World&lt;/a&gt; that despite discussions of Roman fish sauce in many publications, Roman fish sauce is not actually Roman at all: it’s Greek. Per her writing, the first recorded fish sauce was produced by the ancient Greeks along the coastline of the Black Sea, where the abundant fishery resources of the region &lt;a href="https://www.worldhistory.org/article/1276/fish-sauce-in-the-ancient-world/"&gt;may have been a significant factor&lt;/a&gt; in Greek colonisation of the area as early as the 7th century BCE.&lt;/p&gt;
&lt;p&gt;The sauce was called &lt;em&gt;gàros&lt;/em&gt; in Greek, and when the Romans adopted it, they transliterated the name as &lt;em&gt;garum.&lt;/em&gt; Importantly, though, the word &lt;em&gt;garum&lt;/em&gt; came to mean something quite specific and different from the everyday condiment most Romans actually used. Many pieces, including earlier versions of this post, conflates the true history. As Grainger explains in her book, liquamen is the standard fish sauce, made by dissolving whole small fish, often anchovies, layered with salt in a barrel or pit and left to ferment for up to four months. In contrast, &lt;em&gt;garum&lt;/em&gt; (proper &lt;em&gt;garum,&lt;/em&gt; not the &lt;em&gt;garum&lt;/em&gt; that’s used interchangeably to describe ‘ancient’ fish sauce) is thicker and darker, and made from fermented fish blood and viscera. It has a distinctively dark colour and iron-rich taste. It may seem pedantic to differentiate here, but I&lt;a href="https://www.legalnomads.com/cross-contact-cross-contamination/"&gt; always say words matter, &lt;/a&gt;and my earlier version of this post got it wrong.&lt;/p&gt;
&lt;p&gt;The Romans actually had a whole vocabulary for fermented fish products: &lt;em&gt;garum&lt;/em&gt;, &lt;em&gt;liquamen&lt;/em&gt;, &lt;em&gt;allec&lt;/em&gt;, and &lt;em&gt;muria&lt;/em&gt; each described distinct preparations. When we compare ancient Roman fish sauce to modern&lt;em&gt; nuoc mam&lt;/em&gt; or &lt;em&gt;nam pla&lt;/em&gt;, we are really talking about &lt;em&gt;liquamen&lt;/em&gt; and not &lt;em&gt;garum&lt;/em&gt;.&lt;/p&gt;
&lt;figure&gt;&lt;img title="thai fish sauce" src="data:image/svg+xml,%3Csvg%20xmlns='http://www.w3.org/2000/svg'%20viewBox='0%200%201021%20768'%3E%3C/svg%3E"&gt;&lt;figcaption&gt;Some of the fish sauce available at a Thai supermarket — there were many more!&lt;/figcaption&gt;&lt;/figure&gt;
&lt;p&gt;Roman fish sauce was used across a vast geographic and culinary range. The recipes in Apicius’s cookbook De Re Coquinaria, which is&lt;a href="https://www.gutenberg.org/ebooks/29728"&gt; available for free online&lt;/a&gt;, give a sense of how fundamental it was to Roman cooking: fish sauce was the ingredient that brought dishes together, and it was often used instead of salt. Pompeii was famous in ancient times for its production, and the many mentions in ancient texts and cookbooks imply a very normal, common use across the Mediterranean world. Per Sally Grainger, who in addition to her book has also created reconstructions of ancient Roman sauces, has singled out Red Boat Fish Sauce as the closest thing currently available on the market to Roman &lt;em&gt;liquamen&lt;/em&gt;.&lt;/p&gt;
&lt;p&gt;In a landmark &lt;a href="https://www.cambridge.org/core/journals/antiquity/article/roman-atlantic-garum-dna-confirms-sardine-use-and-population-continuity-in-northwestern-iberia/9487347327F3724D1D2C4F72266DAEF3"&gt;2025 study published in the journal Antiquity,&lt;/a&gt; scientists recovered and sequenced ancient DNA from fish bone remains at the bottom of a Roman salting vat at the Adro Vello site in northwestern Spain that was thought to be a fish-processing plant, active from the first through third centuries AD. The team successfully extracted and sequenced DNA from the small bone remains and confirmed that the primary ingredient was European sardine (&lt;em&gt;Sardina pilchardus)&lt;/em&gt;. By comparing the ancient DNA with that of modern sardines, the team found the populations of this fish during Roman times were genetically similar to those currently found in the same region, which is astounding to think about. That’s 2000 years of biological continuity!&lt;/p&gt;
&lt;p&gt;The geographic footprint of the Roman fish sauce industry was vast. Other fish-processing ‘factories’ have been excavated in Spain, Portugal, and Northern Africa, as well as more recent discoveries near Ashkelon in Israel and at the Nabeul site in Tunisia (the ancient city of Neapolis), uncovered by a 2013 storm. In modern day cuisine, fish sauce is almost completely absent from Italian food with the exception of &lt;em&gt;colatura di alici&lt;/em&gt;, a fish sauce still made in factories in the village of Cetara in Italy’s Salerno region.&lt;/p&gt;
&lt;p&gt;In his piece about fish sauce in the ancient world, Declan Henesy &lt;a href="https://www.worldhistory.org/article/1276/fish-sauce-in-the-ancient-world/"&gt;notes&lt;/a&gt;:&lt;/p&gt;
&lt;blockquote&gt;&lt;p&gt;The &lt;a href="https://en.wikipedia.org/wiki/Ancient_Carthage"&gt;Carthaginians&lt;/a&gt; were also early makers and traders of fish sauce, producing it along the coast of the Lake of Tunis, in modern day Tunisia. A Punic shipwreck from 5th century BCE, found off the coast of Ibiza, may have been carrying a cargo of fish sauce stored in amphorae made in Gades (modern day Spain) and Tingi (modern-day Morocco). There are many early Graeco-Roman literary references to fish sauce, from writers such as Aristophanes, Sophocles and Aeschylus.&lt;/p&gt;&lt;/blockquote&gt;
&lt;p&gt;There also are literary references to the sauce from writers including Aristophanes, Sophocles, and Aeschylus, confirming its place in daily ancient life long before Rome’s domination of the region.&lt;/p&gt;
&lt;p&gt;The decline of fish sauce in the post-Roman era had several causes, of which salt scarcity and piracy are the most commonly cited. That’s not the whole story, though. The heavy salt taxes that followed the collapse of Roman administrative infrastructure also drove up the cost of producing fish sauce, and without Roman naval protection of the Mediterranean coasts, piracy disrupted the trade routes along which both salt and finished fish sauce had flowed. As a result, production ground to a stop across much of the region.&lt;/p&gt;
&lt;p&gt;There was also a cultural and religious dimension that is often overlooked, per Grainger. In the later Roman period when Christianity took over, many communities followed a blood prohibition. This meant people could not consume any kind of animal blood, whether from meat or fish. This prohibition is what caused stopped the actual &lt;em&gt;garum&lt;/em&gt; (made from fish blood) from being made. In the confusion of Roman terminology, once &lt;em&gt;garum&lt;/em&gt; stopped being used the word reverted (as words sometimes do!) to mean something else: in this case, the original Greek sauce, referred to as &lt;em&gt;liquamen &lt;/em&gt;during Roman times. &lt;em&gt;Liquamen&lt;/em&gt; was a staple among the general Roman population, whereas &lt;em&gt;garum&lt;/em&gt; was only consumed by those who could afford it, usually the elite.&lt;/p&gt;
&lt;h4&gt;Back to Asia: Did Fish Sauce Originate in China?&lt;/h4&gt;
&lt;p&gt;In his book &lt;a href="https://amzn.to/3Pnu4Ia"&gt;Salt: A World History&lt;/a&gt;, Mark Kurlansky theorises that the two fermented traditions developed independently in East and West, and that Asian fish sauce originated from an earlier Chinese tradition of fermenting fish with beans. “The sauce appears to be, as some historians believe of the domesticated pig, an idea that occurred independently in the East and the West,” he writes. “The Asian sauce is thought to have originated in Vietnam, though the Vietnamese must have taken it in ancient times from the Chinese soy sauce, in those early times when the Chinese fermented fish with the beans.” Since his book was written, the historical picture that emerged suggests fish sauce that had roots in ancient China, perhaps as far back as the Zhou Dynasty around 2,300 years ago. By 50–100 BCE demand had fallen drastically as fermented bean products rose to dominance instead. Fish sauce then became popular in Southeast Asia,  re-entering China’s palates in the 17th and 18th centuries via Vietnamese and Cambodian traders.&lt;/p&gt;
&lt;p&gt;&lt;a href="https://www.silkroadgourmet.com/garum-nuoc-mam/"&gt;Some scholars like food historian Laura Kelley have argued the opposite&lt;/a&gt;: that Roman fish sauce was the parent of modern day fish sauce, passing along the trade routes from West to East.&lt;/p&gt;
&lt;blockquote&gt;&lt;p&gt;“So, once again, we can identify a product that flowed from west to east and was eagerly adopted by Asians on the Silk Road. The recipes for garum changed and adapted as they moved east and became nuoc mam and nam pla according to cultural preferences and what gifts the Asian seas had to offer. Archaeologists and food scientists are working to confirm these flows and linkages, so stay tuned to this channel to learn more about garum production in the ancient world and in the kitchen of Chez Kelley.”&lt;/p&gt;&lt;/blockquote&gt;
&lt;p&gt;However,  food historian Khánh-Linh Trinh is direct in her skepticism about this theory.“There is insufficient evidence to readily support the idea that the recipe for fermented fish travelled across the Silk Road and influenced nuoc mam,” she &lt;a href="https://www.scmp.com/lifestyle/food-drink/article/3094604/did-fish-sauce-vietnam-come-ancient-rome-silk-road"&gt;notes&lt;/a&gt;. It’s not impossible, but there isn’t a historical smoking gun that would prove this theory.” A doctoral Candidate in Asian Languages and Cultures &lt;a href="https://lsa.umich.edu/asian/graduates/current-students/current-graduate-students/linh-khanh-trinh.html"&gt;at the University of Michigan&lt;/a&gt;, she instead goes back to the connection to China: &lt;em&gt;nuoc mam&lt;/em&gt; uses the same technique as Chinese soy sauce production, and similar levels of consistency and clarity as soy sauce.&lt;/p&gt;
&lt;p&gt;A scientific paper &lt;a href="https://www.jscimedcentral.com/jounal-article-info/Annals-of-Food-Processing-and-Preservation/Nuoc-Mam-Fish-Sauce-in-Vietnam-A-Long-History-from-Popular-Seasoning-to-Health-Benefit-Bioactive-Peptides-9175"&gt;published in the Annals of Food Processing and Preservation in 2017&lt;/a&gt; also looked at the technical treatment of&lt;em&gt; nuoc mam&lt;/em&gt; in Vietnam. Researchers at Nha Trang University’s Institute of Biotechnology and Environment note that &lt;em&gt;nuoc mam&lt;/em&gt; is produced along Vietnam’s entire coastline, from Cat Ba in the north to Phu Quoc in the south, with meaningful differences in fish species and technology by region. Among all regional varieties, Phu Quoc&lt;em&gt; nuoc mam&lt;/em&gt; ranks highest in quality, owing to the purity of the local &lt;em&gt;Stolephorus commersonii &lt;/em&gt;anchovies, the early salting process, and the humid island climate. (Phu Quoc’s fish sauce was also the first product in Southeast Asia to receive a &lt;a href="http://seafood.vasep.com.vn/seafood/53_8122/phu-quoc-fish-sauce-granted-eu-protection.htm"&gt;Protected Designation of Origin certification from the EU Commission&lt;/a&gt;.) Given the relationship between China and Vietnam, it is an easy jump to think that Vietnam could have used the technique from ancient Chinese soy sauce and then applied it to what was readily available in Vietnam: fish.&lt;/p&gt;
&lt;p&gt;Back to &lt;a href="https://www.worldhistory.org/article/1276/fish-sauce-in-the-ancient-world/"&gt;Declan’s piece&lt;/a&gt;, where he notes that while some historians claim fish sauce was introduced to Asia via the Silk Road, others think it was independently invented.&lt;/p&gt;
&lt;blockquote&gt;&lt;p&gt;Either or both may be true. Interestingly, in 2010 CE, a team of researchers analysed samples of garum taken from containers preserved at Pompeii. They found that Roman fish sauce from the 1st century CE had an almost identical taste profile to those produced today in southeast Asia.&lt;/p&gt;&lt;/blockquote&gt;
&lt;p&gt;The reality is: we don’t know whether &lt;em&gt;liquamen&lt;/em&gt; and &lt;em&gt;nuoc mam&lt;/em&gt; are relatives, or twins that were separated at birth. Either way, it’s not a stretch to think of how people may have used the same logic to start fermenting a perishable good to make an umami sauce that helped food taste better. And Trinh also reminds us that the origins debate, however fascinating, is somewhat beside the point for those who grew up with the sauce. She &lt;a href="https://www.scmp.com/lifestyle/food-drink/article/3094604/did-fish-sauce-vietnam-come-ancient-rome-silk-road"&gt;points out&lt;/a&gt; that &lt;em&gt;nuoc mam&lt;/em&gt; features in the Vietnamese creation myth itself: the story of Dragon Prince Lạc Long Quân, whose totem was a fish. “This indicates that regardless of whether &lt;em&gt;nuoc mam&lt;/em&gt; was actually around in Vietnamese prehistory, Vietnamese conceptions of national identity certainly chose to project &lt;em&gt;nuoc mam&lt;/em&gt; back into that history as a key token of what it means to be Vietnamese.”&lt;/p&gt;
&lt;p&gt;Her perspective is echoed by writer Trần Ngọc Thêm, whose book &lt;em&gt;Cơ sở văn hóa Việt Nam&lt;/em&gt; (The Foundation of Vietnamese Culture), includes the following sentence (translated): “for Vietnamese people, a meal without fish sauce is considered incomplete.”&lt;/p&gt;
&lt;p&gt;After all the history and debate about origins, that feels like the only answer that really matters.&lt;/p&gt;
&lt;h4&gt;While we travel for the people and the culture, for the stories and the food, we sometimes take the origins of individual ingredients, like fish sauce or &lt;a href="https://www.legalnomads.com/history-chili-peppers/"&gt;chili peppers&lt;/a&gt;, for granted.&lt;/h4&gt;
&lt;p&gt;If this short overview of fish sauce was interesting you might want to read:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;&lt;a href="http://amzn.to/2a0aQQ7"&gt;Mark Kurlansky, &lt;em&gt;Salt: A World History&lt;/em&gt;&lt;/a&gt;&lt;/strong&gt; — The foundational popular history of salt and its role in human civilization, including fish sauce.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;&lt;a href="http://amzn.to/2apAxPz"&gt;Veronica Meewes, &lt;em&gt;The Fish Sauce Cookbook&lt;/em&gt;&lt;/a&gt;&lt;/strong&gt; — A practical guide to cooking with fish sauce across many traditions.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Sally Grainger, &lt;a href="https://amzn.to/4uuUMyB"&gt;&lt;em&gt;The Story of Garum: Fermented Fish Sauce and Salted Fish in the Ancient World&lt;/em&gt;&lt;/a&gt; &lt;/strong&gt;— A scholarly treatment of ancient fish sauce, and an option for anyone who wants to go deeper than this short piece. Also available as an eBook.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;&lt;a href="http://www.slate.com/articles/life/food/2012/05/ketchup_s_chinese_origins_how_it_evolved_from_fish_sauce_to_today_s_tomato_condiment.html"&gt;The History of Ketchup&lt;/a&gt;&lt;/strong&gt;, by Dan Jurafsky — A delightful piece tracing ketchup’s origins back through fermented fish sauce.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Espregueira Themudo et al., “&lt;a href="https://www.cambridge.org/core/journals/antiquity/article/roman-atlantic-garum-dna-confirms-sardine-use-and-population-continuity-in-northwestern-iberia/9487347327F3724D1D2C4F72266DAEF3"&gt;Roman Atlantic garum: DNA confirms sardine use and population continuity in north-western Iberia&lt;/a&gt;,” &lt;em&gt;Antiquity&lt;/em&gt; (2025)&lt;/strong&gt; — The 2025 ancient DNA paper that confirmed the species used in a Roman-era Spanish fish-factory.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;&lt;a href="https://www.worldhistory.org/article/1276/fish-sauce-in-the-ancient-world/"&gt;World History Encyclopedia: Fish Sauce in the Ancient World&lt;/a&gt;&lt;/strong&gt; — A well-sourced overview.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;&lt;a href="https://www.thekitchn.com/recipe-vegan-fish-sauce-130535"&gt;Vegan fish sauce recipe via The Kitchn&lt;/a&gt;&lt;/strong&gt; — For those who don’t eat fish.&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;Bon Appetit!&lt;/p&gt;
&lt;p&gt;-Jodi&lt;/p&gt;
&lt;/div&gt;
</ns0:encoded></item><item><title>The Bromine Chokepoint</title><link>https://warontherocks.com/cogs-of-war/the-bromine-chokepoint-how-strife-in-the-middle-east-could-halt-production-of-the-worlds-memory-chips/</link><pubDate>Sun, 19 Apr 2026 17:44:03 +0000</pubDate><comments>https://news.ycombinator.com/item?id=47826100</comments><description>&lt;a href="https://news.ycombinator.com/item?id=47826100"&gt;Comments&lt;/a&gt;</description><ns0:encoded xmlns:ns0="http://purl.org/rss/1.0/modules/content/">&lt;div class="tw:w-full tw:lg:w-4/6 tw:space-y-4 tw:text-[#0d101d] tw:font-ivar-text! tw:font-bold! tw:text-[1rem] md:tw:text-[1.25rem] tw:max-w-3xl [p&amp;amp;]:tw:font-ivar-text!" morss_own_score="5.470352206865805" morss_score="63.9289041443695"&gt;
&lt;p&gt;The U.S.-Israeli war with Iran, now in an unstable ceasefire, has exposed a structural failure in the global semiconductor memory supply chain, and it is not the one analysts seem to be tracking. The story receiving attention is &lt;a href="https://www.cnbc.com/2026/03/19/the-iran-war-is-threatening-supply-helium-what-it-means-for-markets.html"&gt;helium&lt;/a&gt;: Qatar’s Ras Laffan facility went &lt;a href="https://en.sedaily.com/international/2026/03/05/qatar-helium-halt-threatens-global-chip-supply"&gt;offline&lt;/a&gt;, a 45-day inventory clock started running, and spot prices doubled within days. The story receiving almost no attention is bromine, and it is potentially the more dangerous one. Bromine is the raw material from which specialized chemical suppliers produce semiconductor-grade hydrogen bromide gas, the etch chemical that South Korean fabs use to carve the transistor structures in every Dynamic Random-Access Memory (DRAM) and NAND flash chip on earth. A DRAM chip powers active computation and loses its contents the moment power cuts. A NAND chip retains data without power and underlies every form of digital storage. Together they underpin every modern computing device, from the phone in your pocket to the data center running your AI applications.&lt;/p&gt;&lt;p&gt;South Korea sources &lt;a href="https://www.trendforce.com/news/2026/03/09/news-middle-east-energy-turmoil-raises-chip-risks-spotlight-on-tsmc-power-use-and-bromine-for-dram/"&gt;97.5 percent&lt;/a&gt; of its bromine imports from Israel. Beyond that vulnerable concentration, converting bromine into semiconductor-grade hydrogen bromide gas requires dedicated purification infrastructure, and producers outside Israel are already fully committed to existing customers and stretched too thin to absorb additional demand. Building new conversion capacity takes years of permitting, equipment procurement, and fabrication qualification.&lt;/p&gt;&lt;p&gt;&lt;a href="https://icl-group-sustainability.com/reports/icl-dead-sea-israel/"&gt;ICL Group&lt;/a&gt;, the Israeli multinational formerly known as Israel Chemicals Ltd., currently continues Dead Sea operations. Israel routes most trade through Mediterranean ports at Haifa and Ashdod, bypassing the Strait of Hormuz entirely. But Iran has been striking the &lt;a href="https://www.pbs.org/newshour/world/dozens-injured-in-israel-after-iranian-missile-strikes-target-two-areas-near-main-nuclear-research-center/"&gt;Negev&lt;/a&gt; — Israel’s southern desert and the heart of its defense and industrial infrastructure — with ballistic missiles for three weeks, hitting Dimona and Arad, both within 35 kilometers of ICL’s Dead Sea extraction and conversion complex. If Israeli bromine production is displaced, there are no conversion facilities outside Israel capable of immediately producing semiconductor-grade hydrogen bromide gas at the scale required to replace it, and policymakers have not yet acted on that fact.&lt;/p&gt;&lt;p&gt;The vulnerability sits in plain sight, within missile range and outside any meaningful policy response. A disruption would be immediate and global. Within weeks, shortages would propagate across everything from consumer devices to military systems.&lt;/p&gt;&lt;h5&gt;&lt;strong&gt;Bromine Cannot Be Substituted or Quickly Replaced&lt;/strong&gt;&lt;/h5&gt;&lt;p&gt;Bromine’s role in semiconductor manufacturing is specific and non-substitutable. Its primary derivative, hydrogen bromide, is consumed at the polysilicon etching stage foundational to both DRAM and NAND flash &lt;a href="https://www.pall.com/content/dam/pall/microelectronics/literature-library/non-gated/HBr_Polysilicon.pdf"&gt;production&lt;/a&gt;. Each DRAM memory cell requires a polysilicon gate electrode etched with extreme precision over a silicon oxide layer as thin as 20 angstroms. Hydrogen bromide gas plasmas achieve a polysilicon-to-oxide selectivity ratio of &lt;a href="https://patents.google.com/patent/US5007982A/en"&gt;100 to 1&lt;/a&gt;, while chlorine-based alternatives achieve roughly 30 to 1. At advanced DRAM node geometries, that is the difference between a functional transistor and a destroyed one. Bromine also appears in chemical vapor deposition processes and chip packaging. There is no viable near-term substitute in any of these applications.&lt;/p&gt;&lt;p&gt;Three structural realities determine why the gap cannot be bridged through market reallocation. First, bromine already converted for industrial use such as flame retardants and drilling fluids cannot be &lt;a href="https://www.nature.com/articles/s41893-026-01777-z"&gt;reconverted&lt;/a&gt;. Those processes are chemically irreversible at any industrial scale and the resulting compounds cannot meet the parts-per-billion purity specifications that fabrication facilities require. The two supply chains draw from the same raw material but diverge permanently at the point of conversion. Second, converting raw bromine to semiconductor-grade hydrogen bromide gas requires dedicated purification infrastructure, specifically &lt;a href="https://studylib.net/doc/25615495/hbr-polysilicon"&gt;gas-phase distillation columns&lt;/a&gt; capable of lowering trace metals to parts-per-billion contamination levels. That infrastructure does not exist at scale outside the existing semiconductor chemical supply chain, and building more facilities requires permitting, equipment procurement, testing, and fabrication qualification measured in years. Third, producers such as Resonac, Air Liquide, and Adeka manufacture semiconductor-grade hydrogen bromide gas outside Israel, but their combined capacity is already &lt;a href="https://www.intelmarketresearch.com/hbr-market-3732"&gt;committed&lt;/a&gt; to existing customers: Taiwan Semiconductor Manufacturing Company, the world’s dominant contract chipmaker; Samsung, the leading producer of DRAM and high-bandwidth memory; and Semiconductor Manufacturing International Corporation, China’s largest state-backed foundry. Critically, those customers are not holding steady: AI infrastructure buildout is accelerating demand across the board, meaning outside producers are stretched thin against a growing baseline. Even if outside producers could expand output, South Korean facilities would be competing for that capacity with Taiwan, Samsung’s own logic plants, and China, all of whom face the same accelerating demand.&lt;/p&gt;&lt;h5&gt;&lt;strong&gt;The Chokepoint and Its Consequences&lt;/strong&gt;&lt;/h5&gt;&lt;p&gt;The Dead Sea is among the most bromine-rich bodies of water on earth. ICL Group, which extracts at the lowest cost of any producer globally, dominates a supply that Israel and Jordan together account for roughly two thirds of globally. Critically, ICL’s hydrogen bromide gas production, including the semiconductor-grade output supplied to South Korean fabrication plants, is manufactured at the same &lt;a href="https://icl-industrialproducts.com/products/hbr-liquified/"&gt;Sodom facility&lt;/a&gt; where extraction occurs, meaning extraction and conversion infrastructure are co-located in the same vulnerable corridor. Iranian missiles have already penetrated Israeli air defenses in the Negev on multiple occasions, wounding nearly 200 people in Dimona and Arad, both in the same geographic corridor as ICL’s production and conversion sites.&lt;/p&gt;&lt;p&gt;The mechanism of disruption does not require a direct hit on an ICL facility. &lt;a href="https://blogs.tarangya.com/the-red-zone-iran-israel-and-the-usa-war-and-shipping-insurance-in-2026/"&gt;War risk insurance&lt;/a&gt; for vessel calls at Israeli ports has already risen from 0.2 percent to between 0.7 and 1.0 percent of vessel value per seven-day call, adding up to $500,000 in costs per voyage on a mid-sized cargo ship. Even for ships routed through the Mediterranean rather than the Red Sea, those insurance costs apply the moment a vessel calls at an Israeli port. The war risk premium follows the port, not the route. &lt;a href="https://www.zim.com/customer-updates/war-risk-premium-charge-wrp-update"&gt;ZIM&lt;/a&gt;, Israel’s primary shipping line, has implemented a “war risk premium surcharge” on all cargo to and from Israel. Haifa oil refinery — the country’s largest — was shut down after its power station was &lt;a href="https://www.timesofisrael.com/all-facilities-at-haifa-oil-refinery-shut-down-after-deadly-iran-missile-strike/"&gt;damaged&lt;/a&gt; in an Iranian attack, demonstrating that critical industrial infrastructure does not require a direct strike to be forced offline. The downstream consequences of even a partial disruption to that corridor would propagate immediately across the global memory supply chain.&lt;/p&gt;&lt;p&gt;&lt;a href="https://www.trendforce.com/news/2025/12/02/news-memory-price-rally-may-run-past-2028-as-samsung-sk-hynix-reportedly-cautious-on-expansion/"&gt;Samsung and SK hynix&lt;/a&gt; together dominate approximately 70 percent of the global &lt;a href="https://marklapedus.substack.com/p/sk-hynix-surpasses-samsung-in-dram"&gt;DRAM&lt;/a&gt; market. SK hynix alone holds roughly 57 percent of the &lt;a href="https://marklapedus.substack.com/p/sk-hynix-lead-shrinks-in-dram-hbm"&gt;high bandwidth memory&lt;/a&gt; market. Since DRAM and NAND underpin every modern computing device, a supply disruption would propagate across the full consumer and industrial electronics stack, not only AI infrastructure. &lt;a href="https://marklapedus.substack.com/p/sk-hynix-surpasses-samsung-in-dram"&gt;High bandwidth memory&lt;/a&gt; — a specialized form of DRAM stacked vertically to deliver the data speeds that AI accelerators such as Nvidia’s graphics processing units require — is sold out through 2026, and DRAM suppliers hold only two to three weeks of inventory. A shortage would force both companies to allocate scarce hydrogen bromide gas to their highest-value lines — high bandwidth memory for AI accelerators — at the expense of commodity DRAM and NAND used in phones, personal computers, laptops, and data storage. The consequences fall hardest across Africa, South Asia, and Latin America, where memory already accounts for 15 to 20 percent of the bill of materials for a mid-range smartphone. That share rises sharply for budget devices, the primary gateway to digital participation across Africa, South Asia, and Latin America. Smartphone prices in &lt;a href="https://www.tbsnews.net/economy/corporates/global-dram-and-nand-flash-crisis-drives-10-25-smartphone-price-surge-bangladesh"&gt;Bangladesh&lt;/a&gt; have already risen 10 to 25 percent in 2026 as a direct result of DRAM and NAND inflation, with similar increases reported in &lt;a href="https://dailytrust.com/smartphones-prices-to-increase-by-20-in-nigeria/"&gt;Nigeria&lt;/a&gt; and &lt;a href="https://lifestyleandtech.co.za/business/article/2026-01-08/rising-memory-costs-threaten-smartphone-affordability-in-south-africa/"&gt;South Africa&lt;/a&gt;. &lt;a href="https://www.trendforce.com/presscenter/news/20251211-12831.html"&gt;Budget smartphones&lt;/a&gt; are reverting to 4 gigabytes of RAM in 2026, precisely as on-device AI features demand more, not less. A bromine supply shock would price hundreds of millions of people out of the devices through which they access banking, education, healthcare, and economic opportunity.&lt;/p&gt;&lt;p&gt;The exposure extends beyond commercial technology. The &lt;a href="https://www.ibisworld.com/blog/semiconductor-supply-chain/1/1126/"&gt;majority&lt;/a&gt; of guidance systems, radar modules, and electronic warfare packages fielded by the U.S. military run on DRAM and NAND flash chips sourced from the same commercial facilities, on the same allocation logic, with less procurement flexibility than commercial customers. Since the Defense Department shifted to commercial off-the-shelf procurement in the 1990s, there is no &lt;a href="https://militaryembedded.com/comms/communications/semiconductor-supply-chain-challenges"&gt;separate&lt;/a&gt; defense-grade memory supply chain. A shortage that forces Samsung and SK hynix to prioritize high-margin high bandwidth memory for AI customers would deprioritize the commodity DRAM used in precision-guided munitions, intelligence platforms, and shipboard radar systems, with no government visibility into how that allocation decision gets made. The same war straining ICL’s operational continuity is simultaneously &lt;a href="https://militaryembedded.com/radar-ew/rf-and-microwave/miniaturizing-precision-guided-weapon-technologies"&gt;depleting&lt;/a&gt; munitions stockpiles whose guidance systems depend on the same memory supply chain. The supply stress and the demand spike are running in the same direction at the same time.&lt;/p&gt;&lt;p&gt;The consequences for American AI follow directly from the South Korean exposure but run through a supply chain that most U.S. policymakers have never traced. Every Nvidia Blackwell and Rubin graphics processing unit requires high-bandwidth memory stacks that come almost entirely from SK hynix and Samsung, as SK hynix is &lt;a href="https://marklapedus.substack.com/p/sk-hynix-surpasses-samsung-in-dram"&gt;Nvidia’s primary high-bandwidth memory supplier&lt;/a&gt; for both platforms. Microsoft, Amazon, Google, and Meta are deploying hundreds of billions of dollars in AI infrastructure on delivery schedules that assume South Korean plants will have uninterrupted access to the etch chemicals they need. A bromine disruption produces delivery slippage, renegotiated contracts, higher spot prices, and delayed server deployments.&lt;/p&gt;&lt;h5&gt;&lt;strong&gt;South Korea, the United States, and Israel Need to Act&lt;/strong&gt;&lt;/h5&gt;&lt;p&gt;Three levers are available, and they require action simultaneously. First, the most immediate is physical pre-positioning. &lt;a href="https://www.albemarle.com/businesses/bromine-specialties/bromine-&amp;amp;-derivatives/specialty-chemicals"&gt;Arkansas bromine&lt;/a&gt; from &lt;a href="https://www.albemarle.com/businesses/bromine-specialties/bromine-&amp;amp;-derivatives/specialty-chemicals"&gt;Albemarle&lt;/a&gt; and &lt;a href="https://ir.onetetra.com/news/news-details/2025/TETRA-TECHNOLOGIES-INC--ANNOUNCES-RESOURCE-UPGRADE-FOR-ARKANSAS-BROMINE-PROJECT-AND-ADDITIONAL-CRITICAL-MINERALS/default.aspx"&gt;TETRA Technologies&lt;/a&gt; cannot be used directly in chip production, but it could serve as feedstock for semiconductor-grade hydrogen bromide gas conversion if that infrastructure existed, which is precisely the gap that ought to be closed. South Korean companies could also establish &lt;a href="https://www.koreaherald.com/article/10701656"&gt;bromine forward contracts&lt;/a&gt; locking in supply and price for 12 to 18 months.&lt;/p&gt;&lt;p&gt;Second, the single most important structural action is the one with the longest lead time: building &lt;a href="https://studylib.net/doc/25615495/hbr-polysilicon"&gt;semiconductor-grade hydrogen bromide gas&lt;/a&gt; conversion capacity outside Israel. The &lt;a href="https://www.indo-pacificstudiescenter.org/commentaries/chips-act-chip4-alliance"&gt;Chip 4 framework&lt;/a&gt; should be extended to include a critical materials annex with a coordinated allied program to site, permit, and fund dedicated gas-phase distillation infrastructure capable of achieving parts-per-billion purity in geographically diversified locations — particularly in South Korea, Japan, and the United States. Private firms will not build conversion infrastructure at this scale and speed without government mandate, offtake guarantees and permitting priority.&lt;/p&gt;&lt;p&gt;Third, each government should take action in their own lanes, but in a coordinated fashion. South Korea should designate bromine a critical mineral, mandate minimum inventory levels, and fund domestic &lt;a href="https://studylib.net/doc/25615495/hbr-polysilicon"&gt;conversion infrastructure&lt;/a&gt; jointly with &lt;a href="https://www.trendforce.com/news/2025/12/02/news-memory-price-rally-may-run-past-2028-as-samsung-sk-hynix-reportedly-cautious-on-expansion/"&gt;Samsung&lt;/a&gt; and &lt;a href="https://marklapedus.substack.com/p/sk-hynix-lead-shrinks-in-dram-hbm"&gt;SK hynix&lt;/a&gt;. The United States should add bromine, semiconductor-grade hydrogen bromide gas, and the full range of specialty gases derived from bromine to the critical minerals list, and use &lt;a href="https://www.koreaherald.com/article/10701656"&gt;Defense Production Act authority&lt;/a&gt; and &lt;a href="https://www.congress.gov/bill/117th-congress/house-bill/4346"&gt;CHIPS and Science Act&lt;/a&gt; funding to co-invest with allies in purification capacity on allied soil. Israel should formalize bromine as a strategic export commodity, harden ICL’s production sites against missile attack, and use the &lt;a href="https://www.global-agriculture.com/crop-nutrition/icl-signs-binding-agreement-with-israel-on-dead-sea-concession-assets-ahead-of-2030-expiry/"&gt;2030 Dead Sea&lt;/a&gt; concession expiration to bring in allied capital in exchange for long-term supply priority.&lt;/p&gt;&lt;h5&gt;&lt;strong&gt;Conclusion&lt;/strong&gt;&lt;/h5&gt;&lt;p&gt;In sum, the bromine risk sits outside every dashboard anyone is monitoring. The structural failure is not the war: It is that the global memory supply chain has built itself around a conversion chokepoint with no redundancy and no fallback. If ICL’s Sodom facility goes offline, the gap does not get filled. The action that matters most — building semiconductor-grade hydrogen bromide gas conversion capacity outside Israel — takes years. The actions available now — forward contracts, inventory mandates, and Arkansas feedstock development — buy months at best, not years. That gap is precisely why these three countries should move now, before an Iranian ballistic missile makes the answer irrelevant.&lt;/p&gt;&lt;p&gt;&lt;em&gt;Alvin Camba, Ph.D., is lead scientist and director of research at Lyvi. He is also a nonresident fellow in the Indo-Pacific Security Initiative at the Atlantic Council’s Scowcroft Center for Strategy and Security, and a senior research fellow at Associated Universities, Inc. His book on Chinese megaprojects and coalition politics in Southeast Asia is in production at Cornell University Press.&lt;/em&gt;&lt;/p&gt;&lt;p&gt;&lt;em&gt;**Please note, as a matter of house style, &lt;/em&gt;War on the Rocks &lt;em&gt;will not use a different name for the U.S. Department of Defense until and unless the name is changed by statute by the U.S. Congress.&lt;/em&gt;&lt;/p&gt;&lt;p&gt;Image: NASA/GSFC/METI/ERSDAC/JAROS and U.S./Japan ASTER Science Team via &lt;a href="https://science.nasa.gov/photojournal/the-dead-sea/"&gt;NASA&lt;/a&gt;.&lt;/p&gt;
&lt;/div&gt;
</ns0:encoded></item><item><title>Show HN: How context engineering works, a runnable reference</title><link>https://github.com/outcomeops/context-engineering</link><pubDate>Fri, 17 Apr 2026 18:20:49 +0000</pubDate><comments>https://news.ycombinator.com/item?id=47808956</comments><description>&lt;a href="https://news.ycombinator.com/item?id=47808956"&gt;Comments&lt;/a&gt;</description><ns0:encoded xmlns:ns0="http://purl.org/rss/1.0/modules/content/">&lt;article class="markdown-body entry-content container-lg" itemprop="text" morss_own_score="6.669683257918553" morss_score="78.21040327781057"&gt;&lt;h1&gt;Context Engineering&lt;/h1&gt;
&lt;p&gt;A working reference implementation of &lt;strong&gt;context engineering&lt;/strong&gt; — the discipline of designing, retrieving, and injecting the information an AI system needs to produce accurate, organization-specific outputs.&lt;/p&gt;
&lt;p&gt;This repo is the code companion to &lt;a href="https://www.outcomeops.ai/context-engineering"&gt;&lt;strong&gt;What Is Context Engineering?&lt;/strong&gt;&lt;/a&gt; on outcomeops.ai. The glossary defines the concepts; this repo shows them running end-to-end against a real corpus on Amazon Bedrock.&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;Context engineering treats context as a first-class engineering artifact — version-controlled, retrievable, and enforceable — rather than as prompts typed into a chat window.&lt;/p&gt;
&lt;/blockquote&gt;
&lt;hr&gt;
&lt;h2&gt;The five components&lt;/h2&gt;
&lt;p&gt;A context engineering system has five components. Each folder implements one against the same running example (a Spring PetClinic codebase with ADRs):&lt;/p&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;#&lt;/th&gt;
&lt;th&gt;Component&lt;/th&gt;
&lt;th&gt;What it does&lt;/th&gt;
&lt;th&gt;Folder&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;1&lt;/td&gt;
&lt;td&gt;&lt;strong&gt;Corpus&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;The organizational material that defines how you think, build, and decide&lt;/td&gt;
&lt;td&gt;&lt;a href="https://github.com/outcomeops/context-engineering/blob/main/01-corpus"&gt;&lt;code&gt;01-corpus/&lt;/code&gt;&lt;/a&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;2&lt;/td&gt;
&lt;td&gt;&lt;strong&gt;Retrieval&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;Identifies which portions of the corpus are relevant to a given request&lt;/td&gt;
&lt;td&gt;&lt;a href="https://github.com/outcomeops/context-engineering/blob/main/02-retrieval"&gt;&lt;code&gt;02-retrieval/&lt;/code&gt;&lt;/a&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;3&lt;/td&gt;
&lt;td&gt;&lt;strong&gt;Injection&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;Gets retrieved context into the model's working memory at decision time&lt;/td&gt;
&lt;td&gt;&lt;a href="https://github.com/outcomeops/context-engineering/blob/main/03-injection"&gt;&lt;code&gt;03-injection/&lt;/code&gt;&lt;/a&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;4&lt;/td&gt;
&lt;td&gt;&lt;strong&gt;Output&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;Produces reviewable artifacts (code, PRs, docs) shaped by that context&lt;/td&gt;
&lt;td&gt;&lt;a href="https://github.com/outcomeops/context-engineering/blob/main/04-output"&gt;&lt;code&gt;04-output/&lt;/code&gt;&lt;/a&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;5&lt;/td&gt;
&lt;td&gt;&lt;strong&gt;Enforcement&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;Ensures the generated output actually reflects the retrieved context&lt;/td&gt;
&lt;td&gt;&lt;a href="https://github.com/outcomeops/context-engineering/blob/main/05-enforcement"&gt;&lt;code&gt;05-enforcement/&lt;/code&gt;&lt;/a&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;
&lt;p&gt;Plus &lt;a href="https://github.com/outcomeops/context-engineering/blob/main/comparisons"&gt;&lt;code&gt;comparisons/&lt;/code&gt;&lt;/a&gt; — the same task run with and without context engineering, plus how CE differs from RAG, Copilot, and agent frameworks.&lt;/p&gt;
&lt;p&gt;A system with only components 1–3 is a RAG system. The output and enforcement layers are what make CE different — they make the generated content reviewable and governable.&lt;/p&gt;
&lt;hr&gt;
&lt;h2&gt;Running the examples&lt;/h2&gt;
&lt;p&gt;All examples use &lt;strong&gt;Amazon Bedrock&lt;/strong&gt; with Claude. Each folder has its own &lt;code&gt;requirements.txt&lt;/code&gt; and &lt;code&gt;README.md&lt;/code&gt; with a runnable command.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Prerequisites:&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Python 3.11+&lt;/li&gt;
&lt;li&gt;AWS account with credentials configured (&lt;code&gt;aws configure&lt;/code&gt; or env vars)&lt;/li&gt;
&lt;li&gt;AWS region that supports Claude and Titan (e.g. &lt;code&gt;us-east-1&lt;/code&gt;, &lt;code&gt;us-west-2&lt;/code&gt;)&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;This repo uses Anthropic Claude for generation and Amazon Titan for embeddings. Titan and most Bedrock foundation models are &lt;strong&gt;auto-enabled&lt;/strong&gt; on first invocation — no action needed.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Anthropic Claude requires a one-time First Time Use (FTU) form per AWS account.&lt;/strong&gt; If your account has never used Anthropic models on Bedrock, the first script run will fail with &lt;code&gt;AccessDeniedException&lt;/code&gt;. To fix:&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;Open any Anthropic Claude model in the &lt;a href="https://console.aws.amazon.com/bedrock/home#/model-catalog"&gt;Bedrock model catalog&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;Fill the First Time Use form (company, use case — about a minute)&lt;/li&gt;
&lt;li&gt;Submit — access is granted immediately, no review queue&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;If you're in an AWS Organization child account, the form must be submitted from the management account to inherit access.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Quickstart:&lt;/strong&gt;&lt;/p&gt;
&lt;pre&gt;git clone https://github.com/outcomeops/context-engineering.git
&lt;span&gt;cd&lt;/span&gt; context-engineering/01-corpus
pip install -r requirements.txt
python ingest_adrs.py ./sample-adrs&lt;/pre&gt;
&lt;p&gt;Set the model via environment variable if you want to override the default:&lt;/p&gt;
&lt;pre&gt;&lt;span&gt;export&lt;/span&gt; BEDROCK_MODEL_ID=&lt;span&gt;&lt;span&gt;"&lt;/span&gt;us.anthropic.claude-sonnet-4-5-20250929-v1:0&lt;span&gt;"&lt;/span&gt;&lt;/span&gt;
&lt;span&gt;export&lt;/span&gt; AWS_REGION=&lt;span&gt;&lt;span&gt;"&lt;/span&gt;us-east-1&lt;span&gt;"&lt;/span&gt;&lt;/span&gt;&lt;/pre&gt;
&lt;hr&gt;
&lt;h2&gt;Why this repo exists&lt;/h2&gt;
&lt;p&gt;Most AI coding assistants produce generic output. An engineer using a generic assistant still has to adapt the output to local patterns — the assistant doesn't know what your team decided last quarter, what your compliance framework requires, or why you picked one library over another.&lt;/p&gt;
&lt;p&gt;A context-engineered system produces output that already conforms to local patterns, because the retrieval layer has fed the model the relevant ADRs, code, and standards at decision time. The enforcement layer ensures the output actually cites what it relied on.&lt;/p&gt;
&lt;p&gt;This repo exists to show the pattern in code, end-to-end, so teams can build it themselves or evaluate commercial tools that claim to do it.&lt;/p&gt;
&lt;hr&gt;
&lt;h2&gt;Context engineering changes organizations, not just code&lt;/h2&gt;
&lt;p&gt;The five-component model is the technical frame. Teams that actually deploy it consistently discover the harder shift is organizational. Roles, KPIs, and decision rights in a traditional software org were shaped by a world where AI could not read the corpus. Once it can, the middle layers of that structure start to look different — and the repo above is only useful in the first place because of those changes.&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;a href="https://www.outcomeops.ai/blogs/the-rise-of-the-outcome-engineer"&gt;The rise of the outcome engineer&lt;/a&gt; — the emerging role&lt;/li&gt;
&lt;li&gt;&lt;a href="https://www.outcomeops.ai/blogs/engineers-who-own-the-outcome"&gt;Engineers who own the outcome&lt;/a&gt; — the operating model&lt;/li&gt;
&lt;li&gt;&lt;a href="https://www.outcomeops.ai/blogs/outcomeops-and-context-engineering-the-next-corporate-evolution-beyond-devops"&gt;OutcomeOps and context engineering: the next corporate evolution beyond DevOps&lt;/a&gt; — what comes after DevOps&lt;/li&gt;
&lt;li&gt;&lt;a href="https://www.outcomeops.ai/blogs/death-of-the-traditional-product-owner"&gt;Death of the traditional product owner&lt;/a&gt; — the product-side role shift&lt;/li&gt;
&lt;li&gt;&lt;a href="https://www.outcomeops.ai/blogs/measurng-what-actually-matters"&gt;Measuring what actually matters&lt;/a&gt; — the KPI shift&lt;/li&gt;
&lt;/ul&gt;
&lt;hr&gt;
&lt;h2&gt;Further reading&lt;/h2&gt;
&lt;p&gt;Foundational articles, reference guides, and practitioner writeups on context engineering as a discipline:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;a href="https://www.anthropic.com/engineering/effective-context-engineering-for-ai-agents"&gt;Effective context engineering for AI agents&lt;/a&gt; (Anthropic, Sep 2025) — curating and limiting what an agent sees&lt;/li&gt;
&lt;li&gt;&lt;a href="https://blog.langchain.com/the-rise-of-context-engineering/"&gt;The rise of context engineering&lt;/a&gt; (LangChain, Jun 2025) — the article that made the term widely used&lt;/li&gt;
&lt;li&gt;&lt;a href="https://blog.langchain.com/context-engineering-for-agents/"&gt;Context engineering for agents&lt;/a&gt; (LangChain, Jul 2025) — write/select/compress/isolate framing&lt;/li&gt;
&lt;li&gt;&lt;a href="https://addyo.substack.com/p/context-engineering-bringing-engineering"&gt;Context Engineering: Bringing Engineering Discipline to Prompts&lt;/a&gt; (Addy Osmani, Jul 2025) — engineering-discipline framing&lt;/li&gt;
&lt;li&gt;&lt;a href="https://www.promptingguide.ai/guides/context-engineering-guide"&gt;Context Engineering Guide&lt;/a&gt; (PromptingGuide.ai) — reference entry&lt;/li&gt;
&lt;li&gt;&lt;a href="https://cognitect.com/blog/2011/11/15/documenting-architecture-decisions"&gt;Documenting Architecture Decisions&lt;/a&gt; (Michael Nygard, 2011) — the original ADR essay; the format used throughout this repo&lt;/li&gt;
&lt;li&gt;&lt;a href="https://www.outcomeops.ai/blogs/outcomeops-and-context-engineering-the-next-corporate-evolution-beyond-devops"&gt;OutcomeOps and context engineering: the next corporate evolution beyond DevOps&lt;/a&gt; (OutcomeOps) — the organizational thesis behind this repo&lt;/li&gt;
&lt;li&gt;&lt;a href="https://www.outcomeops.ai/blogs/outcomeops-self-documenting-architecture-when-code-becomes-queryable"&gt;OutcomeOps: self-documenting architecture — when code becomes queryable&lt;/a&gt; (OutcomeOps) — how ADR corpora compound as code evolves&lt;/li&gt;
&lt;li&gt;&lt;a href="https://www.outcomeops.ai/blogs/the-real-cost-of-knowledge-why-most-ai-engineering-platforms-over-engineer-rag"&gt;The real cost of knowledge: why most AI engineering platforms over-engineer RAG&lt;/a&gt; (OutcomeOps) — against premature retrieval infrastructure&lt;/li&gt;
&lt;li&gt;&lt;a href="https://www.outcomeops.ai/blogs/what-ai-assisted-development-actually-looks-like-in-two-years"&gt;What AI-assisted development actually looks like in two years&lt;/a&gt; (OutcomeOps) — the working developer's view&lt;/li&gt;
&lt;/ul&gt;
&lt;h2&gt;Companion repositories&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;a href="https://github.com/bonigarcia/context-engineering"&gt;bonigarcia/context-engineering&lt;/a&gt; — book companion from Boni García; organized by chapter with polyglot examples&lt;/li&gt;
&lt;li&gt;&lt;a href="https://github.com/davidkimai/Context-Engineering"&gt;davidkimai/Context-Engineering&lt;/a&gt; — concepts, patterns, and techniques&lt;/li&gt;
&lt;li&gt;&lt;a href="https://github.com/Meirtz/Awesome-Context-Engineering"&gt;Meirtz/Awesome-Context-Engineering&lt;/a&gt; — curated list of papers, tools, and articles&lt;/li&gt;
&lt;li&gt;&lt;a href="https://github.com/joelparkerhenderson/architecture-decision-record"&gt;joelparkerhenderson/architecture-decision-record&lt;/a&gt; — the definitive ADR resource list&lt;/li&gt;
&lt;/ul&gt;
&lt;h2&gt;Deep dives by component&lt;/h2&gt;
&lt;p&gt;Each folder's README has its own curated reading list; the quick index:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Corpus&lt;/strong&gt; — see &lt;a href="https://github.com/outcomeops/context-engineering/blob/main/01-corpus#further-reading"&gt;&lt;code&gt;01-corpus/&lt;/code&gt;&lt;/a&gt; — ADR formats, corpus bootstrapping, self-documenting architecture&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Retrieval&lt;/strong&gt; — see &lt;a href="https://github.com/outcomeops/context-engineering/blob/main/02-retrieval#further-reading"&gt;&lt;code&gt;02-retrieval/&lt;/code&gt;&lt;/a&gt; — FAISS, "Lost in the Middle," retrieval economics&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Injection&lt;/strong&gt; — see &lt;a href="https://github.com/outcomeops/context-engineering/blob/main/03-injection#further-reading"&gt;&lt;code&gt;03-injection/&lt;/code&gt;&lt;/a&gt; — prompt structure, token budgets, inference cost&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Output&lt;/strong&gt; — see &lt;a href="https://github.com/outcomeops/context-engineering/blob/main/04-output#further-reading"&gt;&lt;code&gt;04-output/&lt;/code&gt;&lt;/a&gt; — JSON Schema, Bedrock tool-use, the outcome engineer&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Enforcement&lt;/strong&gt; — see &lt;a href="https://github.com/outcomeops/context-engineering/blob/main/05-enforcement#further-reading"&gt;&lt;code&gt;05-enforcement/&lt;/code&gt;&lt;/a&gt; — LLM-as-judge research, PR-as-guardrail&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Comparisons&lt;/strong&gt; — see &lt;a href="https://github.com/outcomeops/context-engineering/blob/main/comparisons#further-reading"&gt;&lt;code&gt;comparisons/&lt;/code&gt;&lt;/a&gt; — CE vs RAG vs agents vs enterprise search&lt;/li&gt;
&lt;/ul&gt;
&lt;hr&gt;
&lt;h2&gt;About&lt;/h2&gt;
&lt;p&gt;Built by Brian Carpio at &lt;a href="https://www.outcomeops.ai"&gt;OutcomeOps&lt;/a&gt;. Questions, corrections, or contributions welcome via issues and PRs.&lt;/p&gt;
&lt;h2&gt;License&lt;/h2&gt;
&lt;p&gt;MIT — see &lt;a href="https://github.com/outcomeops/context-engineering/blob/main/LICENSE"&gt;LICENSE&lt;/a&gt;.&lt;/p&gt;
&lt;/article&gt;</ns0:encoded></item><item><title>2,100 Swiss municipalities showing which provider handles their official email</title><link>https://mxmap.ch/</link><pubDate>Sun, 19 Apr 2026 22:55:47 +0000</pubDate><comments>https://news.ycombinator.com/item?id=47828420</comments><description>&lt;a href="https://news.ycombinator.com/item?id=47828420"&gt;Comments&lt;/a&gt;</description><ns0:encoded xmlns:ns0="http://purl.org/rss/1.0/modules/content/">&lt;section id="info-bar" aria-label="About this project" morss_own_score="6.660606060606061" morss_score="10.077272727272726"&gt;
&lt;h2&gt;Email Providers of Swiss Municipalities&lt;/h2&gt;

&lt;div class="info-card" morss_own_score="3.0" morss_score="8.5"&gt;
&lt;h3&gt;What is this?&lt;/h3&gt;
&lt;p&gt;A map of all ~2,100 Swiss municipalities showing which provider handles their official email — grouped by jurisdiction — based on public DNS records and other public network signals.&lt;/p&gt;
&lt;/div&gt;
&lt;div class="info-card" morss_own_score="3.0" morss_score="8.5"&gt;
&lt;h3&gt;Context&lt;/h3&gt;
&lt;p&gt;Digital sovereignty: US-based providers are subject to the US CLOUD Act, which allows US authorities to request stored data, regardless of where it is physically hosted. This map makes the current provider landscape visible.&lt;/p&gt;
&lt;/div&gt;
&lt;div class="info-card" morss_own_score="3.0" morss_score="11.0"&gt;
&lt;h3&gt;How does it work?&lt;/h3&gt;
&lt;p&gt;Each municipality's official domain is checked via 11 signals from DNS records, SMTP banners, ASN lookups, and a public Microsoft API endpoint, then classified by provider type with confidence scoring.&lt;/p&gt;
&lt;p&gt;Disclaimer: DNS records indicate mail routing and authorized senders, not necessarily where data is stored.&lt;/p&gt;
&lt;/div&gt;

&lt;h3&gt;Open source &amp;amp; open data&lt;/h3&gt;
&lt;p&gt;The code and data are on &lt;a href="https://github.com/davidhuser/mxmap"&gt;GitHub&lt;/a&gt;.&lt;/p&gt;
&lt;p&gt;
      If you have noticed an error, please &lt;a href="https://github.com/davidhuser/mxmap/issues"&gt;submit an issue&lt;/a&gt;.&lt;/p&gt;

&lt;/section&gt;
</ns0:encoded></item><item><title>Show HN: Faceoff – A terminal UI for following NHL games</title><link>https://www.vincentgregoire.com/faceoff/</link><pubDate>Sun, 19 Apr 2026 17:44:44 +0000</pubDate><comments>https://news.ycombinator.com/item?id=47826104</comments><description>&lt;a href="https://news.ycombinator.com/item?id=47826104"&gt;Comments&lt;/a&gt;</description><ns0:encoded xmlns:ns0="http://purl.org/rss/1.0/modules/content/">&lt;div class="md-content" data-md-component="content" morss_own_score="5.643564356435643" morss_score="10.346534653465346"&gt;
&lt;article class="md-content__inner md-typeset" morss_own_score="9.405940594059405" morss_score="43.81770529994176"&gt;
&lt;h1&gt;Faceoff&lt;a href="https://www.vincentgregoire.com/faceoff/#faceoff" title="Permanent link"&gt;¶&lt;/a&gt;&lt;/h1&gt;
&lt;p&gt;
&lt;img src="https://www.vincentgregoire.com/faceoff/assets/faceoff_logo.png"&gt;
&lt;/p&gt;
&lt;p&gt;A terminal user interface (TUI) application for following NHL hockey games in real-time.&lt;/p&gt;
&lt;h2&gt;Features&lt;a href="https://www.vincentgregoire.com/faceoff/#features" title="Permanent link"&gt;¶&lt;/a&gt;&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Live Game Schedule&lt;/strong&gt;: Browse NHL games by date with easy navigation (previous/next day)&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Real-time Updates&lt;/strong&gt;: Auto-refreshing scores for live games&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Game Details&lt;/strong&gt;: View play-by-play, box scores, and scoring summaries for in-progress and completed games&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Pre-Game Preview&lt;/strong&gt;: View matchup data including goalie comparison and skater leaders for upcoming games&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;League Standings&lt;/strong&gt;: View current NHL standings with multiple views (Wild Card, Division, Conference, League)&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Player Stats Leaders&lt;/strong&gt;: View top players in various statistical categories for skaters and goalies&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Team Browser&lt;/strong&gt;: Browse all NHL teams, view rosters, and team schedules&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Player Profiles&lt;/strong&gt;: View detailed player information, career stats, and game logs&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Responsive Layout&lt;/strong&gt;: Game cards and standings automatically arrange based on terminal width&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Local Time Display&lt;/strong&gt;: Game times shown in your local timezone with timezone abbreviation&lt;/li&gt;
&lt;/ul&gt;
&lt;h2&gt;Screenshots&lt;a href="https://www.vincentgregoire.com/faceoff/#screenshots" title="Permanent link"&gt;¶&lt;/a&gt;&lt;/h2&gt;
&lt;p&gt;Game detail view (shown with different terminal color schemes):&lt;/p&gt;
&lt;p&gt;&lt;img src="https://www.vincentgregoire.com/faceoff/assets/screenshots/Faceoff_2026-04-19T12_37_42_686318.svg"&gt;&lt;/p&gt;
&lt;p&gt;&lt;img src="https://www.vincentgregoire.com/faceoff/assets/screenshots/Faceoff_2026-04-19T12_38_12_746997.svg"&gt;&lt;/p&gt;
&lt;p&gt;&lt;img src="https://www.vincentgregoire.com/faceoff/assets/screenshots/Faceoff_2026-04-19T12_38_42_262656.svg"&gt;&lt;/p&gt;
&lt;p&gt;League standings:&lt;/p&gt;
&lt;p&gt;&lt;img src="https://www.vincentgregoire.com/faceoff/assets/screenshots/Faceoff_2026-04-19T12_39_28_765694.svg"&gt;&lt;/p&gt;
&lt;h2&gt;Quick Start&lt;a href="https://www.vincentgregoire.com/faceoff/#quick-start" title="Permanent link"&gt;¶&lt;/a&gt;&lt;/h2&gt;
&lt;h3&gt;Installation&lt;a href="https://www.vincentgregoire.com/faceoff/#installation" title="Permanent link"&gt;¶&lt;/a&gt;&lt;/h3&gt;
&lt;p&gt;The easiest way to run Faceoff is with &lt;code&gt;uvx&lt;/code&gt;:&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;uvx faceoff
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;Or install with pip:&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;pip install faceoff
faceoff
&lt;/code&gt;&lt;/pre&gt;
&lt;h2&gt;Acknowledgments&lt;a href="https://www.vincentgregoire.com/faceoff/#acknowledgments" title="Permanent link"&gt;¶&lt;/a&gt;&lt;/h2&gt;
&lt;p&gt;This project was inspired by &lt;a href="https://github.com/paaatrick/playball"&gt;Playball&lt;/a&gt;, a similar terminal application for following MLB baseball games.&lt;/p&gt;
&lt;h3&gt;Built With&lt;a href="https://www.vincentgregoire.com/faceoff/#built-with" title="Permanent link"&gt;¶&lt;/a&gt;&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;&lt;a href="https://github.com/Textualize/textual"&gt;Textual&lt;/a&gt;&lt;/strong&gt; - The modern TUI framework for Python that powers the user interface&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;&lt;a href="https://github.com/liahimratman/nhl-api-client"&gt;nhl-stats-api-client&lt;/a&gt;&lt;/strong&gt; - Python client for accessing NHL API data&lt;/li&gt;
&lt;/ul&gt;
&lt;h2&gt;Disclaimer&lt;a href="https://www.vincentgregoire.com/faceoff/#disclaimer" title="Permanent link"&gt;¶&lt;/a&gt;&lt;/h2&gt;
&lt;p&gt;This project is not affiliated with, endorsed by, or in any way officially connected with the National Hockey League (NHL), any of its teams, or any of its affiliates. All NHL logos, trademarks, and data are the property of the NHL and its teams.&lt;/p&gt;
&lt;p&gt;This application uses publicly available NHL API data for informational and educational purposes only.&lt;/p&gt;
&lt;/article&gt;
&lt;/div&gt;
</ns0:encoded></item></channel></rss>