Step 1: Identify the Issue Early
Look for signals: missed deadlines, unclear communication, or scope drift.
Raise it quickly: the sooner you flag an issue, the easier it is to resolve.
Step 2: Communicate Directly
Message the developer first: many problems are misunderstandings that can be cleared up quickly.
Be specific: share what’s not working, why it’s a concern, and what you’d like to see instead.
Stay professional: constructive feedback leads to better outcomes than frustration.
Step 3: Revisit Scope & Expectations
Check your contract: scope, hours, and deliverables should be clear in your agreement with the developer.
Agree adjustments: if scope has changed, update expectations and timelines together.
Use milestones: breaking work into smaller steps helps get things back on track.
Step 4: Use Moonlight Support if Needed
Reach out through the chat: if direct communication doesn’t solve the problem, contact Moonlight support.
Mediation help: we can guide conversations, suggest next steps, or connect you to third-party mediation if needed.
Payment protection: disputes over invoices are handled case by case — raise questions before approving an invoice.
Step 5: Decide on Next Steps
Adjust and continue: most projects can be salvaged with clearer expectations.
End the engagement: if it’s not a fit, you can stop the project once current invoices are settled.
Post a new job: start fresh with another developer if needed.
Best Practices
Trial first: use a short trial project to test fit before committing to larger scope.
Regular check-ins: short weekly updates help prevent surprises.
Document agreements: keep messages, specs, and deliverables documented in case you need to reference them later.
FAQs
What if I’ve already approved an invoice for unsatisfactory work?
Once an invoice is approved, payment is processed. In rare cases, Moonlight may help mediate a refund, but always raise issues before approval.
Can Moonlight force a developer to redo work?
No. Moonlight doesn’t manage developer output directly. Issues should be addressed in your contract and through communication.
What happens if we end a project early?
You’ll only be responsible for paying for hours worked up to that point. Any future scope or budget should be renegotiated in a new job post.