@namewta/speculo 1.0.22 → 2.0.1

package/template/skills/docs-sync/references/readme-writing-guide.md

@@ -1,294 +0,0 @@
-# README 写作指南
-
-README 面向首次接触项目的读者，需要在约 5 秒内回答三个问题：**这是什么、怎么用、值不值得用**。本指南定义 Speculo 项目的通用 README 结构与写作规范，供 `docs-sync` 及其他命令在生成或审计 README 时引用。
-
-> **同步规则参见 [readme-contract.md](./readme-contract.md)。** 本指南定义"写什么内容"（内容规范）；readme-contract.md 定义"何时同步、如何验证"（同步契约）。两者互补。
-
-## 九段式结构
-
-项目简单时合并相邻章节，README 很长时把 API、架构解释和贡献流程移到对应文档。以下九段覆盖从"吸引注意"到"引导参与"的完整认知漏斗。
-
-| # | 段落 | 用途 | 缺失后果 |
-|---|------|------|----------|
-| 1 | **Header** | 项目名 + 一句话定位 + 徽章栏 + 语言切换 | 读者不知道项目是否活跃、能否跨语言阅读 |
-| 2 | **About** | 价值主张 + 内容概览 + 独特卖点 | 读者无法快速判断项目是否解决他的问题 |
-| 3 | **Quick Start** | 前置条件 → 安装命令 → 预期输出 | 读者放弃尝试 |
-| 4 | **Project Structure** | ASCII 目录树 + 命名规范 | 读者不知道从哪里入手改代码 |
-| 5 | **How to Study / Use** | 分步学习或使用方法 | 读者不知道怎么消化内容 |
-| 6 | **Tech Stack** | 组件-包名-用途三列表 | 读者不知道需要什么依赖 |
-| 7 | **Contributing** | Fork → Branch → Convention → Test → PR | 潜在贡献者不知道流程而放弃 |
-| 8 | **License** | 类型 + LICENSE 文件链接 | 读者不确定能否合法使用 |
-| 9 | **Footer** | 社区链接 + 跨语言导航 | 读者不知道怎么联系或获取更多信息 |
-
----
-
-### 1. Header
-
-**应包含：**
-- 项目名居中（`<h1 align="center">Project Name</h1>`）
-- 一句话 tagline —— 说明输入、输出或解决什么问题，删除空泛营销语
-- 徽章栏：License、语言版本、包管理器、Stars、PRs、CI 状态等
-- 语言切换链接：`[中文](./README-ZH.md)` ← → `[English](./README.md)`
-
-**不应包含：**
-- 超过一行的冗长描述（放到 About 段）
-- 失效或状态无价值的徽章
-
-**示例：**
-
-```markdown
-<h1 align="center">My Project</h1>
-<p align="center"><em>A one-line description of what it does.</em></p>
-<p align="center">
-  <a href="./README-ZH.md">中文</a>
-</p>
-<p align="center">
-  <img src="https://img.shields.io/badge/License-MIT-blue.svg" alt="License: MIT">
-  <img src="https://img.shields.io/badge/Python-3.10+-green.svg" alt="Python 3.10+">
-  <img src="https://img.shields.io/github/stars/owner/repo?style=flat" alt="Stars">
-</p>
-```
-
----
-
-### 2. About
-
-**应包含：**
-- 一段清晰的价值主张：这个项目解决什么痛点、为谁解决
-- 内容/功能概览表（若为学习型仓库：模块列表；若为工具型：核心功能）
-- 1-3 个独特卖点（why this project over alternatives）
-
-**不应包含：**
-- 实现细节（放到项目结构或文档链接）
-- 安装步骤（放到 Quick Start）
-- 与其他项目逐行对比（冗长且容易过时）
-
-**示例（学习型仓库）：**
-
-```markdown
-## About
-
-My Project 是一套从零到生产就绪的 XYZ 学习路线，每个模块以"带注释的可运行脚本"而非教程形式呈现 — 代码即教材。
-
-| # | 模块 | 覆盖内容 |
-|---|------|----------|
-| 01 | Getting Started | 环境搭建、Hello World |
-| 02 | Core Concepts | 核心抽象与生命周期 |
-| ... | ... | ... |
-```
-
----
-
-### 3. Quick Start
-
-**应包含：**
-- **前置条件**：运行时版本、系统依赖、必需的 API key 等
-- **一步安装命令**：`npx`、`git clone`、`pip install` 等，可复制粘贴
-- **预期输出**：读者执行后应该看到什么才算成功
-- 预计耗时在 60 秒以内
-
-**不应包含：**
-- 长篇背景解释
-- 多分支安装路径（初学者只需一条"最快路径"）
-
-**示例：**
-
-```markdown
-## Quick Start
-
-**前置条件：** Node.js >= 22、npm >= 10
-
-```bash
-npx my-package init
-```
-
-预期输出：
-
-```
-✔ Project initialized at ./my-project
-✔ 3 files created
-```
-```
-
----
-
-### 4. Project Structure
-
-**应包含：**
-- ASCII 目录树（第一层级，不超过 2 层深度）
-- 关键命名规范说明（文件前缀、目录约定等）
-- 每个顶级目录的一句话用途
-
-**不应包含：**
-- 完整展开的文件树（冗长且随 commit 快速过时）
-- 每个文件的详细说明（放到各自模块的文档中）
-
-**示例：**
-
-```markdown
-## Project Structure
-
-```
-.
-├── src/            # 源代码
-├── tests/          # 测试（文件名 = test_<module>.py）
-├── docs/           # 详细文档
-├── scripts/        # 运维/CI 辅助脚本
-├── pyproject.toml  # 项目元数据与依赖
-└── README.md
-```
-
-命名规范：源文件使用 `snake_case.py`，测试文件使用 `test_` 前缀。
-```
-
----
-
-### 5. How to Study / Use
-
-此节因项目类型而异：
-
-**学习型仓库：** 四步学习法
-```markdown
-## How to Study
-
-1. **选择模块** — 按编号顺序，每模块构建在前一模块之上
-2. **阅读注释** — 每个脚本包含详尽的中文注释，解释每行代码的"为什么"
-3. **运行脚本** — `python main-<NN>-<topic>.py`，观察输出
-4. **动手实验** — 修改参数、打破代码、修复它
-```
-
-**工具/库型仓库：**
-```markdown
-## Usage
-
-```python
-from mylib import Thing
-t = Thing(config)
-result = t.do("input")
-```
-
-详见 [docs/](./docs/)。
-```
-
----
-
-### 6. Tech Stack
-
-**格式：** 组件-包名-用途三列表，按层或类别分组。
-
-**应包含：**
-- 核心运行时与框架
-- 关键依赖（用户需要知道的，不是全部 `node_modules`）
-
-**示例：**
-
-```markdown
-## Tech Stack
-
-| 组件 | 包名 | 用途 |
-|------|------|------|
-| Runtime | Python 3.10+ | 主运行环境 |
-| Package Manager | uv | 依赖管理与虚拟环境 |
-| LLM Framework | langchain | 大语言模型编排 |
-| Vector Store | chromadb | 嵌入式向量存储与检索 |
-```
-
----
-
-### 7. Contributing
-
-**应包含：**
-- Fork → Branch → Convention → Test → PR 简洁流程
-- Commit 规范（如 Conventional Commits）
-- 在哪提 issue、讨论设计
-
-**不应包含：**
-- 完整的 CLA 法律文本（链接到 CONTRIBUTING.md）
-
-**示例：**
-
-```markdown
-## Contributing
-
-1. Fork 本仓库
-2. 从 `main` 分支创建功能分支：`git checkout -b feat/my-feature`
-3. 提交遵循 [Conventional Commits](https://www.conventionalcommits.org/)
-4. 确保现有测试通过并添加新测试
-5. 提交 PR 并描述改动原因
-
-欢迎提 issue 讨论新功能或报告 bug。
-```
-
----
-
-### 8. License
-
-**格式：** 一句话 + LICENSE 文件链接。
-
-```markdown
-## License
-
-MIT © [Author] — 详见 [LICENSE](./LICENSE) 文件。
-```
-
----
-
-### 9. Footer
-
-**应包含：**
-- 社区/联系链接（GitHub Discussions、Discord、Twitter 等）
-- 跨语言 README 跳转链接（与 Header 的徽章栏中的语言切换呼应）
-
-```markdown
----
-
-<p align="center">
-  <a href="./README-ZH.md">中文文档</a>
-  &nbsp;·&nbsp;
-  <a href="https://github.com/owner/repo/discussions">Discussions</a>
-  &nbsp;·&nbsp;
-  <a href="https://github.com/owner/repo/issues">Report Bug</a>
-</p>
-```
-
----
-
-## 双语言原则
-
-遵循 [readme-contract.md](./readme-contract.md) 中的铁律：
-
-- **`README.md` 始终为英文（EN）。** 与之配对的是 `README-ZH.md`，为一对一的中文翻译镜像。
-- 两文件顶部互相提供可点击跳转链接。
-- 结构完全对称，内容一一对应。标题顺序、命令、代码块、URL、表格字段保持对等；代码实体不翻译。
-- `README.md` 内容变更时，`README-ZH.md` 必须在同一次同步中完成对应更新。
-
----
-
-## 与其他资产的关系
-
-| 资产 | 路径 | 关系 |
-|------|------|------|
-| readme-contract.md | `./readme-contract.md` | 同步规则与验证契约 —— 定义**何时更新**、触发条件、多语言铁律 |
-| document-lifecycle-contract.md | `./document-lifecycle-contract.md` | 文档生命周期 —— 定义**如何决定** add/update/delete/merge |
-| docs-sync SKILL.md | `../SKILL.md` | 编排 skill —— 调用本指南与 readme-contract.md 协同完成 README 审计 |
-| 项目文档创建与维护规范 | `temp/项目文档创建与维护规范.md` | 背景参考 —— 综合 50+ 来源的文档规范研究（非运行时依赖） |
-
----
-
-## 验证清单
-
-生成或审计 README 时逐项检查：
-
-- [ ] Header 有项目名、tagline、徽章栏（至少 License + 语言版本）、语言切换链接
-- [ ] About 在 3 秒内回答"这个项目是做什么的"
-- [ ] Quick Start 可在 60 秒内完成并看到预期输出
-- [ ] 安装命令可复制粘贴执行
-- [ ] Project Structure 树与实际目录布局一致
-- [ ] Tech Stack 表与 `package.json` / `pyproject.toml` 等 manifest 文件中的核心依赖一致
-- [ ] Contributing 有可执行步骤
-- [ ] License 类型与实际 LICENSE 文件一致
-- [ ] Footer 有语言切换和社区链接
-- [ ] 无过期命令、路径、参数、徽章、链接
-- [ ] `README-ZH.md` 与 `README.md` 同步更新
-
-逐段删除测试：删掉后不影响采用决策或正确使用的内容应压缩、下沉或删除。

package/template/skills/docs-sync/references/workflow-scope-contract.md

@@ -1,52 +0,0 @@
-# Workflow 范围契约
-
-docs-sync 必须遵循每个 workflow 的 `INDEX.md`。`docs-sync.json` 是 command 拥有的标准延迟 sidecar，不属于 workflow `_state` 固定骨架。
-
-模式边界：audit 只报告候选；update 只使用本次明确批准的目标且不写 sidecar；以下所有 sidecar 创建、迁移和确认持久化仅用于 commit。
-
-## 发现
-
-1. 从 `<Path>{roots.workflows}/{workflow}/INDEX.md</Path>` 发现已安装 workflow。
-2. 每个包必须有匹配的 `<Path>{roots.state}/{workflow}/</Path>` 状态根；包或状态根单边缺失时阻塞，不猜测归属。
-3. 读取 `INDEX.md` 的发现声明；仅需解析合同或写入 owner 时，再按该入口显式指向的 README/contract 读取对应部分，不假设每个 INDEX 都包含运行合同。
-4. 状态根存在但没有已安装 package 时只报告 orphan，不创建 sidecar。
-
-## Sidecar v1
-
-每个已安装 workflow 首次获准的 commit 同步才创建：
-
-```json
-{
-  "schema_version": 1,
-  "workflow": "example",
-  "manifest_path": "<Path>{roots.state}/example/docs-sync.json</Path>",
-  "project_targets": [],
-  "state_targets": [],
-  "scope_revision": 1,
-  "scope_confirmed_at": "ISO-8601"
-}
-```
-
-目标使用 `{ "path": "...", "kind": "file | directory" }`：
-
-- `project_targets` 使用项目相对路径，记录该 workflow 负责维护的项目文档。
-- `state_targets` 使用 workflow 状态根相对路径，只能位于 `consumers` 包含 `docs-sync` 的已声明 store。
-- Directory 目标递归覆盖其中已跟踪的 Markdown、MDX、reStructuredText 和 AsciiDoc；其他格式必须作为 file 明确列出。
-- 禁止绝对路径、反斜杠、`..`、项目根目录、无界 glob、`.git`、固定 `status.json/changes/archive` 和 sidecar 自身。
-
-## 首次确认与修订
-
-1. Bootstrap 同时展示全局候选，以及每个 workflow 的 project/state 候选、来源和风险。
-2. 用户一次确认后写入全局 state 与全部 sidecar；没有候选的 workflow 也写空清单。
-3. 一个目标只能归属全局或一个 workflow；重叠、父子目录交叉或同一路径多 owner 必须先消歧。
-4. 后续新增、扩大、移除或转移目标必须再次展示完整新范围；确认后增加 `scope_revision` 并更新时间。
-5. 首次确认只授予范围内常规创建和改写，不授权整文件/目录删除或受保护知识写入。
-
-## Archive 与知识
-
-- 固定 archive 始终可作为只读证据；优先读取本次区间新增或变更、且与受影响模块或术语相关的高信号产物。
-- 归档中的稳定决策、术语、经验和文档漂移信号只提炼结论并保留来源路径，不复制大段正文。
-- `existing-only` store 永远只读。RULES/policy、ADR、CONTEXT、语义冲突和任何知识文件删除均进入 `propose-only`，按目标 workflow 规则取得逐次确认。
-- 不跨 workflow 搬运知识；共享结论必须先确认唯一归属。
-
-完成标准：commit 模式所有已安装 workflow 都有有效 sidecar；audit/update 不产生 sidecar；每个有效目标都有唯一 owner、声明边界和确认记录；所有受保护动作均未越权。

package/template/skills/engineering-standards-builder/SKILL.md

@@ -1,161 +0,0 @@
----
-name: engineering-standards-builder
-description: Generate or refresh project-specific engineering skills after the user explicitly invokes the builder.
-disable-model-invocation: true
-metadata: {"speculo-invocation": "user-only"}
----
-
-# Engineering Standards Builder
-
-本 Skill 只在用户明确调用时运行。它不会在新项目中自动启动，也不把 Builder 自带的通用建议直接复制成项目规范。
-
-目标是先理解当前项目真实的代码、目录、配置、测试、CI 与模板，再生成一组可长期复用的项目专属 Skill：一个稳定的工程规范路由入口，以及零个或多个有独立触发价值的领域 Skill。
-
-```text
-项目事实 + 用户指定的重点范围 + 已确认目标
-  -> 证据审计与冲突收敛
-  -> 最小充分 Skill Set
-  -> .agents/skills/
-```
-
-## 产物与所有权
-
-始终生成根路由：
-
-```text
-.agents/skills/
-├── engineering-standards/
-│   ├── SKILL.md
-│   ├── generated-skill-set.json
-│   └── references/project/
-│       ├── 00-project-profile.md
-│       ├── 01-module-map.md
-│       ├── 02-decisions-and-exceptions.md
-│       ├── 03-skill-map.md
-│       ├── 04-source-and-template-map.md
-│       └── review-checklist.md
-└── <optional-domain-skill>/
-    ├── SKILL.md
-    └── references/...
-```
-
-`engineering-standards` 是规范权威与路由器；领域 Skill 负责可独立触发的实现导航，不重复定义冲突规则。`generated-skill-set.json` 只登记 Builder 拥有的 `.agents/skills/*` 路径。刷新时不得改动或删除清单之外的 Skill。
-
-## 最小原则
-
-- 不按语言、目录或 Agent 数量机械拆 Skill。
-- 能由根路由和少量 references 清楚表达时，不新增领域 Skill。
-- 没有项目证据的规则不生成；Builder references 只提供审计维度与 fallback。
-- 不复制项目源码、FM 模板或脚手架正文；引用其真实路径并说明适用条件、集成步骤和验证方式。
-- 不新增配置文件、参数、时间戳、hash 或模型元数据来制造形式化负担。
-- 扫描深度、文件数和字节限制只是脚本内部资源保护，不是用户需要决策的项目规范。
-
-## 执行流程
-
-### 1. 确定项目根与学习范围
-
-从用户当前工作目录、Git/Workspace 边界和用户指定的代码或目录确定真实项目根。记录需要重点学习的模块、代码、目录、模板或脚手架；未指定时覆盖所有可编辑模块。
-
-读取现有 `AGENTS.md`、`CLAUDE.md`、贡献文档、架构文档和 `.agents/skills/`，但将它们视为待验证证据。识别 generated、vendor、build、cache、fixture 与冻结目录。发现已有 `generated-skill-set.json` 时进入 refresh；只有 legacy `engineering-standards` 时，在计划中声明接管该根 Skill，其他现有 Skill 一律视为非 Builder 所有。
-
-冲突优先级见 [治理与证据优先级](references/rules/00-governance-and-precedence.md)，路径和 scope 见 [证据、拓扑与作用域](references/rules/02-evidence-topology-and-scope.md)。本阶段只读。
-
-**完成标准**：项目根、重点范围、排除范围、现有规范和 Builder 写入边界明确。
-
-### 2. 建立确定性事实基线
-
-运行扫描器并捕获 stdout；默认不在项目中持久化 inventory：
-
-```bash
-node <skill-root>/scripts/discover-project.mjs --root <project-root> --pretty
-```
-
-扫描合同见 [项目发现合同](references/rules/01-project-discovery.md)。扫描器只提供拓扑基线，不能替代源码审计。继续读取真实 manifest/build 配置、CI 命令、公共入口、代表性实现、测试、消费者与项目模板。
-
-**完成标准**：每个可编辑模块有路径、技术栈、入口、质量门禁和证据；扫描限制、冲突与未知项已记录。
-
-存在可机械验证的边界/约束缺口时，读取 [工程约束](references/rules/09-mechanical-guardrails.md)，决定是否提出接入与验证方案。
-
-### 3. 用 Agent Team 分域取证
-
-当运行环境支持 Agent Team 且存在两个以上可独立审计的证据域时，默认由 leader 并行派发只读 scout。证据域按项目真实边界划分，例如架构与公共 API、后端、前端、公共复用、测试与 CI、FM/脚手架；不得套用固定角色表。
-
-leader 是唯一写入者。每个 scout 必须返回同一份精简证据合同：
-
-```text
-Scope
-Observed capability
-Canonical source paths
-Mature implementations
-Template paths
-Consumers and tests
-Applicable conditions
-Legacy/counterexamples
-Conflicts/unknowns
-Recommended skill boundary
-```
-
-leader 必须复读高影响路径，检查跨域冲突，并把同一事实的重复报告合并。Agent Team 不可用或任务不可合理拆分时，leader 按相同合同顺序审计；结果标准不变。
-
-**完成标准**：重要规范均有真实路径、消费者或测试支撑；反例、旧实现和未知项没有被“多数模式”掩盖。
-
-### 4. 收敛规范与 Skill 边界
-
-先识别项目已经声明的 canonical 模板或代码样板，例如 `docs/fm/**`、scaffold、generator assets。模板与成熟代码冲突时，判断它是目标模板、过期模板还是仅负责骨架，并记录 current、target 与 migration；不得静默任选一方。
-
-只有同时满足以下条件才创建领域 Skill：
-
-1. 有可独立描述的触发场景；
-2. 会在多次开发中复用；
-3. 有充分的项目源码、模板、测试或配置证据；
-4. 与根路由或其他领域 Skill 边界清晰；
-5. 独立后能明显减少无关上下文。
-
-否则内容留在 `engineering-standards`。领域 Skill 名称来自项目语义，不使用固定列表或固定数量。高影响未知项按 [决策收敛合同](references/rules/03-interview-and-decisions.md) 询问；用户已授权直接生成时，将无法安全推断的事项记为 `pending-decision`。
-
-只读取与项目事实匹配的 [通用规则索引](references/rules/README.md)、[TypeScript/JavaScript](references/typescript/README.md)、[Java](references/java/README.md)、[Go](references/go/README.md) 或 [Rust](references/rust/README.md) references。内置语言包和 [未内置语言 fallback](references/rules/16-language-adapter-contract.md) 是检查清单，不是高于项目代码的规范来源。
-
-**完成标准**：每个生成 Skill 都有独立价值和证据边界；没有为了覆盖目录或技术栈而过度拆分。
-
-### 5. 计划、生成与刷新
-
-先展示精简计划：模块与证据摘要、Skill Map、每个 Skill 的来源路径、保留/更新/新增/删除项、冲突决策和验证命令。用户已在当前请求中授权实施时，展示后直接执行。
-
-按 [Skill Set 生成合同](references/rules/14-generation-contract.md) 和 [模板索引](templates/README.md) 生成。所有项目引用使用项目根相对路径，并说明：何时读取、它负责什么、输出位置、需要哪些手工集成、运行什么验证。
-
-先准备完整候选内容并校验，再替换 Builder 拥有的文件。刷新规则：
-
-- 只更新或删除旧 `generated-skill-set.json` 登记的路径；
-- 名称与未登记 Skill 冲突时停止覆盖并重新命名或询问；
-- 保留仍有效的用户决策、例外和项目特有知识；
-- 删除或重命名必须在计划中显式列出；
-- 候选验证失败时保留旧 Skill Set；发布后验证失败时恢复旧内容；
-- 相同项目事实与决策重复运行应无无意义 diff。
-
-**完成标准**：根路由、领域 Skill、项目引用与所有权清单一致，清单外 Skill 未发生变化。
-
-### 6. 验证与报告
-
-运行：
-
-```bash
-node <skill-root>/scripts/validate-generated-skill.mjs --root <project-root> --strict
-```
-
-再按 [验证合同](references/rules/15-validation-contract.md) 执行项目已存在且本次允许的质量门禁。不得通过删除测试、放宽编译配置或扩大例外获取通过。
-
-最终报告生成/更新/保留/删除的 Skill，关键证据与模板路径，运行命令及退出码，未验证项、待确认决策和临时例外。
-
-**完成标准**：所有权、frontmatter、Skill 路由、项目内引用、选择性适配和规则字段通过；项目门禁通过或留下可复现阻塞证据。
-
-## Builder 自校验
-
-维护本 Skill 时读取 [fixture 合同](examples/README.md)，并运行：
-
-```bash
-node scripts/sync-manifest.mjs --root . --check
-node scripts/validate-builder.mjs --root .
-node scripts/self-test.mjs --root .
-```
-
-这些脚本无第三方依赖、接受显式根目录、拒绝路径越界，并提供 `--help`。

package/template/skills/engineering-standards-builder/manifest.txt

@@ -1,118 +0,0 @@
-agents/openai.yaml
-examples/fallback/kotlin-gradle/build.gradle.kts
-examples/fallback/kotlin-gradle/expected.json
-examples/fallback/kotlin-gradle/src/main/kotlin/example/App.kt
-examples/go/service/.golangci.yml
-examples/go/service/cmd/api/main.go
-examples/go/service/expected.json
-examples/go/service/go.mod
-examples/go/service/internal/service/service_test.go
-examples/go/service/internal/service/service.go
-examples/java/spring-boot-maven/expected.json
-examples/java/spring-boot-maven/pom.xml
-examples/java/spring-boot-maven/src/main/java/dev/speculo/orders/OrdersApplication.java
-examples/java/spring-boot-maven/src/test/java/dev/speculo/orders/OrdersApplicationTest.java
-examples/polyglot/monorepo/.github/workflows/ci.yml
-examples/polyglot/monorepo/apps/web/package.json
-examples/polyglot/monorepo/apps/web/src/App.vue
-examples/polyglot/monorepo/apps/web/tsconfig.json
-examples/polyglot/monorepo/expected.json
-examples/polyglot/monorepo/package.json
-examples/polyglot/monorepo/pnpm-workspace.yaml
-examples/polyglot/monorepo/services/orders/pom.xml
-examples/polyglot/monorepo/services/orders/src/main/java/dev/speculo/orders/OrdersApplication.java
-examples/polyglot/monorepo/services/worker/go.mod
-examples/polyglot/monorepo/services/worker/main.go
-examples/README.md
-examples/rust/workspace/Cargo.toml
-examples/rust/workspace/crates/cli/Cargo.toml
-examples/rust/workspace/crates/cli/src/main.rs
-examples/rust/workspace/crates/core/Cargo.toml
-examples/rust/workspace/crates/core/src/lib.rs
-examples/rust/workspace/expected.json
-examples/rust/workspace/rust-toolchain.toml
-examples/typescript/react-vite/expected.json
-examples/typescript/react-vite/package.json
-examples/typescript/react-vite/src/App.test.tsx
-examples/typescript/react-vite/src/App.tsx
-examples/typescript/react-vite/src/main.tsx
-examples/typescript/react-vite/tsconfig.json
-examples/typescript/vue-vite/expected.json
-examples/typescript/vue-vite/package.json
-examples/typescript/vue-vite/src/App.test.ts
-examples/typescript/vue-vite/src/App.vue
-examples/typescript/vue-vite/src/main.ts
-examples/typescript/vue-vite/tsconfig.json
-examples/typescript/vue-vite/vite.config.ts
-README.md
-references/go/00-detection-and-scope.md
-references/go/01-language-and-idioms.md
-references/go/02-modules-packages-and-layout.md
-references/go/03-errors-context-and-concurrency.md
-references/go/04-testing-tooling-quality-gates.md
-references/go/README.md
-references/java/00-detection-and-scope.md
-references/java/01-language-packages-and-api.md
-references/java/02-build-modules-and-dependencies.md
-references/java/03-errors-nullability-resources-concurrency.md
-references/java/04-testing-tooling-quality-gates.md
-references/java/frameworks/spring-boot.md
-references/java/README.md
-references/rules/00-governance-and-precedence.md
-references/rules/01-project-discovery.md
-references/rules/02-evidence-topology-and-scope.md
-references/rules/03-interview-and-decisions.md
-references/rules/04-architecture-and-dependency-boundaries.md
-references/rules/05-files-directories-and-naming.md
-references/rules/06-apis-errors-resources-and-concurrency.md
-references/rules/07-documentation-and-comments.md
-references/rules/08-testing-strategy.md
-references/rules/09-mechanical-guardrails.md
-references/rules/09-security-configuration-and-data.md
-references/rules/10-performance-observability-and-i18n.md
-references/rules/11-tooling-quality-gates-and-ci.md
-references/rules/12-git-review-and-delivery.md
-references/rules/13-adoption-exceptions-and-ratchets.md
-references/rules/14-generation-contract.md
-references/rules/15-validation-contract.md
-references/rules/16-language-adapter-contract.md
-references/rules/README.md
-references/rust/00-detection-and-scope.md
-references/rust/01-language-api-and-safety.md
-references/rust/02-crates-workspaces-and-layout.md
-references/rust/03-errors-ownership-and-concurrency.md
-references/rust/04-testing-tooling-quality-gates.md
-references/rust/README.md
-references/typescript/00-detection-and-scope.md
-references/typescript/01-language-and-type-system.md
-references/typescript/02-modules-packages-and-runtime-boundaries.md
-references/typescript/03-functions-async-errors-resources.md
-references/typescript/04-testing-tooling-quality-gates.md
-references/typescript/app-types/cli.md
-references/typescript/app-types/library.md
-references/typescript/frameworks/react.md
-references/typescript/frameworks/vue.md
-references/typescript/README.md
-references/typescript/runtimes/browser.md
-references/typescript/runtimes/electron.md
-references/typescript/runtimes/node.md
-scripts/discover-project.mjs
-scripts/self-test.mjs
-scripts/sync-manifest.mjs
-scripts/validate-builder.mjs
-scripts/validate-generated-skill.mjs
-SKILL.md
-templates/compatibility/agents-typescript--standards.md
-templates/compatibility/agents-typescript-standards.md
-templates/compatibility/claude-engineering-standards.md
-templates/compatibility/claude-typescript-standards.md
-templates/domain-skill/SKILL.md.template
-templates/project-skill/generated-skill-set.json.template
-templates/project-skill/references/project/00-project-profile.md.template
-templates/project-skill/references/project/01-module-map.md.template
-templates/project-skill/references/project/02-decisions-and-exceptions.md.template
-templates/project-skill/references/project/03-skill-map.md.template
-templates/project-skill/references/project/04-source-and-template-map.md.template
-templates/project-skill/references/project/review-checklist.md.template
-templates/project-skill/SKILL.md.template
-templates/README.md