Create Status Surface

---
name: create-status-surface
description: >
  Create receipt-backed status surfaces and Tau DAG handoff contracts from local
  progress, gate, and checker receipts. Use when a workflow needs a global
  progress bar, evidence status board, local readiness surface, or robust Tau
  connection without claiming provider readiness or live completion.
triggers:
  - create status surface
  - status surface
  - global progress bar
  - receipt-backed progress
  - render progress receipt
  - tau status handoff
  - tau dag status surface
provides:
  - status-surface
  - receipt-backed-progress
  - tau-dag-status-contract
  - progress-tracking
composes:
  - tau
  - agentic-evals
complies:
  - best-practices-skills
  - best-practices-python
runtime_self_improvement: basic
taxonomy:
  - validation
  - orchestration
  - progress-tracking
  - evidence
disciplines:
  - observability-operations
  - agentic-orchestration
---

# Create Status Surface

Build local, receipt-backed status surfaces from machine-readable progress
artifacts. The skill is reusable across pipelines because it treats receipts as
source truth and renders derived surfaces only.

Default input:

```text
persona_dream.global_progress.v1
```

Outputs:

```text
status_surface.json
status_surface.html
status_surface_receipt.json
tau_status_surface_dag_contract.v1.json
tau_status_surface_dag_validation_receipt.json
```

## Hard Boundary

This skill never upgrades a local progress rollup into:

```text
provider readiness
manual acceptance
paid-call authorization
live provider submission
live Tau DAG execution
visual quality acceptance
```

It may create a Tau DAG contract for inspection or local orchestration handoff,
but that contract is not a Tau execution receipt.

## Commands

```bash
skills/create-status-surface/run.sh render \
  --input /path/to/global_progress.v1.json \
  --output-dir /tmp/status-surface \
  --title "Persona Dream"

skills/create-status-surface/run.sh validate \
  --surface /tmp/status-surface/status_surface.json \
  --receipt-out /tmp/status-surface/status_surface_validation_receipt.json

skills/create-status-surface/run.sh tau-dag \
  --surface-receipt /tmp/status-surface/status_surface_receipt.json \
  --output /tmp/status-surface/tau_status_surface_dag_contract.v1.json

skills/create-status-surface/run.sh tau-check \
  --dag /tmp/status-surface/tau_status_surface_dag_contract.v1.json \
  --receipt-out /tmp/status-surface/tau_status_surface_dag_validation_receipt.json

skills/create-status-surface/run.sh tau-doctor \
  --receipt-out /tmp/status-surface/tau_doctor_receipt.json
```

Run local sanity:

```bash
skills/create-status-surface/sanity.sh
```

## Tau Connection Rules

- Use `skills/tau/run.sh doctor` for non-mutating Tau wrapper connectivity.
- Generate `tau.dag_contract.v1` with explicit `goal_hash`, nodes, edges,
  terminal human node, limits, required evidence, and fail-closed invariants.
- Use `executor: local` for local status-surface commands and `executor: human`
  for the terminal boundary.
- Do not use `executor: provider`.
- Do not claim Tau execution unless a separate Tau DAG receipt exists.
- Do not create GitHub, provider, Herdr, or browser mutation claims from this
  skill.

## Proof Standard

For reports, include:

```text
mocked: no
live: no for local fixture rendering
actual_provider_call_attempts: 0
live_tau_dag_execution_started: false
```

`tau-doctor` is live only in the narrow sense that it invokes the local Tau
wrapper; it is still non-mutating and does not prove provider execution.