Harness Kit

skill

agent-transcript

Redact and package local agent-session excerpts for PRs, issues, receipts, or review evidence. Use when: "add agent transcript", "attach session proof", "show agent provenance", "redact transcript", "PR transcript". Trigger: /agent-transcript.

/agent-transcript

Source: skills/agent-transcript/SKILL.md

What it does

Redact and package local agent-session excerpts for PRs, issues, receipts, or review evidence. Use when: "add agent transcript", "attach session proof", "show agent provenance", "redact transcript", "PR transcript". Trigger: /agent-transcript.

Workflow role

Support primitive in the Harness Kit operating loop.

Source contract preview

This generated excerpt gives readers the beginning of the live primitive contract before they jump to GitHub.

Package agent provenance without leaking the session.

Inspired by Peter Steinberger's `agent-transcript` contract: transcript
evidence is useful only when it is scoped, redacted, optional, and reviewable
before it leaves the machine.

## Contract

- Never upload raw logs.
- Never include system/developer prompts, raw tool output, secrets, cookies,
  auth URLs, broad local paths, or environment dumps.
- Ask before adding transcript evidence to a public PR or issue body.
- Fail closed when unresolved secrets remain.
- Keep only user intent, assistant-visible decisions, terse tool summaries,
  commands/tests run, and proof outcomes.
- Scope excerpts to the current PR/issue/branch/ticket; omit unrelated turns.
- Use a collapsed `<details>` block with stable markers so reruns update rather
  than duplicate the section.
- Best effort only: PR/issue creation continues when no safe transcript exists.

## Delegation Floor

Rendering a scoped transcript preview is usually mechanical and may run direct
solo. Delegation floor applies when transcript evidence requires substantive
provenance judgment, redaction-risk review, public wording choices, or
conflicting session narratives: probe the roster first; dispatch two or more
providers; direct solo only for mechanical, emergency, user-forbidden, or
fewer-than-two-providers cases. See `harnesses/shared/AGENTS.md` (Roster).

Local lane guidance: Use specialized lanes for scope selector,
redaction-risk critic, provenance reviewer, and public-copy reviewer. Never
send raw transcripts to provider lanes; give rendered excerpts or sanitized
artifact refs only.

## Helper

Use the self-contained redactor for local previews:

```bash
python3 skills/agent-transcript/scripts/agent_transcript.py render \
  --input /path/to/session.log \
  --title "Agent Transcript" \
...

What to verify