为什么需要 Festival
AI 编程代理已经很会写代码、拆任务、查资料和改文件。真正的问题不是“AI 能不能做”，而是长期工作里上下文很快失控。
当一个功能跨越几天、多个仓库、多次会话时，你会反复遇到这些问题：
- 新会话不知道上一次做到哪里
- 决策散落在聊天记录、笔记和 PR 里
- 计划没有被拆成代理可以安全执行的步骤
- 验证标准不清楚，代码改完之后很难审查
- 换一个工具之后，之前的上下文不能直接继承
Festival 把这些工作状态放回文件系统里。计划、任务、进度和决策都是 Markdown 文件，AI 代理和人都能读，也能提交到 git。
三个核心作用
Context：campaign 工作区保存项目、文档、研究和计划，让代理知道当前工作属于哪个长期目标。
Direction：festival 把目标拆成 phase、sequence 和 task。代理不需要猜下一步，运行 fest next 就能拿到当前任务和必要上下文。
Verification：每个任务都可以写清楚完成标准、测试命令和审查要求。工作完成后，进度和提交都能追踪回计划。
Festival 不是什么
Festival 不是运行时 orchestrator。它不会替你启动模型、分配 token、管理云端 agent 进程。
Festival 是计划和上下文层。你可以继续使用 Claude Code、Codex、Cursor、Aider、OpenCode 或自己的脚本。只要工具能读文件、运行命令，就能使用 Festival。
适合什么场景
- 多天、多步骤的功能开发
- 跨多个仓库的发布或重构
- AI 代理之间的会话交接
- 需要保留决策、计划和验证记录的工作
- 想让 Claude Code、Codex、Cursor 等工具共享同一套项目状态
如果你的问题只是一次性的小修改，Festival 可能太重。但当你已经开始重复解释上下文、丢计划、丢决策时，它会变得有用。