Product Documentation Standard (full-stack-doc v3.0)

Enforces a fixed directory-and-naming convention for product documentation, aligned with the PartMe / Octo series. Ready-to-copy Markdown templates live under

templates/

references/structure.md

1. When to Use

• Creating or initializing a product documentation repository
• Scaffolding doc trees for Octo* or PartMe projects
• Auditing or aligning existing repos against the PartMe doc standard
• Generating / renaming docs to match the naming convention
• Aligning

  partme-docs/

  content with the template structure
• Writing or expanding any of the 10 root-level planning documents

2. Placeholders

{Name}

OctoEcom

OpenMem

{Name-Open}

OpenEcom

OpenMem

{V}

V1

V2

{模块简称}

登录页

设备中心

{YYYY-MM-DD}

2026-03-27

{姓名}

张三

{组织}

PartMe

Replace placeholders in both filenames and content. Root keeps one

6、

6、详细功能清单

10、功能菜单与版本规划

3. Document Architecture

3.1 Four-Layer Structure

{产品名}/
├── 1、{Name}-命名与品牌说明.md          ─┐
├── 2、{Name}-术语表与词汇表.md          │
├── 3、{Name}-市场与商业分析.md          │
├── 4、{Name}-技术与可行性分析.md        │ Root (10) — 产品级，与版本无关
├── 5、{Name}-技术方案与路线.md          │
├── 6、{Name}-产品与版本规划.md          │
├── 7、{Name}-领域模型设计.md            │
├── 8、{Name}-系统架构设计.md            │
├── 9、{Name}-视觉与交互DNA规范.md       │
├── 10、{Name}-功能菜单与版本规划.md      ─┘
│
├── V1/                                   ─┐
│   ├── 1、{Name}-需求调研文档-V1.md      │
│   ├── 2、{Name}-需求分析文档-V1.md      │
│   ├── 3、{Name}-系统架构设计-V1.md      │ Version (7) — 版本级实施文档
│   ├── 4、{Name}-功能与界面规划-V1.md    │
│   ├── 5、{Name}-PRD文档-V1.md           │
│   ├── 6、{Name}-功能菜单与版本规划-V1.md│
│   ├── 7、{Name}-UI设计说明-V1.md        │
│   │                                     ─┘
│   ├── 1、{模块A}/                       ─┐
│   │   ├── {Name}-{模块A}-PRD-V1.md      │ Module (3) — 可选，按模块
│   │   ├── {Name}-{模块A}-Stitch设计提示词.md │
│   │   └── {Name}-{模块A}-UI设计说明-V1.md    ─┘
│   └── ...
│
├── 其他/                                 ─┐
│   ├── 1、技术细分模板.md                │
│   ├── 2、功能提测模板.md                │ Delivery (5) — 可选，研发交付
│   ├── 3、测试结果模板.md                │
│   ├── 4、上线通知模板.md                │
│   └── 5、项目运维模板.md                ─┘
│
├── 技术调研/                             ── 技术调研、协议分析（版本无关）
└── assets/                               ── 图片、附件等

3.2 Scope Summary

templates/root/

{序号}、{Name}-{文档名}.md

{V}/

templates/version/

{序号}、{Name}-{文档名}-{V}.md

templates/module/

{Name}-{模块简称}-{类型}-{V}.md

templates/delivery/

3.3 Root 10 Documents — Authoring Chain

文档间存在严格的上下游依赖关系，编写时应按顺序递进：

flowchart LR
    D1["1、命名与品牌"] --> D2["2、术语表"]
    D2 --> D3["3、市场分析"]
    D3 --> D4["4、可行性分析"]
    D4 --> D5["5、技术方案"]
    D5 --> D6["6、版本规划"]
    D6 --> D7["7、领域模型"]
    D7 --> D8["8、系统架构"]
    D8 --> D9["9、视觉DNA"]
    D6 --> D10["10、功能菜单"]
    D9 --> D10

graph LR

quadrantChart

funnel

flowchart

sequenceDiagram

flowchart

gantt

graph

timeline

classDiagram

graph TB

flowchart

sequenceDiagram

flowchart

mindmap

pie

flowchart

4. Scaffolding Workflow

Step 1 — Root Docs

Copy all 10 files from

templates/root/

{Name}

# Example: OctoEcom
for f in templates/root/*.md; do
  name=$(basename "$f" | sed 's/{Name}/OctoEcom/g')
  cp "$f" "partme-docs/18、OctoEcom/$name"
done

Step 2 — Version Docs

Create

{V}/

V1/

templates/version/

{Name}

{V}

Step 3 — Module Docs (optional)

For each functional module, create

{V}/{序号}、{模块名}/

templates/module/

{Name}

{模块简称}

{V}

Example (OctoEcom V1 商品采集):

V1/1、商品采集/
├── OctoEcom-商品采集-PRD-V1.md
├── OctoEcom-商品采集-Stitch设计提示词.md
└── OctoEcom-商品采集-UI设计说明-V1.md

Step 4 — Delivery Docs (optional)

Copy

templates/delivery/

其他/

{Name}

Step 5 — Special Directories

Create

技术调研/

其他/

demo/

assets/

.stitch/

Step 6 — Validate

Run the validation checklist (Section 7).

5. Quality Standards

5.1 Content Depth Benchmarks

Based on OctoEcom and OpenEcom production documents:

5.2 Universal Document Structure

每份 root 文档 必须 包含以下标准结构：

文档头部:

# {Name} 文档标题

> **文档说明**：一句话说明文档用途与范围。
>
> **版本**：V1.0.0
> **最后更新**：{YYYY-MM-DD}

文档尾部:

---

**文档版本**：V1.0.0
**创建日期**：{YYYY-MM-DD}
**最后更新**：{YYYY-MM-DD}
**文档状态**：✅ 待评审

5.3 Formatting Conventions

## N.

### N.M

:---

typescript

go

bash

yaml

sql

OpenAI 模型

5.4 Cross-Reference Rules

• Doc 3 关联文档必须链接 Doc 1（品牌边界）和 Doc 5（技术可行性）
• Doc 5 Gantt 日期必须与 Doc 6 版本里程碑、Doc 10 发布节奏一致
• Doc 7 聚合名称必须在 Doc 2 术语表中有定义
• Doc 8 分层名称必须与 Doc 5 技术选型对应
• Doc 10 功能列表的版本标注必须与 Doc 6 版本矩阵一致

6. Gotchas

• Sequence numbers

  1–7

  in version folders are reserved for the 7 standard docs. Non-standard docs must use

  8+

  or go into

  其他/

  .
• Root has one file numbered

  6、

  (产品与版本规划). Detailed feature lists are embedded in

  10、功能菜单与版本规划

  .
• Don't reorganize special directories (

  demo/

  ,

  assets/

  ,

  .stitch/

  ,

  stitch_*

  ,

  实施指南/

  ) unless the user explicitly requests it.
• Delivery templates are optional and do not occupy root-level standard sequence numbers.
• When a product has open-source + commercial dual-track (e.g., OpenEcom/OctoEcom), each track gets its own full 10-doc set with cross-references.

7. Validation Checklist

Doc Validation:
- [ ] Root contains exactly 10 standard files (1–10)
- [ ] Each file starts with H1 + blockquote doc description
- [ ] Each file ends with version/date/status footer
- [ ] ## section numbering is sequential (no gaps, no duplicates)
- [ ] ### sub-sections use parent number prefix (e.g., ## 3 → ### 3.1)
- [ ] Mermaid diagrams render without syntax errors
- [ ] Cross-document references resolve to existing files
- [ ] Timeline dates are consistent across Doc 3, 5, 6, 10
- [ ] Terminology matches Doc 2 definitions
- [ ] Version folder contains exactly 7 standard files with {V} suffix
- [ ] Module folders have PRD / Stitch / UI triplet (if applicable)
- [ ] 技术调研/ and 其他/ do not contain root-level standard docs
- [ ] No sequence numbers 1–7 used for non-standard docs in version folders

8. Template Inventory

templates/root/1、命名与品牌说明.md

templates/root/2、术语表与词汇表.md

templates/root/3、市场与商业分析.md

templates/root/4、技术与可行性分析.md

templates/root/5、技术方案与路线.md

templates/root/6、产品与版本规划.md

templates/root/7、领域模型设计.md

templates/root/8、系统架构设计.md

templates/root/9、视觉与交互DNA规范.md

templates/root/10、功能菜单与版本规划.md

9. Related Skills

• documentation-builder

  : General doc writing and formatting conventions

• api-doc-generator

  : OpenAPI and API documentation generation