hs-sql-agent 目前可分為後端、管理介面前端，以及獨立的產品與文件網站。
程式庫分工
高層次來看：
backend/：伺服器、SQL 編譯器與執行階段模組、持久化層與測試。frontend/：內嵌式 Nuxt 管理介面。hs-sql-agent.site：獨立的 Astro 產品與文件網站。
SQL 編譯器以 F# 模組實作，包含明確的改寫與驗證階段，以及能力證明（capability proof）機制。伺服器掛載能力由 HsSqlAgent.Server 以可組合的 ASP.NET Core 類別庫提供：新的整合從 AddHsSqlAgentCore() 開始，再依需求選擇 Runtime、AdminStore、HostAuthorization 或 BuiltInAuth、AdminApi、MCP、Telemetry 等模組。AddHsSqlAgent() / UseHsSqlAgent() 則保留給既有使用者維持相容性，不再是第一方建議的新整合方式。
貢獻流程
主程式庫的貢獻指南要求貢獻者：
- Fork 程式庫。
- 實作聚焦的變更，並補上必要的測試或文件。
- 在本機執行並確認相關測試通過。
- 建立 Pull Request，說明變更動機、修改內容與測試證據。
讓一個 PR 聚焦在單一任務，通常更容易審查與合併。
文件變更
文件應描述目前程式碼真正具備的行為，而不是尚未實作的預期功能。
當 SQL 功能支援、DML 安全機制、MCP 相容性、host 設定、管理介面行為或部署需求改變時，應同步更新對應文件。
網站以 URL 路徑區分語系，並在文件路徑中保留版本號：
src/content/en/docs/<version>/<section>/<slug>.mdx
src/content/zh-hant/docs/<version>/<section>/<slug>.mdx各語系刻意共用相同的 version/section/slug 結構，再由語系前綴隔離路由。完整文件基準會依設定的版本繼承關係解析。