mino-drive-inspired-design-skills

本リポジトリは、ミノ駆動氏の公開資料を基に、設計判断の原則をAI Skillとして再構成する非公式プロジェクトです。ミノ駆動氏および所属組織による監修・承認・推奨を受けたものではありません。

目指すのは人物の口調や結論の模倣ではありません。問題、目的、文脈、要件、契約、モデル、品質、公開境界を確認し、根拠のある判断と検証可能な成果物を繰り返し作れるようにすることです。公開資料から直接抽出した原則、反復可能なSkillにするためsuiteが追加したschema・gate・workflow、versioningやvalidator等のrepository policyは区別して記載します。

現在の状態

Status: Experimental / Preview
Suite version: 0.9.0
Structural validation: fail on the native macOS fixture runner; pass on executed Linux and PowerShell-over-WSL layers
macOS structural support: implemented; native macOS /bin/bash executed / fail (run 29397674053, exit 2)
Targeted behavioral evidence: not executed
Behavioral release: not ready

ここでいうbehavioral release（行動再現性を確認した安定版判定）は、権限を持つevaluation ownerがfrozenにしたversioned caseと隔離oracleをfresh contextで繰り返し実行し、代表case・negative case・回帰・required platformのRelease gateを満たした状態です。Experimental / Previewとして配布可能であることと、stable releaseとして承認済みであることを分けます。権限を持つmaintainerが全Evidenceを確認するまでstable releaseとは扱いません。

プロダクト価値（利用者・事業が得る成果）と品質portfolio（優先する品質、制約、意図的に最適化しない品質の組合せ）の最終判断も、AIではなく権限を持つ人間が所有します。

native macOS Evidenceは、head e47aaafb74a27cf2cc7d4bc9c64f74d1933f10dbのworkflow run 29397674053、job Native macOS /bin/bash（job ID 87294760529）で取得済みです。環境はmacOS 15.7.7、image macos-15-arm64 version 20260706.0213.1、RUNNER_ARCH=ARM64でした。validate-suite.shはpassしましたが、fixture runnerはsolver-nested-metadataのportable rewriteで失敗し、jobはexit 2でした。

macOSはBash構造validator、fixture runner、text-format検査を対応範囲に含めます。共用scriptは標準/bin/bash 3.2で実行できるsubsetへ制限しています。上記failureを修正したheadでnative macOS jobがgreenになるまで、platform parityやreleaseをpassにしません。

クイックスタート

Skill routingの適用

このsuiteは技術非依存の設計原則を扱います。プログラミング言語、framework、tool固有のSkillを併用する場合は、主成果物に最も合うmino Skillを基本workflowとし、必要な技術差分だけを追加します。現在のrouting規則は、maintainerが責任を持って採用・保守しています。

Skill compositionを利用側のAGENTS.mdへ記載する例:

# Skill Composition

When a request matches multiple Skills:

- Use the Skill that best matches the primary outcome as the basic workflow.
- Add only relevant language-, framework-, or tool-specific Skills to supplement that workflow.
- Let the basic Skill control scope, changes, validation, and the final response; specialized Skills provide their domain-specific guidance.
- Preserve every applicable Skill's exclusions, hard gates, and safety constraints.
- Follow the user's explicitly named Skills and do