[object Object]

← back to Cli Printing Press

fix(skills): archive manuscripts unconditionally after shipcheck, not inside publish gate (#80)

1f918585d634287f19c9e99cc0afd13102ca081c · 2026-03-30 18:22:21 -0700 · Trevin Chow

Previously the archive step was inside Phase 6 (Publish) which was gated
by the shipcheck verdict. A run that reached shipcheck but didn't proceed
to publish (e.g., the user wanted to test something else) would lose its
research and proofs — future runs couldn't reuse them.

Now archiving is Phase 5.5, running unconditionally after shipcheck or
live smoke. Even a "hold" verdict preserves research for future runs.
Publishing remains gated by ship/ship-with-gaps as before.

Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Files touched

Diff

commit 1f918585d634287f19c9e99cc0afd13102ca081c
Author: Trevin Chow <trevin@trevinchow.com>
Date:   Mon Mar 30 18:22:21 2026 -0700

    fix(skills): archive manuscripts unconditionally after shipcheck, not inside publish gate (#80)
    
    Previously the archive step was inside Phase 6 (Publish) which was gated
    by the shipcheck verdict. A run that reached shipcheck but didn't proceed
    to publish (e.g., the user wanted to test something else) would lose its
    research and proofs — future runs couldn't reuse them.
    
    Now archiving is Phase 5.5, running unconditionally after shipcheck or
    live smoke. Even a "hold" verdict preserves research for future runs.
    Publishing remains gated by ship/ship-with-gaps as before.
    
    Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 skills/printing-press/SKILL.md | 33 ++++++++++++++++++++-------------
 1 file changed, 20 insertions(+), 13 deletions(-)

diff --git a/skills/printing-press/SKILL.md b/skills/printing-press/SKILL.md
index 750fa0ae..6ed1e4dd 100644
--- a/skills/printing-press/SKILL.md
+++ b/skills/printing-press/SKILL.md
@@ -1483,21 +1483,16 @@ Write:
 
 `$PROOFS_DIR/<stamp>-fix-<api>-pp-cli-live-smoke.md`
 
-## Phase 6: Publish
-
-After the final phase completes (Phase 4 if no live smoke, Phase 5 if it ran), archive the run artifacts and offer to publish the CLI to the library repo.
+## Phase 5.5: Archive Manuscripts
 
-### Gate
+Archive the run's research, proofs, and discovery artifacts to `$PRESS_MANUSCRIPTS/`
+**unconditionally** after shipcheck completes (or after live smoke if it ran). This
+happens regardless of the shipcheck verdict — even a `hold` run produces research
+and proofs that future runs should be able to reuse.
 
-Use the most recent shipcheck verdict:
-- if Phase 5 reran shipcheck after a live-smoke fix, use that rerun verdict
-- otherwise use the Phase 4 verdict
-
-Skip this phase entirely if the final shipcheck verdict is `hold`. Only proceed for `ship` or `ship-with-gaps`.
-
-### Archive manuscripts
-
-The run's research, proofs, and discovery artifacts are in `$API_RUN_DIR/` (runstate). The `publish package` command looks for them at `$PRESS_MANUSCRIPTS/<api>/<run-id>/`. Archive them now so they're available whether the user publishes immediately or later.
+Archiving and publishing are separate concerns. Archiving preserves research for
+future `/printing-press` runs on the same API. Publishing ships the CLI to the
+library repo. A run that isn't ready to publish still produces valuable research.
 
 ```bash
 mkdir -p "$PRESS_MANUSCRIPTS/<api>/$RUN_ID"
@@ -1516,6 +1511,18 @@ if [ -d "$DISCOVERY_DIR" ]; then
 fi
 ```
 
+## Phase 6: Publish
+
+After archiving, offer to publish the CLI to the library repo.
+
+### Gate
+
+Use the most recent shipcheck verdict:
+- if Phase 5 reran shipcheck after a live-smoke fix, use that rerun verdict
+- otherwise use the Phase 4 verdict
+
+Skip this phase entirely if the final shipcheck verdict is `hold`. Only proceed for `ship` or `ship-with-gaps`.
+
 ### Check for existing PR
 
 Run a lightweight check for your own open publish PR. The `--author @me` filter avoids matching someone else's PR for the same CLI name.

← fba41deb fix(cli): generator improvements from postman-explore retro  ·  back to Cli Printing Press  ·  fix(skills): improve retro skill prioritization and skip/do 64ded0ae →