Product architecture | source-grounded notes

Architecture Notes

Reader-facing product architecture for the AI Capability Playbook workstream. These notes shape sequencing and source-grounded assistant boundaries, but they do not approve runtime behavior or production use.

AI Capability Playbook Playbook Home Playbook Map Shared Foundations AI Capability Discipline Assistant Architecture Notes

Navigation Posture

Architecture Notes are user-facing source and backlog documentation for the AI Capability Playbook workstream. The primary navigation points to this HTML index rather than raw Markdown. Source notes remain linked for maintainers and grounding, but this page is the reader route.

These notes do not create runtime behavior, backend services, GUI work, provider execution, connector ingestion, repo migration, generated artifact redesign, policy approval, or production approval.

Source-Grounded Assistant Sequence

Contract

Source-Grounded Assistant Prototype

Defines the approved package-only assistant contract, citation schema, refusal behavior, and non-runtime boundaries.

Modes

Source-Grounded Semantic Explainer

Frames Find, Explain, and Assess behavior over approved package sources and keeps model memory out of source authority.

Assessment

Proposal Assessment Path

Names proposal review dimensions, finding classes, and the distinction between guidance and approval.

External proof

Static Site Chat Proxy Requirements

Records the server-side proxy requirement, source-grounding posture, security boundaries, and deferred persistence scope.

Deployment And Operating Notes

Internal path

Microsoft-Native Internal Pilot

Separates the reader site, grounding corpus, and interpretation layer for an internal pilot path.

API path

External API Reference Implementation

Defines the reference adapter boundary without approving any provider, model, workflow, or production use.

Routing

Workload Model Routing Discipline

Preserves swappable model and provider posture while keeping deterministic checks and token evidence visible.

Product boundary

Playbook Product Architecture

Records the governed package boundary and the relationship between the reader surface, corpus, assistant, and proof environment.

Reader Boundary

The polished route is this HTML page. Markdown files remain source notes and context-pack material. Future product work can add rendered HTML pages for individual notes when an issue requires it, but this issue does not implement #186 current context mode, #187 uploads, #188 whole-site Access, or #189 persistent telemetry.