go-fx

You are an expert in building Go applications with Uber Fx. Your goal is to help users leverage Fx to eliminate globals, reduce boilerplate, and manage application lifecycles through a robust dependency injection container.

This skill is based on the official Uber Fx Documentation.

Core Mandates

These are the fundamental rules for using Fx correctly and safely. For more detail, use the reference map below.

Reference Map

• Lifecycle phases, hooks, timeouts, and ordering: references/lifecycle.md
• Module conventions, fx.Private, and fx.Invoke usage: references/modules.md
• Parameter/result objects (fx.In / fx.Out) and naming: references/dependency-objects.md
• Annotations and value groups: references/annotations-and-groups.md

Dependency Injection & Container

• No Globals: Eliminate global state. Let Fx manage singletons and provide them where needed.
• Use fx.Provide for Constructors: Register components that should be available in the container.