diff --git a/README.md b/README.md index 50f4c2f..a1bb025 100644 --- a/README.md +++ b/README.md @@ -144,6 +144,13 @@ In the latest weighted review shared with the project, Yao scored strongest in t The overall direction is deliberate: keep the entrypoint light, make the evaluation loop strict, and treat governance as a first-class part of skill quality. +## Why Yao + +- **Lightweight**: the entrypoint stays compact, context budgets are explicit, and extra structure is added only when it pays for itself. +- **Rigorous**: trigger quality is checked with family regressions, blind holdout, adversarial holdout, route confusion, judge-backed blind eval, and promotion gates. +- **Governed**: important skills are treated as maintainable assets with lifecycle state, maturity expectations, ownership, and review cadence. +- **Portable**: source metadata stays neutral while adapters, degradation rules, and packaging contracts preserve reusable semantics across environments. + ## What It Does This project helps you create, refactor, evaluate, and package skills as durable capability bundles rather than one-off prompts. diff --git a/docs/README.fr-FR.md b/docs/README.fr-FR.md index ad7dbb9..13eeb1f 100644 --- a/docs/README.fr-FR.md +++ b/docs/README.fr-FR.md @@ -37,6 +37,13 @@ Dans la dernière revue pondérée partagée pour le projet, Yao se distingue su La direction est volontaire : garder une entrée légère, rendre l'évaluation stricte, et traiter la gouvernance comme une partie de la qualité d'une skill. +## Pourquoi Yao + +- **Léger** : le point d'entrée reste compact, les budgets de contexte sont explicites, et la structure supplémentaire n'est ajoutée que lorsqu'elle apporte une vraie valeur. +- **Rigoureux** : la qualité de déclenchement est vérifiée par family regressions, blind holdout, adversarial holdout, route confusion, judge-backed blind eval et promotion gates. +- **Gouvernable** : les skills importantes sont traitées comme des actifs maintenables avec lifecycle, attentes de maturité, ownership et cadence de revue. +- **Portable** : les métadonnées source restent neutres, tandis que les adaptateurs, règles de dégradation et contrats de packaging préservent une sémantique réutilisable entre environnements. + ## Ce que fait le projet Ce projet permet de créer, refactoriser, évaluer et empaqueter des skills comme des briques de capacité durables plutôt que comme des prompts ponctuels. diff --git a/docs/README.ja-JP.md b/docs/README.ja-JP.md index e6173d1..43fcaf2 100644 --- a/docs/README.ja-JP.md +++ b/docs/README.ja-JP.md @@ -37,6 +37,13 @@ 全体の方向性は明確です。入口は軽く、評価は厳しく、ガバナンスは skill 品質の一部として扱います。 +## なぜ Yao なのか + +- **軽量**: エントリポイントは小さく保たれ、context budget は明示され、追加構造は本当に価値がある場合にだけ導入されます。 +- **厳密**: trigger 品質は family regression、blind holdout、adversarial holdout、route confusion、judge-backed blind eval、promotion gate で検証されます。 +- **ガバナンス可能**: 重要な skill は lifecycle、maturity expectation、owner、review cadence を持つ保守対象の資産として扱われます。 +- **移植可能**: ソースメタデータは中立のまま保たれ、adapter、degradation rule、packaging contract が環境間の再利用意味論を保持します。 + ## 何をするものか このプロジェクトは、skill を単発の prompt ではなく、作成・改善・評価・配布できる持続的な能力パッケージとして扱えるようにします。 diff --git a/docs/README.ru-RU.md b/docs/README.ru-RU.md index 54d6149..b8f407c 100644 --- a/docs/README.ru-RU.md +++ b/docs/README.ru-RU.md @@ -37,6 +37,13 @@ Общий вектор здесь осознанный: легкий вход, строгий evaluation loop и governance как часть качества skill. +## Почему Yao + +- **Легкий**: entrypoint остается компактным, context budgets заданы явно, а дополнительная структура добавляется только тогда, когда она действительно окупается. +- **Строгий**: качество trigger проверяется через family regressions, blind holdout, adversarial holdout, route confusion, judge-backed blind eval и promotion gates. +- **Управляемый**: важные skills рассматриваются как поддерживаемые активы с lifecycle, maturity expectation, owner и review cadence. +- **Портируемый**: source metadata остается нейтральной, а adapters, degradation rules и packaging contracts сохраняют переносимую семантику между средами. + ## Что делает проект Этот проект помогает создавать, перерабатывать, оценивать и упаковывать skills как долговечные capability-пакеты, а не как одноразовые prompts. diff --git a/docs/README.zh-CN.md b/docs/README.zh-CN.md index d7ce173..e9cf465 100644 --- a/docs/README.zh-CN.md +++ b/docs/README.zh-CN.md @@ -37,6 +37,13 @@ 整体方向很明确：入口尽量轻，评测尽量硬，治理成为 skill 质量的一部分。 +## 为什么是 Yao + +- **轻量**：入口保持紧凑，context budget 明确分层，只有在真正值得时才增加额外结构。 +- **严谨**：trigger 质量会经过 family regression、blind holdout、adversarial holdout、route confusion、judge-backed blind eval 和 promotion gate 的联合检查。 +- **可治理**：重要 skill 被当成可维护资产处理，具备 lifecycle、maturity expectation、owner 和 review cadence。 +- **可移植**：源码元数据保持中性，adapter、degradation rule 和 packaging contract 负责保留跨环境可复用语义。 + ## 它能做什么 这个项目帮助你把 skill 从一次性 prompt，升级成可创建、可重构、可评估、可打包的长期能力包。