CodeMap 是一个 AI-Native 优先、人类友好的代码架构治理基础设施。AI/Agent 是主要消费者；人类开发者负责配置、维护与按需阅读输出。
v2.0 已把 CLI 表面升级为 schema 驱动的自描述统一接口：单一 contract schema 同时生成 parser、MCP tool 定义和 shell completion。JSON/NDJSON 是默认输出；--human 或 TTY 自动检测渲染表格/颜色，design validate 负责校验 human-authored design contract，design map 负责把 design contract 映射成 candidate code scope。 命名规范：产品/项目名写 CodeMap；公开 CLI 命令首选写 mycodemap；codemap 只作为兼容别名或内部 MCP tool 名称，不作为新示例首选。
命名边界：Server Layer 是内部架构层，不等于公共 mycodemap server 命令。

🎯 产品定位速查
维度 结论
产品定位 CodeMap 是 AI-Native 优先、人类友好的代码架构治理基础设施
主要消费者 AI/Agent
人类角色 配置、维护、按需阅读输出
CLI 命名 对用户和 agent 写 mycodemap；codemap 仅作为 legacy alias / 内部 tool name
机器输出入口 JSON/NDJSON 默认输出；所有命令无需 --json 即输出结构化结果
人类输出入口 --human 标志强制渲染；TTY 自动检测保留交互体验
命名边界 Server Layer ≠ 公共 mycodemap server 命令
文件发现契约 扫描类命令共享 .gitignore 感知排除模块；无 .gitignore 时回退到默认 exclude