luigidemasi opened a new issue, #39: URL: https://github.com/apache/camel-kit/issues/39
> Imported from [luigidemasi/camel-kit#71](https://github.com/luigidemasi/camel-kit/issues/71), opened by [luigidemasi](https://github.com/luigidemasi) on 2026-05-13. > Closed by commit [e713383](https://github.com/luigidemasi/camel-kit/commit/e713383b06317c2f417e8b84524401f340ccf531). --- ## Context From the [Agent Skills Context Engineering Analysis](https://github.com/luigidemasi/camel-kit/blob/main/docs/adr/0029-progressive-skill-loading-meta-router.md) — Idea luigidemasi/camel-kit#3. **Source pattern:** `debugging-and-error-recovery` skill from [agent-skills](https://github.com/addyosmani/agent-skills) (STOP → PRESERVE → DIAGNOSE → FIX → GUARD → RESUME workflow). ## Problem `camel-verify` handles build/test failures *during the pipeline*, and `error-taxonomy.md` classifies errors. But there's no skill for when a user arrives with "my route is broken, help me debug it" — outside of a pipeline run. The meta-router (`camel-start`) currently has no good target for "my route isn't working" — it can route to verify, but verify is now internal (dispatched by execute as a subagent, per ADR-0030). ## Proposed Solution Create a `/camel-debug` skill that handles ad-hoc troubleshooting: 1. **Preserve state** — don't change anything before understanding the error 2. **Classify** — use `error-taxonomy.md` to categorize (startup, runtime, data, connectivity) 3. **Diagnose** — MCP catalog verification, route validation, log analysis 4. **Fix** — targeted fix with explanation 5. **Guard** — suggest a test or validation rule to prevent recurrence **Tier classification:** Tier 1 (pipeline-adjacent) or Tier 2 (power user utility) — TBD. **Context management:** Run diagnosis steps as subagents. Only the classification and fix recommendation enter the main context. ## Acceptance Criteria - [ ] `skills/camel-debug/SKILL.md` exists with the STOP → PRESERVE → DIAGNOSE → FIX → GUARD workflow - [ ] Error taxonomy integration (reuses existing `error-taxonomy.md`) - [ ] MCP catalog verification during diagnosis - [ ] `camel-start` decision tree routes "my route is broken" to `/camel-debug` - [ ] Slash command `/camel-debug` works across all agent platforms - [ ] Subagent isolation for diagnosis steps -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected]
