docs-outboxlisted
Install: claude install-skill Smart-AI-Memory/attune-ai
# Docs Outbox
**IMPORTANT: Start your response by telling the user:** you are
running the docs-outbox sweep — it composes a digest for approval
and never ships anything on its own.
## What It Does
Small docs artifacts (lessons, roundtable reports, process drafts,
plans) land as per-artifact timestamped files in
`~/.attune/docs-outbox/` instead of shipping as their own PRs.
This skill runs the curating sweep: dedupe, lint, core-worthy
flagging, ONE digest — then the chair approves via chip before a
single batched PR opens. `decisions.md` rulings and spec status
flips NEVER route here; they merge now (R2).
Invariants:
- No auto-shipping — the chair (or their chip-spawned session)
approves the digest before any PR opens (R4).
- One swept PR per approval, auto-merge, containing every clean
artifact in timestamp order.
- Artifacts with lint issues stay in the outbox untouched.
## Step 1 — status
Version preflight first: if `python -m attune.docs_outbox status`
fails with "No module named attune.docs_outbox", the installed
`attune-ai` wheel predates this module — upgrade it
(`pip install --upgrade attune-ai`) before continuing rather than
working around it with PYTHONPATH.
Run `python -m attune.docs_outbox status`. If the outbox is empty,
say so and stop. If the status line says STALE (oldest 2+ days),
surface the warning prominently.
## Step 2 — sweep
Run `python -m attune.docs_outbox sweep` from the repo root and
show the digest to the user verbatim (it is one scree