References¶
Evidence (dated)
This page records observations at a stated revision and date. Re-verify before relying on it; it is not a permanent contract.
This page lists the sources the site relies on and what each is authority for. It was empty until 2026-10-09. Entries marked binding constrain Factory design; entries marked context inform it; entries marked input are proposals that were reviewed, not adopted.
Binding ConnectSoft decisions (ConnectSoft.Documentation)¶
| Source | Role | Status |
|---|---|---|
Docs/decisions/adr/adr-00xx-template-layering-and-submodules.md (accepted 2026-01-15) |
Three-layer template model: Layer 1 ConnectSoft.Extensions.* NuGet, Layer 2 BaseTemplate as Git submodule, Layer 3 specialized overlays |
Binding |
Docs/decisions/adr/adr-0100-connectsoft-saas-multitenancy-resolution.md (accepted 2026-05-01) |
Tenant tokens per layer, resolution order, four installation modes, gateway trust boundary, no key-only loads in shared DB | Binding; applied by ADR-0015 |
Docs/decisions/adr/adr-0101-connectsoft-identity-platform.md (accepted 2026-06-30) |
Authorization Server as sole issuer; Identity Service; gateway and backend responsibilities; Shell-owned frontend auth | Binding; applied in ADR-0008 review note |
Docs/decisions/adr/adr-00xy-metrics-options-and-testing-extensibility.md, adr-00xz-foundation-documentation-migration.md |
Extension points; canonical documentation ownership | Applicable; to verify per use |
Docs/internal/documentation-source-of-truth.md, Docs/starters/template-documentation-policy.md |
Canonical → BaseTemplate → overlay → generated documentation layering | Binding for documentation structure |
Docs/cross-cutting-concerns/ai-machine-learning/ (ai-extensions.md, agent-framework-rag.md, agent-skills.md, model-context-protocol.md, ai-evaluation.md, vector-ingestion.md, graphify-knowledge-graphs.md, microsoft-bot-framework.md, semantic-kernel.md) |
Shared AI guidance; Factory pages link, never copy | Context; some pages carry Semantic Kernel orchestration prose that is historical |
Docs/starters/saas-factory-generation.md (2026-05-12) and saas-* starter pages |
Consumer contract for SaaS descriptor → generator | Context; superseded by ADR-0025 (descriptors are an import format into blueprints) |
Repository: https://dev.azure.com/dmitrykhaymov/ConnectSoft/_git/ConnectSoft.Documentation
User direction and review packets (this repository)¶
| Source | Role |
|---|---|
handoffs/2026-10-08-ai-factory/USER-DIRECTION.md |
Binding user constraints: documentation-only scope; MAF primary; SK orchestration excluded, vector connectors allowed; MessagingModel preferred; no roadmap, dates or pilot |
handoffs/2026-10-08-ai-factory/originals/connectsoft-ai-factory-original-handoff.md |
The Oct-2026 target architecture (planes, principles, entities, flows) — input baseline, preserved unchanged |
handoffs/2026-10-08-ai-factory/ analysis, proposals and inventories (Data/Codex) |
Reviewed proposals: BC-01…33, GW-01…07, PK-01…24, FR/FUX/NFR/XL ids, first-slice example — input, not accepted |
handoffs/2026-10-09-independent-review/ |
Verification record, estate state, decision log, ADR dispositions, migration map, drift register, Cloud Design brief — evidence and decisions |
Source repositories inspected (evidence, revisions as of 2026-10-08)¶
| Repository | What it evidences |
|---|---|
ConnectSoft.AI.AgentKit (5238957) |
100 agents, 84 skills, bindings, review state of skills — an earlier, non-Factory experiment (D19); reference input only |
ConnectSoft.AI.SoftwareFactory.Platform (bf69afb), .Agents (f600e3f), .OpenClaw (3ce3370), .Workforce (9d960d4) |
Catalog/ingest definitions, schemas, placeholder workflows, OpenClaw runtime configuration, policy scaffold — earlier, non-Factory experiments (D19); reference input only |
ConnectSoft.Extensions.AI.Factory, .Abstractions, .Messaging, .Messaging.MassTransit, ConnectSoft.Extensions.AI, ConnectSoft.Extensions.AI.AgentsFramework |
Execution lifecycle, envelopes, model/vector adapters, agent builder |
ConnectSoft.AI.SoftwareFactory.AgentTemplate (9639e63) |
Agent host scaffold and its entry paths, retrieval sample, actor/scheduler/saga scaffolds |
ConnectSoft.Extensions.ModelContextProtocol (8e7feef) |
MCP hosting, authorization option, governance integration |
ConnectSoft.Extensions.MessagingModel and .Orleans, .MassTransit, .NServiceBus |
Messaging port and adapters, Orleans outbox/inbox |
ConnectSoft.Saas.*Template (five, all 2026-09-16) |
SaaS descriptor consumers and regenerate.ps1 behaviour |
ConnectSoft.DesignPrototypes (afc511b) |
41 prototype exports; Factory and Workflow Studio prototypes; design-system prompt and checklist |
DerechHaLev.DocumentationSite (42af0c2) |
Reference consumer of the template estate in source (nine services, Orleans messaging adopted; deployment status not verified here) |
ConnectSoft.CompanyDocumentation (9db192f5) |
Business model, portfolio, roadmaps, Factory technology stack — context only |
External documentation (not verified in this task)¶
| Source | Used for |
|---|---|
| Microsoft.Extensions.AI and Microsoft Agent Framework documentation | Model abstractions, agent hosting; durable extension capabilities are an open item |
| Model Context Protocol specification and security guidance | Tool transport, token-passthrough warnings |
| Microsoft Orleans documentation | Actor runtime and streaming guarantees (provider-dependent) |
MkDocs Material and mkdocs-redirects |
Site build, validation and URL redirects |
External claims about these sources were not re-verified against their current versions in this task; see handoffs/2026-10-09-independent-review/open-items.md.