Alfred/AGENTS.md

项目概览

• 本项目为 Bun 全栈应用（Alfred·阿福），Bun 是唯一包管理器和运行时，严禁使用 npm、pnpm、yarn、npx、pnpx
• docs/user/ 记录用户使用方法，docs/development/ 记录开发技术细节
• 使用中文（注释、文档、交流），面向中文开发者
• 本项目无需考虑向前兼容性

文档入口（按顺序阅读）

• 优先阅读 docs/README.md 获取文档路由、归属矩阵和影响分析规则
• 其次阅读 docs/development/README.md 获取完整开发规范、常用命令和质量门禁

全局红线

• 前端禁止导入 src/server/ 的后端运行时实现
• 后端运行时代码禁止直接使用 console.*，通过 Logger 实例输出
• 新增逻辑必须编写完善的测试，不允许跳过任何测试
• 每次代码变更必须执行文档影响分析（详见 docs/README.md）
• 新增代码优先复用已有组件、工具、依赖库，不轻易引入新依赖

Git 规范

• 提交信息中文，格式"类型: 简短描述"，类型：feat/fix/refactor/docs/style/test/chore
• 禁止创建 git 操作 task

工作方式

• 积极使用 subagent 并行独立子任务，节省上下文空间；能并行的步骤明确并行
• subagent 仅用于只读收集和分析，禁止用于文件修改、代码生成、git 操作或依赖安装
• 单个文件或目录只分配给一个 subagent，不重复分配；subagent 输出文件路径、行号和问题摘要，不输出大段源码
• 主 agent 负责最终结论：去重、交叉验证、合并同根因问题
• 优先使用提问工具对用户确认