AGENTS.md

AGENTS.md — GoCode 项目 AI 入口地图

项目概览

GoCode 是一个桌面应用，帮助用户用 AI 从零构建项目。它本身也是一个可被 AI 维护的项目。

启动流程（每次新会话）

1. 读取本文件
2. 读取 feature_list.json 获取当前功能状态
3. 读取 progress.md 了解进度和阻塞
4. 首次或不确定时运行 .\init.ps1（安装依赖 + 检查 + 测试）。日常只需运行 bun run check 确认项目状态
5. 选择下一个 not-started 的 feature 开始工作

工作规则

• 一次只实现一个 feature
• 开工前把 feature 状态改为 in-progress
• 完成后运行验证命令，通过后状态改为 pass
• 每次 feature 完成后 git commit
• 更新 progress.md

验证命令

bun run check        # TypeScript 类型检查
bun run test         # 运行全部测试
bun run test:agent   # 运行 Agent 真实调用测试（需要 API Key）

文档路由

• 项目卡：PROJECT_BRIEF.md
• 产品文档：docs/PRODUCT.md
• 架构文档：docs/ARCHITECTURE.md
• 设计规格：docs/superpowers/specs/
• 实施计划：docs/superpowers/plans/

完成定义

• 目标行为已实现
• 类型检查通过
• 测试通过
• feature_list.json 已更新
• progress.md 已更新
• git commit 已提交

禁止事项

• 不要同时做多个 feature
• 不要跳过验证标记 pass
• 不要删除 harness 文件
• 不要执行批量删除命令