用途：把普通文件夹变成可供 AI 辅助开发的项目工作区。它会从内置模板生成主指令文件，为所选运行时配置本地 MCP 服务器，并安全地初始化 Git。
主要能力：生成 AGENTS.md（Codex）或 CLAUDE.md（Claude Code）；生成 .codex/config.toml、.mcp.json、.claude/settings.local.json；为新仓库创建最小 .gitignore；在缺少 .git 时初始化仓库并尽可能创建首次提交。
使用方式：先运行引导脚本，例如 python3 ./project-agent-bootstrap/scripts/bootstrap_project.py --project-root /absolute/path/to/project --agent codex。--agent 可选值：codex（生成 AGENTS.md 与 .codex/config.toml）、claude（生成 CLAUDE.md、.mcp.json、.claude/settings.local.json）、both（两者都生成）、auto（从现有项目推断，默认 codex）。流程为：确定运行时，运行脚本，检查生成的指令文件，保留合并后的本地配置，然后在已引导的仓库中继续开发。
输出契约：AGENTS.md 或 CLAUDE.md 复制自 references/instruction-template.md；.codex/config.toml 与 .mcp.json 添加项目本地的 playwright 和 shadcn 服务器；.claude/settings.local.json 启用项目 MCP 服务器。
限制与护栏：不硬删除被替换文件，覆盖的指令文件会移入 .ai-bootstrap-trash/；合并而非整体替换已有 .mcp.json、.claude/settings.local.json、.codex/config.toml；保留包版本规则，即安装或更新前须联网核对每个外部包与库的版本；不因代码可编译就宣称 UI 工作完成，UI 项目需 Playwright MCP 验证。其他细节暂未提供。