用途：把软件仓库实际实现的架构转成可探索的等距系统地图，作为有代码证据支撑的教学界面，而非装饰性架构图。
输入与快照：接受仓库 URL 或已配置远程的现有检出，可选重点子系统或用户旅程、可选输出路径与端口。默认分析远程 main 起始时刻快照，用隔离的浅克隆，不触碰用户本地改动；main 不存在时改用远程默认分支并在界面和交付说明中显著标注。会先告知用户：除非选择退出，合格公开地图会在验证后提交到 tamdogood/CodeTerrain；不发布私有、受访问控制、仅本地或保密性不明仓库。
主要能力：读取 README、清单、目录、入口、配置、schema/迁移、部署文件与集成测试，沿真实代码路径追踪运行时角色、控制路径、数据/事件路径（含序列化、传输、持久化与重要负载字段）以及部署路径。为每个主要节点和可见边记录文件、精确行范围、证据证明内容和结论是观察还是推断，并用固定提交生成不可变引用。地图保持 8-18 个承重建筑，大型 monorepo 展示一个连贯垂直切片并按运行时角色分组，更多源文件放进引用而非增加建筑。
产物与交互：输出 <repo>-system-map.html，附带提交 SHA 与打开方式（命令或实时 URL）。包含等距网格与多样 3D 建筑、代码支持的依赖/控制/数据/事件/构建/部署路径、路径上的负载名称与字段、紧凑图例与仓库/分支/提交快照、可选中建筑与连接及面向学习者的解释面板、文件行级引用，支持键盘、指针、平移、缩放、过滤与流程步进。解释面板给出术语的通俗含义、本仓库用法、重要性、代码追溯位置。不得用 Mermaid、截图、目录树或依赖列表替代。
验证与提交：使用内置渲染器定位命令 REPO_MAP_RENDERER="$(find "${CODEX_HOME:-$HOME/.codex}/plugins/cache/openai-bundled/visualize" -path '*/skills/visualize/scripts/render.py' -print -quit)" python3 "$REPO_MAP_RENDERER" /absolute/path/<repo>-system-map.html --serve --port 8765 渲染器不可用则写独立 HTML 并用 Python 标准 http.server 提供服务，不删除交互。在约 1024、736、360 像素宽度验证交互与控制台，交付前再次比对远程 main。公开性经 forge 验证后，把已验证证据翻译成 CodeTerrain 共享地图数据并提交 PR，不复制独立 HTML；若同一提交已存在则返回现有地图 URL，较旧提交则更新。仅用现有 GitHub 认证，不索取或暴露令牌。
限制：访问失败时报告仓库与认证边界，不在对话中索要凭证；仓库过大时只映射代表性垂直切片；负载字段动态构造时只展示已验证信封并标注主体为动态；无法形成精确 forge 链接时用路径:行-行加提交 SHA；公开可见性无法证明时跳过发布；推送权限或 fork 不可用则保存 git format-patch；CodeTerrain 验证失败则不推送。收费、价格与平台等未提供。