# MNPPI Architecture

> How MNPPI builds, ships, and runs on Cloudflare Workers.

Use these files for the current public standard. The Git repository remains the source of truth.

Prefer Markdown URLs that end in `/index.md`, or use `/llms-full.txt` for one-shot context.
This site is static and does not negotiate `Accept: text/markdown` on HTML URLs.
Fetch the `.md` links below directly.

## Start here

- [Reference architecture overview](https://architecture.mnppi.org/start/overview/index.md): Architecture, delivery, operations, and governance for MNPPI projects on Cloudflare.
- [Adoption checklist](https://architecture.mnppi.org/start/adoption-checklist/index.md): Bring a Cloudflare project onto the MNPPI baseline without unused services.

## Architecture

- [Cloudflare flagship stack](https://architecture.mnppi.org/architecture/cloudflare-flagship-stack/index.md): Default stack and operating controls for new MNPPI projects on Cloudflare Workers.
- [Application profiles](https://architecture.mnppi.org/architecture/application-profiles/index.md): Choose the smallest Cloudflare profile for the product and its risk.
- [Platform adoption](https://architecture.mnppi.org/architecture/platform-adoption/index.md): Pilot Cloudflare features before they become organization defaults.

## Delivery

- [CI/CD and merge controls](https://architecture.mnppi.org/delivery/ci-cd-and-merge-controls/index.md): GitHub validates merges. Cloudflare builds and deploys the default branch.
- [Quality controls and reference tooling](https://architecture.mnppi.org/delivery/quality-controls-and-tooling/index.md): Required quality controls, reference tools, and when each blocks a merge.
- [Cloudflare deployment](https://architecture.mnppi.org/delivery/cloudflare-deployment/index.md): Workers Builds owns production builds. Deploy static and dynamic apps through Cloudflare.
- [Release and recovery](https://architecture.mnppi.org/delivery/release-and-recovery/index.md): Release checks, rollback limits, and data recovery before an incident.

## Operations

- [Self-hosted runner security](https://architecture.mnppi.org/operations/runner-security/index.md): Disposable job environments for untrusted workflow code on self-hosted GitHub runners.
- [Observability](https://architecture.mnppi.org/operations/observability/index.md): Health, cost, and recovery signals with clear owners.

## Governance

- [Standard lifecycle](https://architecture.mnppi.org/governance/lifecycle/index.md): Review the reference architecture on a schedule and after platform changes.
- [Exceptions](https://architecture.mnppi.org/governance/exceptions/index.md): Record, review, and close exceptions to the standard.

## Optional

- [Complete reference](https://architecture.mnppi.org/llms-full.txt): All published reference content in one generated file.