Sync: FinClaw Program Controller Handoff

日期：2026-05-09 来源项目 / 材料：FinClaw、Labs-FinTecAI-Gov、/Users/mlabs/Programs/fin-claw 提交人 / 责任人：Curvature Labs ecosystem owner 目标会话：019e09c4-b8fd-73e3-8c09-10c089d157d4 当前状态：Active / compressed entrypoint

0. 当前续接入口

本 handoff 是 Program Controller 的轻量启动入口。当前不要再从历史批次流水恢复工作，优先读取以下压缩 / 正式材料：

packets/sync/finclaw-mvp-engineering-alignment-2026-05-09.md
evaluation/finclaw/case-library.md
projects/finclaw/reference-experience/martinpmm-finclaw-evaluation.md

完整历史已归档到：

packets/sync/archive/finclaw-mvp-engineering-alignment-2026-05-09-full-history.md

当前正式参考体验材料采用稳定文件名，版本和日期记录在文件内容中，不写入文件名。

1. 触发背景

FinClaw 当前同时存在三组输入：

Labs-FinTecAI-Gov 中已完成收束的 FinClaw 战略白皮书、产品定义和 MVP 产品定义；
多个第三方参考 / 竞品项目及分析材料；
已提前启动但尚未与上位文档和参考材料对齐的 FinClaw MVP 工程仓库。

因此需要一个固定的 FinClaw Program Controller 会话承担跨材料、跨工程、跨协作框架的控制台角色。

2. Program Controller 角色边界

FinClaw Program Controller 负责：

维护 FinClaw 当前权威上游输入；
盘点现有工程与上位产品定义之间的偏差；
整理可保留资产、必须调整项和待裁决问题；
将工程对齐工作拆成可交给项目团队、个人域 Agents 或 open-cowork 的执行输入；
将稳定结论回写到 Labs-FinTecAI-Gov 的正式事实源或 packets。

它不负责：

替代 ecosystem owner 做最终产品边界裁决；
替代 open-cowork 做多人多 Agent 任务执行；
替代工程仓库承载实现代码、测试和运行证据；
在 Labs-FinTecAI-Gov 中提前固化具体系统对接设计。

3. 权威上游输入

Program Controller 应优先读取以下文档：

README.md
INDEX.md
CONTEXT-MAP.md
baseline/03-current-baseline.md
registry/project-registry.md
projects/finclaw/strategic-whitepaper.md
projects/finclaw/product-definition.md
projects/finclaw/mvp-product-definition.md
source/project-prealignment/finclaw/product-definition-supplement.md
source/project-prealignment/finclaw/*
references/finclaw/*

其中 projects/finclaw/product-definition.md 是当前项目级统一接入文档，projects/finclaw/mvp-product-definition.md 是第一阶段工程对齐的主要验收基准。

4. 工程仓库事实

当前待对齐工程：

本地路径：/Users/mlabs/Programs/fin-claw
GitHub：https://github.com/Curvature-Lab/fin-claw
当前本地 HEAD：aba0130d7dc79b0cf5e851dd259b1310b2686450
当前分支：main

已观察到的工程结构：

server/：Python 3.11+ 后端，FastAPI + ReAct agent runtime；
server/agent/：runtime.py、llm_client.py、skill_manager.py、tool_registry.py、context_engine.py、session_store.py、models.py；
server/skills/：Markdown skill 定义；
server/tools/：内置工具；
web/：React / Vite 前端；
docs/：已有工程设计和早期 MVP PRD；
docs/FinClaw_MVP_PRD.md：早期团队成员启动工程前形成的 MVP 产品材料；
docs/DETAILED_DESIGN.md 与 docs/design/*：工程设计材料。

已观察到的技术栈：

后端：Python、FastAPI、Pydantic、Anthropic SDK、Gemini SDK、MCP、uv；
前端：React 19、Vite、TypeScript、React Router、Zustand、Tailwind、Vitest、Biome；
测试：server/tests/、web Vitest。

5. 初始对齐任务

Program Controller 的第一批任务不是改代码，而是完成 FinClaw MVP Engineering Alignment：

盘点 /Users/mlabs/Programs/fin-claw 当前工程功能、文档、运行方式和测试状态；
对照 projects/finclaw/mvp-product-definition.md，标记已对齐、部分对齐、偏离和缺失；
对照 references/finclaw/*，标记哪些参考项目已经被当前工程吸收，哪些仍可作为参考或反例；
判断早期 docs/FinClaw_MVP_PRD.md 中哪些内容已被上位产品定义吸收，哪些应被废弃、降级或保留为工程历史背景；
形成工程对齐清单：
- 可保留资产；
- 必须调整项；
- 待裁决问题；
- 适合进入 open-cowork 的后续工作；
- 必须回写到 Labs-FinTecAI-Gov 的事实变化。

6. 当前禁止事项

不直接把第三方参考项目功能搬进工程；
不把早期工程 PRD 反向覆盖上位战略 / 产品 / MVP 定义；
不在 Labs-FinTecAI-Gov 中提前写工程对接细节；
不把 FinClaw Program Controller 变成日常任务看板；
不绕过 projects/finclaw/mvp-product-definition.md 直接定义 MVP 范围。

7. 输出要求

Program Controller 应输出一份工程对齐报告，建议标题：

FinClaw MVP Engineering Alignment

最小内容：

工程仓库画像；
现有工程能力；
与上位 MVP 定义的差异；
与参考项目材料的关系；
可保留资产；
必须调整项；
待裁决问题；
open-cowork 后续输入候选；
需要回写到 Labs-FinTecAI-Gov 的事项。

8. 吸收状态

本 sync 当前作为 Program Controller 会话的启动交接材料。后续若工程对齐报告形成稳定判断，应回写到：

projects/finclaw/mvp-product-definition.md
projects/finclaw/product-definition.md
source/README.md
references/README.md
必要时新增或更新 packets/sync/ / packets/escalation/

0. 当前续接入口​

1. 触发背景​

2. Program Controller 角色边界​

3. 权威上游输入​

4. 工程仓库事实​

5. 初始对齐任务​

6. 当前禁止事项​

7. 输出要求​

8. 吸收状态​