# SuperBizAgent MVP 文档

**更新日期**：2026-07-23

本目录保存 MVP 阶段的架构、问题、演示、评测和数据表说明。当前材料按“当前入口”和“历史归档”拆开，避免把早期设计稿当成当前实现。

## 当前入口

| 目录/文档 | 用途 |
|---|---|
| [architecture/README.md](architecture/README.md) | 当前 MVP 架构入口 |
| [architecture/current-mvp-architecture.md](architecture/current-mvp-architecture.md) | 当前可运行系统架构 |
| [architecture/agent-orchestration.md](architecture/agent-orchestration.md) | Agent 编排架构 |
| [architecture/harness-quality-gates.md](architecture/harness-quality-gates.md) | Harness 与质量门禁 |
| [architecture/session-trace-lifecycle.md](architecture/session-trace-lifecycle.md) | 会话与 Trace 生命周期 |
| [issues/README.md](issues/README.md) | MVP issue 索引 |
| [tables/README.md](tables/README.md) | 当前 MySQL 表说明 |
| [demo/README.md](demo/README.md) | Demo 运行和演示材料 |
| [eval/README.md](eval/README.md) | 诊断评测材料 |

当前架构、运行链路和后续规划分别以 `architecture/`、`issues/README.md`、`tables/README.md` 以及 OpenSpec/devflow 的最新记录为准。

## 文档结构

```text
mvp/
  architecture/
    README.md
    current-mvp-architecture.md
    agent-orchestration.md
    harness-quality-gates.md
    session-trace-lifecycle.md
    archive/
      2026-07-05-legacy/
      2026-07-22-legacy/
  issues/
    README.md
    active/
    archived/
    design-notes/
    rag/
  tables/
    README.md
    *表-*.md
    archive/
  demo/
    README.md
    ten-minute-interview-demo.md
    requests/
    scripts/
    output/
  eval/
    README.md
    schema.md
    cases/
    fixtures/
    reports/
  archive/
```

## 归档说明

历史材料按归档批次保存：

- [architecture/archive/2026-07-05-legacy/](architecture/archive/2026-07-05-legacy/)：早期架构设计、实现计划和知识检索方案。
- [architecture/archive/2026-07-22-legacy/](architecture/archive/2026-07-22-legacy/)：单 Diagnosis Agent + Harness 切换前的多角色编排、双入口和旧证据链架构。
- [archive/2026-07-09-doc-cleanup/](archive/2026-07-09-doc-cleanup/)：文档清理时迁移的历史材料。
- [issues/archived/](issues/archived/)：已关闭或已被当前架构替代的 Issue。

归档内容仅用于追溯历史决策，不代表当前 runtime、API、数据模型或验收口径。