Skip to content

feat: ship log — persistent record of /ship runs#632

Open
sternryan wants to merge 1 commit intogarrytan:mainfrom
sternryan:feat/ship-log
Open

feat: ship log — persistent record of /ship runs#632
sternryan wants to merge 1 commit intogarrytan:mainfrom
sternryan:feat/ship-log

Conversation

@sternryan
Copy link
Copy Markdown

Summary

  • Adds Step 8.8: Ship Log to the /ship workflow template (ship/SKILL.md.tmpl)
  • After every /ship run completes, appends a structured JSON entry to ~/.gstack/ship-log.json with version, date, branch, base branch, PR URL, review findings count, and test pass/fail status
  • Enables /retro to track shipping velocity, review finding rates, and test health over time
  • Addresses P2 TODO item: "Ship log — persistent record of /ship runs"

Entry format

{
  "version": "0.x.y.z",
  "date": "2026-03-29T...",
  "branch": "feat/foo",
  "baseBranch": "main",
  "prUrl": "https://github.com/...",
  "reviewFindings": 3,
  "testsRan": true,
  "testsPassed": true
}

Test plan

  • bun run gen:skill-docs regenerates ship/SKILL.md and .factory/skills/gstack-ship/SKILL.md successfully
  • bun test test/skill-validation.test.ts test/gen-skill-docs.test.ts passes (601 pass, 0 fail)
  • Manual: run /ship on a feature branch and verify ~/.gstack/ship-log.json is created with correct entry
  • Manual: run /ship again and verify the entry is appended (array grows)
  • Manual: run /retro and verify it can read the ship log data

Adds Step 8.8 to the /ship workflow that appends a structured JSON entry
to ~/.gstack/ship-log.json after every ship completes. Tracks version,
branch, PR URL, review findings, and test results so /retro can report
shipping velocity over time.

Addresses P2 TODO: "Ship log — persistent record of /ship runs"
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant