为什么需要 FylloCode

每个 Agent 会话结束后，代码会留下来，但很多关键决策不会自然留下来。

常见问题

三天后不知道这行代码为什么改。
Agent 可能一次修改上百个文件，git blame 只能告诉你谁提交了代码，不能说明当时的任务背景、约束和取舍。

两个月后没人知道方案的设计依据。
一个架构方向被选中后，其他候选方案为什么被放弃，往往消失在当时的聊天窗口里。

每个新会话都要从头建立上下文。
相同的问题、项目边界、历史决策和禁忌操作，需要反复解释给新的 Agent 实例。

全队的 Agent 各跑各的规则。
没有统一的工程规范和跨会话一致性时，团队约定会被个人习惯和一次性 prompt 切碎。

FylloCode 的处理方式

FylloCode 把 Agent 编码任务放进一个可治理的流程：

• 在 Task 阶段把任务收口为统一入口，无论它来自团队成员还是研发系统
• 在 Chat 阶段与 Agent 厘清意图、检索佐证、权衡取舍并共同确认决策
• 在 Proposal 阶段把决策固化成方案依据、设计取舍和任务拆分
• 在 Apply & Archive 阶段按已确认的 tasks 执行，并沉淀变更记录、specs 和 guidelines

这条主线由一条 lineage 串起，固化下来的规范会自动成为下一次任务的起点。

这套流程的目标不是增加仪式感，而是让团队能回答一个工程上很现实的问题：几周或几个月后，我们还能不能解释这次 Agent 变更为什么是这样做的。

适用场景

FylloCode 更适合这些场景：

• 团队已经在使用多个 Coding Agent 或模型
• 项目需要长期维护，历史决策不能只存在于聊天记录里
• 代码库有明确架构边界、IPC、存储格式、测试和发布约束
• 变更需要经过方案评审，而不是直接让 Agent 修改主分支

如果只是一次性的轻量脚本或临时实验，普通 Agent 会话可能已经足够。FylloCode 主要解决的是持续工程协作中的治理和追溯问题。