用途：这是 Bitwarden 软件计划漏斗第三阶段（概念验证，PoC）的深度实操手册，面向 initiative shepherd，用于在真实 Bitwarden 代码库中验证研究阶段给出的推荐方案，并起草 ADR。时间预算 2–4 周、40–80 小时；超过 4 周通常意味着范围或方案有误。
主要能力：PoC 需完成三件事——在真实代码库（非沙箱、非干净仓库）中以生产级质量证明方案可行；暴露评估阶段无法预见的摩擦（如 TypeScript 接口需调整、测试基础设施无法表达新边界、接收团队遥测在新结构下失效）；给接收团队可具体反馈的代码。
使用方式：选择代表性但受控的 PoC 区域（约 1–5 个文件或一个模块），避开最简单与最病态的案例，并与所属团队 tech lead 协调、确定对接人。先构建共享脚手架（中间件、基类、类型定义、共享库），再实现 1–3 个示例（如迁移一个 API 端点、一个 UI 组件或一个服务模块），记录可行之处、遇到的挑战、全面推广所需改动。PR 标题标注 PoC，描述中写明上述三点并链接架构评估。向架构委员会做 15–30 分钟走查，携带 PR、评估摘要、诚实结论与建议方向。若验证通过，按 Bitwarden ADR 模板在集中式 bitwarden/contributing-docs 仓库 docs/architecture/adr/ 下起草 ADR（编号接续最新已接受 ADR，状态 Proposed），并建立文档模式：框架旁 README.md、示例旁文件夹级说明、按技术栈的内联文档、必要时更新 CLAUDE.md。
适用场景：Bitwarden 内部计划推进的 PoC 阶段。限制：架构委员会只提供建议，最终 go/no-go 由工程领导层决定；ADR 是决策产物而非架构计划（后者在 Scoping 阶段）；资料未提供具体收费、平台或效果信息。