Agent Team Archetype - AI-Native Project 原型工程

⚠️ 重要提示：这是一个原型工程（Prototype Project），用于展示 AI-native Project 的架构形制，不是用于实际运行的生产项目。

---

🎯 项目定位

核心定位: 这是一个原型工程（Prototype Project），用于展示 AI-native Project 的架构形制。

仓库由两层组成：

• 主项目根目录：方法论知识库 + agent skills，不含任何业务实现。
• examples/backend/：一个自包含、可独立编译的后端工程范例（独立 Go module），完整展示分层架构、DAO 接口、数据模型、配置/部署模板与测试框架。

项目目标:

• ✅ 展示 AI-native 项目的架构模式和最佳实践
• ✅ 提供可复用的项目结构和框架代码（见 examples/backend/）
• ✅ 作为其他项目的参考模板
• ❌ 不是用于实际运行的生产项目
• ❌ 主项目根目录不包含具体的业务逻辑实现

核心价值: 展示 AI-native Project 的架构形制，而非提供可直接运行的代码。

---

📂 项目结构

agent-team-archetype/
├── README.md                    # 本文件（项目概况）
├── GUIDE.md                     # AI-Native 开发完整指南 ⭐
├── AGENTS.md                    # 仓库工作指南（代理协作）
├── CLAUDE.md                    # Claude Code 使用指南
├── CHANGELOG.md                 # 更新日志
├── .gitignore
│
├── .claude/skills/              # Claude Code agent skills
├── .codex/skills/               # Codex agent skills
├── docs/
│   └── guides/                  # AI-Native 开发方法论（guide_book）
│
└── examples/
    └── backend/                 # ⭐ 完整后端工程范例（独立 Go module）
        ├── go.mod               # module example-service
        ├── main.go              # 应用入口（最小可运行骨架）
        ├── Makefile             # 构建工具
        ├── pyproject.toml       # Python 测试依赖
        ├── .gitlab-ci.yml       # 业务 CI
        ├── internal/            # Go 核心代码
        │   ├── config/          # 配置结构定义
        │   ├── dao/             # 数据访问层接口（interfaces.go）
        │   ├── model/           # 数据模型（Pod/GPU/CMDB 业务实体）
        │   ├── types/           # 通用类型定义
        │   ├── handler/         # HTTP 处理器（占位）
        │   ├── logic/           # 业务逻辑（占位）
        │   ├── middleware/      # 中间件（占位）
        │   ├── pkg/             # 工具包（占位）
        │   └── svc/             # 服务层（占位）
        ├── etc/config/          # 运行时配置（*.yaml.template + 范例）
        ├── deploy/              # 部署模板（Docker + K8s Helm）
        ├── tests/               # 测试骨架（api/sit/uat）
        └── docs/                # 业务设计 + scrum 管理文档

---

🚀 快速开始

1. 学习方法论（主项目）

# 阅读 AI-Native 开发完整指南
cat GUIDE.md

# 阅读开发方法论专著
cat docs/guides/ai_native_development_guide_book.md

# 查看 agent skills
ls .claude/skills/

2. 查看后端工程范例

cd examples/backend

# 查看目录结构
tree -L 2 -I 'node_modules|.git'

# 查看 Go 框架代码
ls -la internal/

# 编译范例（独立 module，无需 go.work）
go build ./...

3. 学习架构设计

查看设计文档（位于范例内）：

• examples/backend/docs/design/service_layer_architecture_v4.2.md - 服务层架构
• examples/backend/docs/design/data_layer_design_*.md.template - 数据层设计模板
• examples/backend/docs/design/api_design_v1.3.md - API 设计

理解接口定义：

• examples/backend/internal/dao/interfaces.go - DAO 接口抽象
• examples/backend/internal/model/ - 数据模型
• examples/backend/internal/types/types.go - 通用类型定义

4. 基于范例创建新项目

# 步骤 1: 复制范例作为新项目基础
cp -r examples/backend my-new-project
cd my-new-project

# 步骤 2: 重命名 Go module