Reference

Command reference and project rules

This section provides reference documentation for Camel-Kit commands, project rules, and architectural constraints.

Command Reference

See Commands for a comprehensive list of all available slash commands, their parameters, and usage examples.

Key commands include:

  • /camel-brainstorm — Explore integration requirements and identify patterns
  • /camel-project — Define project metadata and dependencies
  • /camel-flow — Design integration flows (source → steps → sink)
  • /camel-migrate — Migrate from MuleSoft, Fuse, or older Camel versions
  • /camel-execute — Run the full 3-phase pipeline (design → implement → test)
  • /camel-validate — Validate routes against MCP catalog
  • /camel-test — Generate integration tests with sample payloads
  • /camel-knowledge — Ask questions about Apache Camel documentation

Constitution: 7 Iron Laws

Every Camel route generated by Camel-Kit must follow 7 Iron Laws defined in the project constitution:

  1. Apache Camel alignment — Use only supported components
  2. YAML DSL — All routes in YAML (no XML or Java DSL)
  3. Explicit error handling — Every route has onException or doTry/doCatch
  4. Configuration externalization — No hardcoded values (use properties)
  5. Logging & observability — Log at flow boundaries, use Micrometer metrics
  6. Idempotency — Handle duplicate messages gracefully
  7. Component verification — Verify all components via MCP before generating routes

These laws are enforced by:

  • Skills — Reference the constitution during design and implementation
  • Validation — /camel-validate checks compliance
  • Tests — Generated tests verify error handling and idempotency

Project Structure

Camel-Kit expects projects to follow this structure:

📁 my-camel-project/
📄 pom.xml Maven project descriptor
📁 src/
📁 main/
📁 java/ Java beans and processors
📁 resources/
📁 camel/ Camel YAML routes
⚙️ routes.yaml
⚙️ error-handlers.yaml
📁 xslt/ XSLT transformations
📄 order-transform.xslt
📄 application.properties Configuration
📁 test/
📁 java/ Integration tests
☕ OrderRouteTest.java

Architecture Decisions

See the Architecture section for detailed explanations of each layer.

Version Alignment

Camel-Kit defaults to Apache Camel:

  • Default version: 4.14.0
  • Supported versions: 4.11.x, 4.14.x (Apache Camel)
  • Community versions: Also supported, but not recommended for production

Next Steps

  • Commands — Full command reference with examples
  • Architecture — Deep dive into 4-layer architecture
  • Migration — Migrate from MuleSoft, Fuse, or older Camel

Command Reference