troubleshoot-errors

name: troubleshoot-errors description: Diagnose common LikeC4 errors (element not found, unknown kinds, invalid relationships). Provides causes and solutions.

Troubleshoot LikeC4 Errors

Use this skill when resolving common LikeC4 syntax or reference errors.

Common Issues

"Element not found"

• Cause: Using short name instead of FQN
• Solution: Use mySystem.api not api for nested elements

"Unknown element kind"

• Cause: Invalid or generic element kind
• Solution: Check projects/shared/spec-*.c4 for valid kinds; use specific kinds like Container_Api not Container

"Invalid relationship kind"

• Cause: Undefined relationship type
• Solution: Use defined kinds: calls, async, reads, writes, uses (model) or http, https, tcp (deployment)

Diagram shows unexpected elements

• Cause: Over-broad wildcard includes like include **
• Solution: Use scoped wildcards: include mySystem.* or include mySystem.* ->

"instanceOf target not found"

• Cause: Referencing non-existent or wrong element type
• Solution: Ensure target is a Container from model, use FQN: instanceOf mySystem.api