Istio Gateway API Review
Resolve listeners, route attachment, references and controller status without conflating API families.
Decision and boundary
Is the intended listener/route/backend relationship valid, attached and adequately evidenced?
Operate as static-review. Read supplied files only; never collect live evidence, probe, mutate, or inherit ambient credentials. Host-enforced tool permissions remain mandatory.
Required inputs
Require intended behavior/access, rendered resources, exact environment/version/mode scope, and an evidence ledger with capture times and visibility limits. Continue bounded analysis when fields are missing, but mark affected conclusions needs-review.
Workflow
- Record the full apiVersion/kind, CRD bundle/channel, implementation/controller version and intended role: ingress, waypoint or mesh Service attachment.
- Build GatewayClass -> Gateway listener -> Route parent -> backend/certificate references; branch explicitly for Service-attached mesh routes.
- Check parent selection, listener compatibility, hostname intersection and allowed namespace/kind relationships; do not substitute ReferenceGrant for listener attachment controls.
- Resolve cross-namespace backend/certificate permissions and destination existence separately from Route-to-Gateway authorization.
- Evaluate Accepted, ResolvedRefs and Programmed where defined, with correct parent/controller and observedGeneration; treat absent or stale conditions as unresolved.
- Return graph findings and positive/negative request-path tests; do not infer end-to-end behavior from status alone.
Reference loading
Read evidence-boundary.md, applicability.md, and output-contract.md first. Load the following only for the active branch.
| Reference |
Load when |
| attachment-graph.md |
Resolve API groups, parent relationships and backend references. |
| conditions-and-freshness.md |
Interpret controller and parent-specific status. |
| tls-and-boundaries.md |
Review TLS termination, certificates, SNI and hostname exposure. |
| negative-tests.md |
Define attachment and traffic-path counterexamples. |
| official-sources.md |
Verify a version-sensitive rule or source disagreement. |
| review-contract.json |
Produce or validate a portable structured review. |
Deliverable
Fully qualified attachment graph, cross-namespace decisions, condition freshness and missing path tests.
Separate observed evidence, derived conclusions, assumptions and unknowns. Include one counterexample for every consequential finding. Never describe unperformed tests as passing or a bounded review as production certification.
1---2name: istio-gateway-api-review3description: Review Istio ingress or waypoint routing that uses Kubernetes Gateway4 API GatewayClass, Gateway, HTTPRoute, GRPCRoute and ReferenceGrant resources, and5 distinguish them from Istio networking Gateways. Use for unaccepted routes, stale6 conditions, cross-namespace backends/certificates, missing listeners, TLS/hostname7 mismatches or Service-attached mesh routes. Consume supplied manifests/status only;8 do not change Gateways or fetch Secrets.9allowed-tools: Read Grep Glob10metadata:11 source: https://skillmd.com/skills/vincentchuwaichow/istio-gateway-api-review12 author: 'github: VincentChuWaiChow'13 version: 0.1.014 category: networking15 lifecycle: beta16 execution_tier: static-review17---1819# Istio Gateway API Review20Resolve listeners, route attachment, references and controller status without conflating API families.21## Decision and boundary22Is the intended listener/route/backend relationship valid, attached and adequately evidenced?23Operate as static-review. Read supplied files only; never collect live evidence, probe, mutate, or inherit ambient credentials. Host-enforced tool permissions remain mandatory.24## Required inputs25Require intended behavior/access, rendered resources, exact environment/version/mode scope, and an evidence ledger with capture times and visibility limits. Continue bounded analysis when fields are missing, but mark affected conclusions `needs-review`.26## Workflow271. Record the full apiVersion/kind, CRD bundle/channel, implementation/controller version and intended role: ingress, waypoint or mesh Service attachment.282. Build GatewayClass -> Gateway listener -> Route parent -> backend/certificate references; branch explicitly for Service-attached mesh routes.293. Check parent selection, listener compatibility, hostname intersection and allowed namespace/kind relationships; do not substitute ReferenceGrant for listener attachment controls.304. Resolve cross-namespace backend/certificate permissions and destination existence separately from Route-to-Gateway authorization.315. Evaluate Accepted, ResolvedRefs and Programmed where defined, with correct parent/controller and observedGeneration; treat absent or stale conditions as unresolved.326. Return graph findings and positive/negative request-path tests; do not infer end-to-end behavior from status alone.3334## Reference loading35Read [evidence-boundary.md](references/evidence-boundary.md), [applicability.md](references/applicability.md), and [output-contract.md](references/output-contract.md) first. Load the following only for the active branch.36| Reference | Load when |37| --- | --- |38| [attachment-graph.md](references/attachment-graph.md) | Resolve API groups, parent relationships and backend references. |39| [conditions-and-freshness.md](references/conditions-and-freshness.md) | Interpret controller and parent-specific status. |40| [tls-and-boundaries.md](references/tls-and-boundaries.md) | Review TLS termination, certificates, SNI and hostname exposure. |41| [negative-tests.md](references/negative-tests.md) | Define attachment and traffic-path counterexamples. |42| [official-sources.md](references/official-sources.md) | Verify a version-sensitive rule or source disagreement. |43| [review-contract.json](references/review-contract.json) | Produce or validate a portable structured review. |4445## Deliverable46Fully qualified attachment graph, cross-namespace decisions, condition freshness and missing path tests.47Separate observed evidence, derived conclusions, assumptions and unknowns. Include one counterexample for every consequential finding. Never describe unperformed tests as passing or a bounded review as production certification.