frontend-forge-fi-operations

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](references/extension-management.md) before any FI operation.
• Read [references/lifecycle.md](references/lifecycle.md) for FI create, update, enable, disable, and delete workflows.
• Read [references/inspection.md](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](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](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](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](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](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](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](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.