frontend-forge-fi-operations

name	frontend-forge-fi-operations
description	Operate FrontendIntegration resources and the frontend-forge extension. Use when Codex needs to create a FrontendIntegration from FrontendIntegration YAML, update or patch FI lifecycle state, inspect or troubleshoot FI build output, or create, enable, disable, uninstall, and inspect the frontend-forge extension through its InstallPlan and extension resources.

Frontend Forge FI Operations

Operate FrontendIntegration resources and the frontend-forge extension with kubectl.

When to Use

• Create a FrontendIntegration from complete FrontendIntegration YAML
• Update, enable, disable, or delete an existing FI
• Inspect FI status, build jobs, JSBundle, ConfigMap, manifest, or source-spec annotations
• Troubleshoot FI reconciliation or build output
• Create, enable, disable, uninstall, or inspect the frontend-forge extension

Do Not Use

• Generate new FrontendIntegration YAML from natural language
• Manage extensions other than frontend-forge
• Assume FI operations are valid before checking extension state
• Use patch as the creation path for a new FI when the user already has YAML

Preconditions

• kubectl must be configured for the target cluster.
• frontend-forge extension installation and enabled state are prerequisites for all FI functionality.
• frontend-forge-controller exists only after the frontend-forge extension is installed.
• FrontendIntegration is cluster-scoped. Do not add -n when operating on FI resources.

Read First

• Read references/extension-management.md before any FI operation.
• Read references/lifecycle.md for FI create, update, enable, disable, and delete workflows.
• Read references/inspection.md for FI inspection and troubleshooting.

Preflight

Always run these checks before any FI create, update, enable, disable, delete, inspect, or troubleshoot flow:

kubectl get extension frontend-forge
kubectl get installplan frontend-forge -o yaml

Only continue to FI operations when:

• the frontend-forge extension exists
• the frontend-forge InstallPlan exists
• spec.enabled=true on the InstallPlan

If the extension is missing or disabled, switch to the extension management workflow first.

FI Operations

Create FI From YAML

Only create FI from complete FrontendIntegration YAML content or a YAML file path.

1. Run the preflight checks.
2. If the user provides YAML content, write it to a temporary file.
3. Apply the YAML with kubectl apply -f.
4. Inspect the result.

See references/lifecycle.md for the exact create and post-apply inspection commands.

Update Existing FI

• Prefer editing YAML and re-applying it.
• Use patch only for targeted lifecycle changes when the user explicitly wants patch semantics.

See references/lifecycle.md for the exact update, enable, disable, and delete commands.

Disable FI

Disable an existing FI by patching spec.enabled=false.

See references/lifecycle.md for the exact disable command and post-check flow.

Enable FI

Enable an existing FI by patching spec.enabled=true.

See references/lifecycle.md for the exact enable command and post-check flow.

Delete FI

Delete the FI resource only after the preflight checks pass.

See references/lifecycle.md for the exact delete command.

Extension Management

Use fixed resource names for frontend-forge:

• extension: frontend-forge
• InstallPlan: frontend-forge

Create Extension

Ask the user for the frontend-forge extension version. If it is not provided, resolve the latest version first.

See references/extension-management.md for the exact version lookup command and InstallPlan YAML.

Disable Extension

Patch installplan/frontend-forge so spec.enabled=false.

Enable Extension

Patch installplan/frontend-forge so spec.enabled=true.

Uninstall Extension

Delete installplan/frontend-forge.

Inspect Extension State

Inspect extension/frontend-forge and installplan/frontend-forge.

See references/extension-management.md for the exact create, enable, disable, uninstall, and inspect commands.

Rules

• Treat extension readiness as the first gate for all FI operations.
• Create new FI resources only from FrontendIntegration YAML.
• Prefer kubectl apply -f for FI creation.
• Keep FI troubleshooting available after the preflight checks pass.
• Keep command details in references; keep SKILL.md focused on routing and decision logic.
• Use extension and installplan resources as the source of truth for extension state.
• Treat frontend-forge-controller existence as a runtime signal, not the primary source of truth.
• Do not generalize extension commands to any name other than frontend-forge.