# New Reconciler

> How to add a new component reconciler to the Che operator

- Skill: `eclipse-che/new-reconciler` (Agent Skill)
- Install (CLI): `npx skillmds@latest add eclipse-che/new-reconciler`
- Raw SKILL.md: https://api.skillmd.com/api/skills/eclipse-che/new-reconciler/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- Author: eclipse-che (https://skillmd.com/u/eclipse-che)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/eclipse-che/new-reconciler

---


# Adding a New Reconciler Component

Reference implementation: `pkg/deploy/dashboard/`

## Steps

1. Create a new package under `pkg/deploy/<component>/`
2. Define a reconciler struct implementing `Reconcilable` from `pkg/common/reconciler/`:
   - `Reconcile(ctx *chetypes.DeployContext) (reconcile.Result, bool, error)`
   - `Finalize(ctx *chetypes.DeployContext) bool`
3. Build k8s resource specs (Deployment, Service, ConfigMap, etc.) in the same package
4. Register the reconciler in `controllers/che/checluster_controller.go` via `reconcilerManager.AddReconciler()`
5. Placement in the chain matters — add after dependencies are reconciled
6. Run `make test` to verify