index.md

SDK Docs

Practical entrypoint for Loong SDK-related work.

Loong's SDK is not one helper crate. It is a set of contracts and workflows for capability:

• authoring
• integration
• acquisition
• validation
• promotion

Who This Is For

Internal maintainers

Start with:

• Internal Integration Quickstart
• Internal Integration SDK Contract
• Provider SDK Convergence Plan

External authors

Start with:

• External Authoring Quickstart
• External Authoring Contract
• SDK Validator Contract
• SDK Stability Policy

Promotion and capability-evolution work

Start with:

• Capability Promotion Contract
• SDK Strategy Implementation Roadmap

Document Map

Document	Use it for
Internal Integration Quickstart	Adding or refactoring repository-owned surfaces
Provider SDK Convergence Plan	Converging the provider family into a clearer maintainer-facing seam
External Authoring Quickstart	Understanding what external authors should build today
Compatibility Matrix	Stability and maturity boundaries across SDK surfaces
SDK Strategy	Overall architecture framing
SDK Stability Policy	What is stable, additive, experimental, or internal
SDK Validator Contract	What Loong validates for capability artifacts
External Authoring Contract	Public package and artifact authoring contract
Capability Promotion Contract	Governed codification path from runtime evidence to durable assets

Current Reading Of The Repository

Loong is not best understood as a discovery-first product anymore.

The current direction is:

• discovery-first as a lower-layer substrate
• product mode as the capability-acquisition surface
• autonomy-policy as the internal decision kernel
• governed promotion as the path from runtime evidence to durable capability assets