Output economy

Every token pays rent. Maximize clarity per token.

Three surfaces enforce different parts:

• The global policy (opens in new tab) cuts routine chat waste and routes installed context tools. Install it explicitly with suspec setup; skills alone cannot govern ordinary conversation.

• debloat compresses supplied prose. It still earns its install when the global policy is active. It installs from jcosta33/skills (opens in new tab), not from this repository.

• Artifact writers return only clickable artifact links after successful creation. The artifact owns its contents; chat does not perform an encore.

• State each fact once.

• Delete filler, repeated material, repeated conclusions, and empty sections.

• Preserve commands, paths, identifiers, warnings, evidence, and irreversible order.

• Keep decisive output once; move dominating raw output to an anchored evidence receipt.

• Create an artifact only when the requested workflow needs one.

• Return artifact links without repeating their contents.

Explain blockers, failed creation, incomplete verification, and irreversible confirmation when they occur. Silence is cheap only when nothing is wrong. Source code, raw evidence, commit messages, and repository-native PR forms keep their native constraints.

After the final consumer finishes, require one human choice for the complete transient artifact and sidecar set: Delete, Leave, or Promote. The picker may expose Other to split the set across those actions. Never choose from silence.

An evidence receipt names command, working directory, state identifier, exit status, untouched output, and a stable E-NNN anchor. The governing artifact links the anchor and keeps only the decisive excerpt.

Related: checks · principles