# HyperTwist Phase S6-B First-Party Usage And Operations Audit Skills Preparation Packet

Date: 2026-05-31
Owner lane: `lane/skillization/provider-ops`
Owner features:
- `feature/skills/audit-provider-usage`
- `feature/skills/inspect-provider-topology`
- `feature/skills/diagnose-route-service`

## Scope

Land the bounded first-party provider/ops audit layer for:
- `audit-provider-usage`
- `inspect-provider-topology`
- `diagnose-route-service`

These skills sit above the already landed provider-neutral speech/provider
runtime seams, the landed `S6-A` provider-profile/routing skills, and the
existing normalized first-party usage/cost and operator-shell source surfaces.

## Authority Basis

- `A`: first-party provider-neutral speech/provider runtime and contract surfaces
- `R`: landed `Phase 6R-Y`, `Phase 6R-Z`, `Phase 6R-AA`, and `Phase 6R-AB`
  packets
- `F`: skillization doctrine `S6-B` outputs and acceptance gate

## First-Party Dependencies

- skill registry/control/audit/authoring substrate
- landed `S6-A` provider-profile/routing skill state
- first-party usage/cost accounting profile definitions
- first-party normalized usage and normalized cost event templates/state
- first-party quota/rate-limit state
- first-party provider route-decision and service-health state
- first-party provider usage/cost dashboard, history/export, receipt-review,
  billing-settlement, and settlement-exception shell profiles

## UI / Settings Exposure

- stays in `skill-group/provider-operations`
- remains optional-assistive, installed-when-disabled, and inert-when-disabled
- introduces no new settlement execution or provider-portal action surface

## Audit / Provenance

- invocation-ledger required for all three skills
- produced artifacts:
  - `artifact/provider-usage-audit-brief`
  - `artifact/provider-topology-inspection-brief`
  - `artifact/provider-route-service-diagnostic-brief`

## Validation Plan

- registry/family/status count update
- control-state visibility update
- audit-ledger invocation update
- authoring/eval contract coverage update
- focused `Phase S6-B` state and serialization tests

## Off-State Behavior

- skills remain visible and opt-in by default
- disabling the skills leaves provider runtime and accounting ownership unchanged
- no provider account mutation, settlement execution, or portal widening occurs

## Acceptance Gates

- provider skills read normalized first-party state
- first-party accounting ownership remains preserved
- usage/cost audit remains bounded to already landed source surfaces
- route/service diagnostics remain separate from settlement execution widening
- provider-specific overlays and portal-driven actions remain out of scope

## Non-Goals

- billing-settlement execution
- provider portal operations
- provider-specific overlay/dashboard widening
- active secret mutation or external account administration
