Composition ドキュメント索引¶
Composition · 日本語参考訳英語 · 正本
参考訳(非正本): この文書は英語版
docs/index.mdの日本語参考訳です。正本は英語版であり、内容または解釈に相違がある場合は英語版が優先されます。
ここから始める¶
- Website と Web application の選び方 — browser-facing product の artifact を static/dynamic、hosting、runtime、PWA 技術ではなく product identity と caller-visible behavior から分類します。
- Website product walkthrough — 初めて content/document-oriented Website を作る場合の canonical first-use path です。別 repository の Project Docs を
website選択、inspect -> plan -> apply -> validate、Website contracts、planning/product evidence、implementation、browser proof まで進めます。 - Webapp product walkthrough — 初めて Web application を作る場合はここから始めます。別 product repository から Task Ledger を zero-to-one で進め、installation、
composition.json、inspect -> plan -> apply -> validate、ownership、implementation、product tests、evidence、optional Policy、後続 update/upgrade までを追体験します。 - 初見者向け Composition concepts — recipe、artifact、component、contract、material、lock など、この repository 固有の意味を持つ語の mental model を補助的に説明します。
- Agent Skill first-use walkthrough — 別 repository で再利用可能な Skill を作るための最小の Composition path です。
- Composition の評価 — canonical な independent clean-room evaluator entry point です。
- Composition の利用方法 — consumer repository の作成、inspect、update、upgrade、recovery、ownership、conflict を扱うタスク指向 workflow です。
- Recipe と component の選び方 —
skill、website、webappを選び、product が実際に必要とする capability または lifecycle behavior だけを選択します。 - プロダクトリリースの生成 — product evidence、fixed executable argv、exact candidate revision、transactional release production、rollback、recovery を説明します。
- Composer リファレンス — 正確な CLI mode/options、inspect states、plan fields、ownership semantics、recovery rules、managed lifecycle diagnostics を説明します。
- Composition 概要 — 現在の authority、lifecycle summary、safety model、documentation entry points を説明します。
Composition architecture¶
- Composition model — foundation、artifact、capability、lifecycle、ownership、intent、lock semantics を説明します。
- Composer architecture — resolver precedence、plan/apply safety、trust boundaries、managed reconciliation、recovery protocol を説明します。
- Production catalog architecture — closed component と recipe inventory を説明します。
- Generated contract manifest — deterministic generated contract registry architecture を説明します。
公開境界¶
- 公開境界 — この provider が統合ドキュメントサイトへ何を公開し、その境界をなぜ設けるかを説明します。
Composition provider の保守¶
- Composition provider の保守 — component、catalog、Composer、schema、evaluation、validation、provider publication、provider release procedure を含む、Composition 自体を変更するための canonical overview です。consumer product の保守手順ではありません。
- Composition installer release — installable Composition Skill の immutable provider release identity と verified consumer bootstrap boundary を説明します。
Agent Skill artifact¶
- Skill ドキュメント索引 — Skill-specific profiles、architecture、responsibility map を説明します。
- Skill contract scaffold — trigger、workflow、resources、routing、output、validation、safety contract を説明します。
Shared Web foundation¶
- Website / Web application 判断ガイド — artifact selection と shared Web semantics / artifact-specific semantics の境界を説明します。
- Web URL / path design guidance — route conformance を変更せず、naming、persistence、hierarchy、query/fragment、implementation independence を扱う advisory guidance です。
- Shared browser identity contract — product-neutral browser identity。
- Shared routes contract — generalized canonical path、alias、deep-link expectation、navigation accessibility。
- Shared viewports contract — responsive viewport と input-capability expectation。
Website artifact¶
- Website product walkthrough — concrete content/document-oriented Website の canonical first-use path です。
- Website component descriptor — Website artifact の dependency、contract、validator、material。
- Website structure contract — page inventory、hierarchy、home page、primary navigation、shared-route binding。
- Website document metadata contract — title、description、language、canonical-path policy、indexability、social-preview intent。
- Website discovery contract — canonical origin、robots、sitemap、feed discovery semantics。
Web application artifact¶
- Webapp product walkthrough — concrete Web application の canonical first-use path です。
- Web application ドキュメント索引 — shared Web foundation 上の application-specific contract と validation を説明します。
- Web application template contract — framework-neutral browser application obligations を説明します。
再利用可能な application capabilities¶
- Implementation runtime decision record — implementation ecosystem、commands、dependencies、environment、distribution、deployment choices を説明します。
- Implementation runtime の選択 — implementation ecosystem と dependency workflow を選択する criteria を説明します。
- Progressive Web App capability — Website / Webapp の双方で利用できる artifact-neutral な installability、offline/freshness、application identity、update behavior。
- Packaged CLI interface — caller-visible CLI behavior を説明します。
- MCP interface — MCP protocol、transports、client roles、semantic equivalence を説明します。
- MCP transport guidance — stdio と Streamable HTTP の guidance を説明します。
- MCP Apps extension — Host/View bridge、resources、sandbox、fallback contract を説明します。
- MCP Apps guidance — MCP Apps の implementation guidance を説明します。
- WebMCP browser capability — canonical な browser-exposed MCP capability contract、selection boundary、runtime behavior、security expectation を説明します。
- Standalone browser interface — browser-facing routing、security、health、failure semantics を説明します。
- Headless service interface — non-browser service behavior、health、security、lifecycle を説明します。
再利用可能な lifecycle contracts¶
- Composition state — self-contained resolved-state と material-ownership validation を説明します。
- Contract evolution — closed contract registry、schema binding、version histories、migrations を説明します。
- Implementation evidence — implementation boundaries、proofs、commands、release gates を説明します。
- Release evidence — revision-bound execution provenance と release decisions を説明します。
- Release bundle — deterministic digest-closed handoff を説明します。
リポジトリトポロジ¶
- Repository topology contract — Hub-and-Orphan トポロジ不変条件、読み取り専用 discovery 投影、orphan コンポーネント権威、branch-equals-mount-path、leaf-only 名前空間、および権威から Hub への同期を説明します。
- Repository topology architecture — Hub-and-Orphan パターンのアーキテクチャ詳細および運用不変条件を説明します。
Historical provenance¶
- Composition authority migration — authority cutover、provider migration、branch retirement、immutable PR provenance の統合 chronology です。
Machine-readable authorities¶
- Production catalog guide — catalog closure rules、path conventions、consumer recipe/component selection guidance を説明します。
- Composition schema guide — component、recipe、configuration、lock、transaction、catalog schema responsibilities を説明します。