# 结构与入口（北极星）

## 项目形态
- 单体/多服务/Monorepo：<证据入口链接>

## 入口（可执行证据）
- 本地启动：<脚本/命令入口链接>
- 测试：<脚本/命令入口链接>
- 构建/发布：<CI job/脚本入口链接>

## 代码地图
- 组件地图：../components/index.md
- 业务地图（如有）：../products/index.md
- Ops 入口（如有）：../ops/index.md

## Evidence Gaps（缺口清单）
- 缺口：
  - 期望补齐到的粒度：
  - 候选证据位置：
  - 影响：

memory/tech.md 最小模板

# 技术栈与工程护栏

## 技术栈（稳定选择）
- 语言/框架：
- 数据库/缓存/消息：

## 质量门禁入口（可执行证据）
- lint：
- test：
- 安全扫描：

## NFR 入口
- 性能/可用性/成本/安全：../nfr.md（或外部权威链接）

## Evidence Gaps（缺口清单）
...

memory/product.md 最小模板

# 业务边界（稳定语义）

## In / Out
- In：
- Out：

## 业务地图入口
- ../products/index.md（如有）

## 术语入口
- ./glossary.md

## Evidence Gaps（缺口清单）
...

memory/glossary.md 最小模板

# 术语表（短）

| 术语 | 一句话定义 | 权威出处 |
|---|---|---|
| xxx | ... | <链接到模块页锚点/ADR/代码证据> |

Level-1：索引骨架（地图层）约束

索引硬规则（可检查）

• components/index.md 与 products/index.md 只做导航
• 禁止在索引中出现：
  • 不变量摘要
  • 字段/错误码/详细流程
  • “待补/未发现/TODO/待确认”
• 索引用复选框做进度面板，但不得 作为完成判断依据（完成只看模块页是否达标）

components/index.md 最小模板（含依赖图）

# Components Index（地图层：只导航）

| module | priority | owner | code_entry | api_contract | data_contract | ops_entry | status |
|--------|----------|-------|------------|--------------|---------------|-----------|--------|
| auth | P0 | team-x | `src/auth/` | [api](./auth.md#api-contract) | [data](./auth.md#data-contract) | [ops](../ops/index.md) | - [ ] |

## Dependencies（direct only）

```mermaid
graph LR
  auth -->|API| user
  order -->|Event| billing



> **维护规则**：只画**直接依赖**（一级调用），不画传递依赖；边标注交互方式（API/Event/DB）。

### `products/index.md` 最小模板（可选，但建议）

```markdown
# Products Index（业务地图：只导航）

> 建议收敛到 <= 6 个业务模块；这里不是功能清单。

| product | owner | entry | related_components | status |
|---|---|---|---|---|
| commerce | team-a | ./commerce.md | auth, order | - [ ] |

红旗清单

• Memory 写成“操作手册大全”（项目级必须短）
• 索引里出现“待补/未发现/TODO”（缺口应进模块页或 memory 的 Evidence Gaps）
• 在索引里复制模块细节（双写必漂移）

常见错误

• 先写模块页细节再补索引（会诱发索引双写）
• 把 Products 变成 20+ 个模块的功能目录（地图失效）

Weekly Installs

78

Repository

zixun-github/aisdlc

GitHub Stars

6

First Seen

Feb 27, 2026

Security Audits

Gen Agent Trust HubPassSocketPassSnykPass

Installed on

claude-code77

cursor76

gemini-cli14

github-copilot14

codex14

kimi-cli14