# Agent Ops 文档仓

`agent_ops/` 是 LineUp 项目的文档整理与治理目录。它的目标不是简单收集 Markdown，而是把当前仍有效的项目文档、架构文档、迭代文档、运行记录和历史资料按统一规则沉淀下来，便于后续由 agent 持续维护。

## 当前整理原则

- 目录名和文件名统一使用中文；
- 目录按用途分层，并按阅读/维护顺序增加编号前缀；
- 迁移以“整合”为主，不做原样搬运；
- 每类内容只保留一个权威入口；
- 历史材料保留，但必须和当前有效文档分开。

## 当前目录结构

```text
agent_ops/
├── README.md
├── 00.目录治理/
├── 01.项目总览/
├── 02.架构设计/
├── 03.迭代规划/
├── 04.程序清单/
├── 05.运行运维/
├── 90.历史归档/
└── 设计/                       # 迁移前的旧设计目录，后续分步收口
```

## 各目录职责

### `00.目录治理/`

放文档治理本身需要的资料：

- 目录规划；
- 迁移计划；
- 迁移记录；
- 权威文档清单；
- 命名与维护规范。

### `01.项目总览/`

放项目级入口文档，服务于第一次进入项目的人或 agent：

- 项目总览；
- 当前状态；
- 仓库边界；
- 阶段判断。

### `02.架构设计/`

放仍然有效的设计和架构文档；原 `lineup-app/设计/` 与原 `agent_ops/设计/` 已迁入这里。

### `03.迭代规划/`

放计划、阶段目标、设计评审、技术实施规范和验收评审。后续从 `lineup-app/迭代/` 分步整合。

### `04.程序清单/`

放跨仓程序清单、模块说明和目录职责文档，用作代码地图层。

### `05.运行运维/`

放运行事实、部署说明、联调记录和验证记录。这里承接比“项目状态总览”更细的证据型材料。

### `90.历史归档/`

放已退役、仅用于追溯、或不再作为当前实现依据的历史资料。

## 本轮进度

本轮已完成：

- 建立 `agent_ops` 的中文编号目录规划；
- 开始整合迁移工作区根目录文档；
- 将“项目总览、状态结论、协作边界、跨仓程序清单”沉淀为新的目标文档。

后续两步将按用户要求继续推进：

1. 继续维护 `02.架构设计/`
2. 继续维护 `03.迭代规划/`

## Git 说明

用户计划将 `agent_ops/` 单独初始化为 Git 仓库，并推送到：

`ssh://git@100.121.118.116:2222/lineup/agent_ops.git`

截至 2026-08-07，本目录内尚未检测到独立 Git 仓库元数据，因此本轮先完成目录规划与本地文档整合；待仓库初始化后，后续修改应在 `agent_ops` 仓库内独立提交与推送。