up

ops/devops/devportal/AGENTS.md

@@ -0,0 +1,21 @@
+# DevPortal Build & Offline — Agent Charter
+
+## Mission
+Automate deterministic developer portal builds (online/offline), enforce accessibility/performance budgets, and publish nightly offline bundles with checksums and provenance.
+
+## Scope
+- CI pipeline for `devportal` (pnpm install, lint, type-check, unit, a11y, Lighthouse perf, caching).
+- Offline/nightly build (`devportal --offline`) with artifact retention and checksum manifest.
+- Accessibility checks (axe/pa11y) and link checking for docs/content.
+- Performance budgets via Lighthouse (P95) recorded per commit.
+
+## Working Agreements
+- Use pnpm with a locked store; no network during build steps beyond configured registries/mirrors.
+- Keep outputs deterministic: pinned deps, `NODE_OPTIONS=--enable-source-maps`, UTC timestamps.
+- Artifacts stored under `out/devportal/<run-id>` with `SHA256SUMS` manifest.
+- Update sprint entries when task states change; record evidence bundle paths in Execution Log.
+
+## Required Reading
+- `docs/modules/platform/architecture-overview.md`
+- `docs/modules/devops/architecture.md`
+- `docs/modules/ui/architecture.md`