Skip to content

Commit 98689a0

Browse files
committed
docs(ship): regenerate tool metadata in Phase A; drop the actionlint comment with no command
1 parent 1b59bc4 commit 98689a0

1 file changed

Lines changed: 3 additions & 5 deletions

File tree

‎.agents/skills/ship/SKILL.md‎

Lines changed: 3 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -49,10 +49,10 @@ When the user runs `/ship`:
4949
- `bun run check:migrations origin/staging` must pass (staging is the PR base). Do not silence a flagged statement with a `-- migration-safe:` annotation unless `/db-migrate` confirmed the old code no longer depends on it; otherwise split the destructive change into a later deploy.
5050
6. **Run pre-ship checks** from the repo root before staging. This has two phases: first **regenerate** every committed artifact so generated files never drift into a CI failure (this is what catches things like `agent-stream-docs` going stale after a `models.ts` edit), then run the **full audit suite** CI's `lint` job enforces. Both phases parallelize — but only across commands that write **disjoint** outputs — and a bare `wait` swallows child exit codes, so both phases below explicitly collect each job's status and abort ship if any failed.
5151
52-
**Phase A — regenerate the always-in-repo committed artifacts (parallel), then let step 7 stage whatever changed.** Regenerate only the generators whose inputs live entirely in this repo and that any ordinary code change can drift — `generate:agent-stream-docs` (derives from the provider model registry), `generate:docs-manifest` (derives from docs page paths), and `skills:sync` (derives from `.agents/skills/**`). They write disjoint outputs (`apps/docs/…/agent.mdx`, `apps/sim/lib/mothership/generated/docs-manifest.ts`, and `.claude/skills` links), so they parallelize safely, and each is idempotent (a no-op when already in sync):
52+
**Phase A — regenerate the always-in-repo committed artifacts (parallel), then let step 7 stage whatever changed.** Regenerate only the generators whose inputs live entirely in this repo and that any ordinary code change can drift — `generate:agent-stream-docs` (derives from the provider model registry), `generate:docs-manifest` (derives from docs page paths), `generate:tool-metadata` (derives from the tool registry), and `skills:sync` (derives from `.agents/skills/**`). They write disjoint outputs (`apps/docs/…/agent.mdx`, `apps/sim/lib/mothership/generated/docs-manifest.ts`, `apps/sim/tools/generated/*`, and `.claude/skills` links), so they parallelize safely, and each is idempotent (a no-op when already in sync):
5353
```bash
5454
rm -f /tmp/ship-gen-results
55-
for g in generate:agent-stream-docs generate:docs-manifest skills:sync; do
55+
for g in generate:agent-stream-docs generate:docs-manifest generate:tool-metadata skills:sync; do
5656
( bun run "$g" >"/tmp/ship-gen-${g//:/-}.log" 2>&1; echo "$? $g" >>/tmp/ship-gen-results ) &
5757
done
5858
wait
@@ -77,9 +77,7 @@ When the user runs `/ship`:
7777
}
7878
# Runs every audit CI runs, concurrently, and replays the output of any that fail.
7979
# The audit list is derived in scripts/run-audits.ts — do not hand-list audits here.
80-
# Install CI's pinned actionlint version for the host OS/architecture and verify its
81-
# artifact against the official release checksums in a local mktemp directory.
82-
# Preserve CI's -shellcheck= -pyflakes= flags; lint all workflows and abort ship if it fails.
80+
# Workflow lint (actionlint) runs only in CI's "Lint workflows" step.
8381
bun run check:audits || { echo "❌ audit(s) failed — do not ship"; exit 1; }
8482
bun run type-check || { echo "❌ type-check failed — do not ship"; exit 1; }
8583
# CI's "Security audit" `bun audit` step is `continue-on-error` — advisory only, not a gate —

0 commit comments

Comments
 (0)