Frontend Forge Fi Operations

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.