Skip to content

refactor(create-expert): add error recovery guidance to expert templates#373

Merged
FL4TLiN3 merged 1 commit intomainfrom
refactor/362-add-error-recovery
Jan 3, 2026
Merged

refactor(create-expert): add error recovery guidance to expert templates#373
FL4TLiN3 merged 1 commit intomainfrom
refactor/362-add-error-recovery

Conversation

@FL4TLiN3
Copy link
Contributor

@FL4TLiN3 FL4TLiN3 commented Jan 3, 2026

Summary

Add explicit error handling sections to expert templates to ensure all experts provide actionable "To fix:" guidance when errors occur.

Changes

Main Expert Template:

## Error Handling
When errors occur, provide actionable guidance:
- "❌ Error: [what went wrong] | To fix: [specific steps]"
- Never fail silently - always explain what happened and how to resolve it

Setup Expert Template:

## Error Handling
When setup fails, guide the user:
- "❌ Failed: [what went wrong] | To fix: [specific steps]"
- Suggest running the doctor expert for diagnostics

Rationale

This reinforces Design Principle #7: "All errors must include 'To fix: ...' guidance". The Doctor Expert Template already had this, but Main and Setup templates did not.

Closes #362

🤖 Generated with Claude Code


Note

Summary

Strengthens error guidance across expert templates by standardizing messages that include actionable "To fix:" steps.

  • Updates apps/create-expert/src/lib/create-expert-toml.ts:
    • Main Expert template: adds ## Error Handling with formatted error output and no-silent-fail policy
    • Setup Expert template: adds ## Error Handling with failure format and suggestion to run the doctor expert
  • Adds .changeset/add-error-recovery-guidance.md documenting a patch change and the new guidance

Reinforces Design Principle #7: All errors must include "To fix: ..." guidance.

Written by Cursor Bugbot for commit 4f6ebc2. This will update automatically on new commits. Configure here.

Add Error Handling sections to:
- Main Expert Template: standard error format with 'To fix:' guidance
- Setup Expert Template: error handling with doctor expert suggestion

Closes #362
@codecov
Copy link

codecov bot commented Jan 3, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

@FL4TLiN3 FL4TLiN3 merged commit d703bc8 into main Jan 3, 2026
7 checks passed
@FL4TLiN3 FL4TLiN3 deleted the refactor/362-add-error-recovery branch January 3, 2026 06:11
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Refactor: create-expert coordinator lacks error recovery guidance

1 participant