API 与 event contract 的兼容性保障按问答拆开：BFF 对外用 oasdiff 守 OpenAPI spec，内部 BFF 到 MS、MS 到 MS 用 JSON Schema 快照补 japicmp 的盲区，Kafka 事件再加 per-event schemaVersion。

对比 ArgoCD 两种应用组织方式，App-of-Apps 和 ApplicationSet，在三个真实项目里的实践。按场景（单人多集群异构、团队多环境同构、混合需求）给出取舍建议和决策框架。

压测时副本数在 3 和 5 之间反复抖动，查到是 ArgoCD selfHeal 在和 HPA 抢 spec.replicas。记录这次排查的证据链、修复方式，以及引出的几个扩缩容问题。

用 gws 给 Python 脚本提供 Google OAuth 凭据有两处要手动对齐：登录时用 –readonly 或 –scopes 限定授权范围，导出凭据后在 google-auth 里显式传入 scopes，否则会撞 invalid_scope。

一篇问题驱动的笔记：从多 agent 工作流为什么会变乱开始，拆开 always-on 规则和 skill 的边界、Claude Code 的 skill 加载时机、跨 agent 共享源文件的取舍，以及每家 agent 的落地方式。

只共享 contracts 往往还不够。按我目前的理解，更稳妥的做法是把 ArchUnit、japicmp、Deprecation/Sunset 头、ignore-unknown、WireMock 组合起来，Shop Platform 里的落地方式和几份可参考资料放在一起。

Intermittent 413s caused by h2c upgrade + JDK HttpClient + Tomcat maxSavePostSize: root cause, troubleshooting playbook, and a deterministic kind reproduction.

多模块 Maven 单仓微服务平台里，脚手架我选了 Maven Archetype 而不是 Spring Initializr，选型理由、六类 Archetype 的分层逻辑、为什么 Archetype 本身也要有测试、版本怎么维护，都收在这一篇。

基于一次 M5 本地测试，记录 MoE 模型带宽瓶颈，以及通过内存热缓存把长上下文推理提速到约 6.4 倍的过程。

Microsoft markitdown 在 macOS 上装成本地工具，Word、PDF、PPT、Excel 都能转成 Markdown；表格密集的 PDF 它转得不好，这类要换 marker-pdf。