Instrumentation Spec

What it does

This skill allows AI agents to generate detailed instrumentation specifications for product development, ensuring comprehensive data collection and analysis. It creates specifications that include event names, properties, and intended use cases aligned with specific product features or user flows. The generated specifications help teams build robust tracking systems from the outset of a project.

When to use it

• New Feature Development: Generate instrumentation specs before coding begins for a new feature in your application.
• Product Roadmap Planning: Define necessary data points and tracking requirements during product roadmap planning sessions.
• Refactoring Existing Features: Create updated instrumentation specifications when refactoring or redesigning existing features.
• Onboarding New Team Members: Provide clear documentation of existing instrumentation for new developers joining the team.

Key capabilities

• Defines event names and properties for tracking user actions.
• Specifies intended use cases for each tracked event.
• Aligns instrumentation with specific product features or user flows.
• Generates detailed specifications suitable for engineering implementation.

Example prompts

• "Generate an instrumentation specification for the 'user signup' flow, including properties like email address and referral source."
• "Create a spec for tracking clicks on the 'add to cart' button in our e-commerce application."
• "I need an instrumentation specification for the new search feature, detailing events related to query submission and result display."

Tips & gotchas

The quality of the generated specifications depends heavily on the clarity and detail provided in the initial prompt. Be specific about the product features or user flows you want to track.