Edgion

Conventions shared by the in-repo binaries (edgion-controller, edgion-gateway, edgion-cli) — project overview, command line / directory / config-path conventions, Core layering conventions, resource system.

KubernetesCenter implementation — K8s Reflector watching, leader election, HA mode, ResourceController lifecycle, status writeback.

ConfigCenter subsystem — ConfCenter trait abstraction, FileSystemCenter and KubernetesCenter implementations, unified Workqueue + ResourceProcessor pipeline.

edgion-controller control plane architecture — overall design, startup/shutdown, Admin API, ConfigCenter, Workqueue, ResourceProcessor, Requeue, CacheServer, ACME service.

Route matching overview — multi-stage pipeline (Listener→Domain→Path→DeepMatch), per-listener isolation, registration flow, atomic swap.

TLS subsystem overview — TLS Store, SNI matching, certificate management, BoringSSL/OpenSSL backend selection.

edgion-gateway data plane architecture — Pingora integration, route matching, TLS management, plugin system, load balancing, backend discovery, observability, LinkSys.

Authoritative document for URI normalization architecture — full-stack naming table, dual-view concept, iron rules, security guarantee scope, set_upstream_uri integration point.

Bidirectional gRPC sync architecture between Controller and Gateway — ConfigSync protocol, Watch/List mechanism, implementation on both sides.

edgion-cli CLI tool architecture — three target modes, subcommands, output formats, HTTP client.

Resource taxonomy and processing — common processing flow, per-resource feature points / special handling / cross-resource relationships.

Use when understanding how Edgion works internally — Controller/Gateway/Center/Ctl architecture, gRPC sync, resource processing flow, or adding a new plugin/resource/connector.

Startup, CLI arguments, deployment patterns, and Feature Flags for the in-repo binaries (edgion-controller/gateway/cli).

Configuration schema reference: complete field definitions for Controller (YAML) and Gateway (YAML) configuration and the EdgionGatewayConfig CRD.

Feature and configuration schema reference for all Kubernetes resources. Numbering aligns with 01-architecture/05-resources, organized uniformly by resource type.

Use when looking up how to configure Access Logs, Metrics endpoints, or protocol log output for Edgion Gateway.

Full reference for Edgion annotations and Options keys: metadata.annotations, tls.options, spec.options, and system reserved keys.

Use when looking up configuration schemas, resource field definitions, binary deployment options, observability settings, or edgion.io/* annotation references.

DSL plugin implementation skills for Edgion — builtin development, path/uri variable reference, redis/http builtin guides. Use when adding or modifying a `req.*`, `http.*`, or `redis.*` builtin, or wiring DslRuntime fields for a new namespace.

Coding standards skill for Edgion. Use when reviewing or writing code that touches logging, tracing IDs, log safety, access logs, metrics, structured tracing, or shared project-wide implementation rules.

Use when reviewing CPU or memory performance findings; index of per-scenario decision rules for accepted patterns (lazy cleanup, mandatory .to_string() API, single-shot allocations, etc.).

Use when reviewing JSON/YAML/protobuf/binary deserialization paths for panic-on-unknown, recursion depth, size limits, untrusted-input boundaries, and serde flatten footguns.

Review lock for the Gateway admin API bearer-token auth — the locked invariants (always-on, 503 fail-close, 401, constant-time compare, merged-router coverage, redacted token, probe stays open) and a note not to re-report the historical unauthenticated finding.

Review-specific knowledge for Edgion. Use when auditing code review findings, especially to check whether a reported issue is a real bug, a project-accepted tradeoff, or a known false positive. Includes observability review rules (data-plane zero tracing, metrics explosion prevention, access log quality).

Use when reviewing dependency upgrades, new crate additions, MSRV bumps, license/maintenance-mode crate risks, or lockfile audit findings; documents the `cargo audit`/`cargo deny` cadence and triage rules.

Review decision rules for URI normalization — which scenarios are closed, which still need to be reported, the two lint rules and the allowlist.

Testing skill for Edgion. Use when writing, running, or extending unit tests, integration tests, K8s tests, LinkSys tests, or configuration sync validation workflows.

Debugging and troubleshooting skill for Edgion. Use when local code changes break routing, plugins, sync, readiness, or runtime behavior.

Use this skill when creating, updating, or continuing tasks under the repository's tasks/ directory. Covers task structure, document set, lifecycle phases, status tracking, and task templates.

Compatibility notes for Edgion's Gateway API handling, including intentional deviations and not-implemented features.

Use when working with Gateway API compatibility, planning a Kubernetes API version upgrade, or verifying K8s resource behavior specific to Edgion.

CI/CD skills for Edgion: local build, Docker build, GitHub Actions workflows, and GitHub Release publishing.

Use for pre-commit/local checks, CI/CD workflows, Docker builds, release automation, dev hot-replace deployment, or TLS troubleshooting.

Use when running or preparing a global codebase review pass that produces tasks/review-N-<slug>/ findings; defines the 6-subagent batch workflow and the per-finding output format.

User-documentation writing standards. Use this skill when writing or reviewing docs under docs/. Covers directory structure, writing style, page templates, internationalization, version management, and review checklist.

Root navigation for the Edgion knowledge base. Read this first, then drill into the relevant subtree.