skill.yaml

schema: silver/skill/v2
id: measure
version: 0.9.1
summary: Determine whether a shipped design or product change achieved its
  intended outcome.
context_budget: medium
inputs:
  - kind: design-specification
    required: false
    role: working
  - kind: implementation
    required: false
    role: working
  - kind: evaluation
    required: false
    role: working
  - kind: finding
    required: false
    role: working
  - kind: product
    required: false
    role: canonical
outputs:
  - kind: measurement
    scope: product
    path_pattern: design/work/measurements/**
    authority: project-owned
capabilities:
  required:
    - repository
  optional:
    - capability: product-analytics
      providers: []
      fallback: degraded
      description: Use product-analytics when configured; preserve explicit
        fallback coverage otherwise.
effects:
  - capability: repository
    actions:
      - read
      - inspect
    paths:
      - design/**
      - prototypes/**
      - presentations/**
      - production/**
      - .silver/**
  - capability: repository
    actions:
      - create
      - write
      - update
    paths:
      - design/work/measurements/**
  - capability: product-analytics
    actions:
      - read
      - inspect
    external: true
guardrails:
  - authority-respected
  - effects-declared
  - no-silent-mutation
  - revision-pinned
  - followups-recommended-only
  - privacy-sanitized-evidence
  - no-fabricated-evidence
  - provenance-required
completion:
  invariants:
    - metrics-tied-to-hypothesis
    - instrumentation-stated
    - data-limits-recorded
  quality_criteria:
    - id: task-quality
      description: Observed outcomes stay traceable to the success criteria they
        test, with instrumentation and data limits stated rather than implied.
      evaluation: human
  unresolved_questions: block-handoff
  review:
    required: true
    reviewer: human
    checkpoint: Review and accept the result before a readiness-gated handoff.
checks:
  - id: contract-integrity
    required: true
    blocks: &a1
      - synthesize
  - id: evidence-provenance
    required: true
    blocks: *a1
handoffs:
  - id: measure-to-synthesize
    target: synthesize
    readiness: synthesize
    requires:
      - measurement
external_effects:
  - none
scripts:
  - id: invoke
    path: scripts/invoke.mjs
    purpose: Run this skill through the shared guarded invocation runtime.
recommend_after: *a1