ship

Files (200)

• SKILL.md
• README.md · parts/changelog-generator/
• SKILL.md · parts/changelog-generator/
• sample_git_log.txt · parts/changelog-generator/assets/
• changelog-formatting-guide.md · parts/changelog-generator/references/
• ci-integration.md · parts/changelog-generator/references/
• hotfix-procedures.md · parts/changelog-generator/references/
• monorepo-strategy.md · parts/changelog-generator/references/
• commit_linter.py · parts/changelog-generator/scripts/
• generate_changelog.py · parts/changelog-generator/scripts/
• version_bumper.py · parts/changelog-generator/scripts/
• LICENSE.txt · parts/cloudflare-deploy/
• SKILL.md · parts/cloudflare-deploy/
• openai.yaml · parts/cloudflare-deploy/agents/
• cloudflare-small.svg · parts/cloudflare-deploy/assets/
• cloudflare.png · parts/cloudflare-deploy/assets/
• README.md · parts/cloudflare-deploy/references/agents-sdk/
• api.md · parts/cloudflare-deploy/references/agents-sdk/
• configuration.md · parts/cloudflare-deploy/references/agents-sdk/
• gotchas.md · parts/cloudflare-deploy/references/agents-sdk/
• patterns.md · parts/cloudflare-deploy/references/agents-sdk/
• README.md · parts/cloudflare-deploy/references/ai-gateway/
• configuration.md · parts/cloudflare-deploy/references/ai-gateway/
• dynamic-routing.md · parts/cloudflare-deploy/references/ai-gateway/
• features.md · parts/cloudflare-deploy/references/ai-gateway/
• sdk-integration.md · parts/cloudflare-deploy/references/ai-gateway/
• troubleshooting.md · parts/cloudflare-deploy/references/ai-gateway/
• README.md · parts/cloudflare-deploy/references/ai-search/
• api.md · parts/cloudflare-deploy/references/ai-search/
• configuration.md · parts/cloudflare-deploy/references/ai-search/
• gotchas.md · parts/cloudflare-deploy/references/ai-search/
• patterns.md · parts/cloudflare-deploy/references/ai-search/
• README.md · parts/cloudflare-deploy/references/analytics-engine/
• api.md · parts/cloudflare-deploy/references/analytics-engine/
• configuration.md · parts/cloudflare-deploy/references/analytics-engine/
• gotchas.md · parts/cloudflare-deploy/references/analytics-engine/
• patterns.md · parts/cloudflare-deploy/references/analytics-engine/
• README.md · parts/cloudflare-deploy/references/api-shield/
• api.md · parts/cloudflare-deploy/references/api-shield/
• configuration.md · parts/cloudflare-deploy/references/api-shield/
• gotchas.md · parts/cloudflare-deploy/references/api-shield/
• patterns.md · parts/cloudflare-deploy/references/api-shield/
• README.md · parts/cloudflare-deploy/references/api/
• api.md · parts/cloudflare-deploy/references/api/
• configuration.md · parts/cloudflare-deploy/references/api/
• gotchas.md · parts/cloudflare-deploy/references/api/
• patterns.md · parts/cloudflare-deploy/references/api/
• README.md · parts/cloudflare-deploy/references/argo-smart-routing/
• api.md · parts/cloudflare-deploy/references/argo-smart-routing/
• configuration.md · parts/cloudflare-deploy/references/argo-smart-routing/
• gotchas.md · parts/cloudflare-deploy/references/argo-smart-routing/
• patterns.md · parts/cloudflare-deploy/references/argo-smart-routing/
• README.md · parts/cloudflare-deploy/references/bindings/
• api.md · parts/cloudflare-deploy/references/bindings/
• configuration.md · parts/cloudflare-deploy/references/bindings/
• gotchas.md · parts/cloudflare-deploy/references/bindings/
• patterns.md · parts/cloudflare-deploy/references/bindings/
• README.md · parts/cloudflare-deploy/references/bot-management/
• api.md · parts/cloudflare-deploy/references/bot-management/
• configuration.md · parts/cloudflare-deploy/references/bot-management/
• …and 140 more

SKILL.md (first lines)

# ship — delivering and maintaining releases

> Home branch in Memora: `root/skill/ship`.
>
> Safety rail across every part: publishing, tagging and deploying are separate
> authorizations. A part may prepare everything and still stop before the public
> action.

## Choosing a part

**Releasing and dependencies**

| Part | What it covers |
|---|---|
| `parts/release/` | Prepare a named version: preflight, version consistency, build/package, smoke test, checksums and notes — stops before any public release action |
| `parts/dependency-auditor/` | Audit dependencies across multi-language projects: vulnerabilities, licenses |
| `parts/dependency-update/` | Scoped dependency updates: release notes first, explicit scope only, no update-everything |
| `parts/env-secrets-manager/` | Environment-variable hygiene and secrets safety, local to production |

**Deploys**

| Part | What it covers |
|---|---|
| `parts/cloudflare-deploy/` | Workers, Pages, D1/R2, wrangler flows and Workers compatibility checks |
| `parts/vercel-deploy/` | Vercel projects, environment variables, build settings and preview deployments |

**VCS and change tracking**

| Part | What it covers |
|---|---|
| `parts/git/` | Git mechanics on top of `BOOT.md` §6: conventional commits, branch naming, staging hygiene |
| `parts/git-worktree-manager/` | Parallel feature work via worktrees: branch isolation, safe cleanup |
| `parts/github-actions-docs/` | Workflow syntax, caching, matrices, common gotchas |
| `parts/gh-fix-ci/` | Read a failing check, reproduce it, repair the cause |
| `parts/gh-address-comments/` | Work through review comments on a PR without losing the thread |
| `parts/changelog-generator/` | Release notes from conventional commits |
| `parts/tc-tracker/` | Technical-change records as Memora nodes: what, why, tested how, where work stands |
| `parts/tech-debt-tracker/` | Scan for debt, prioritize it, and keep the backlog in Memora across snapshots |

**Operations**

| Part | What it covers |
|---|---|
| `parts/runbook-generator/` | Operational runbooks from a service name: deploy, incident response, maintenance |

## Rules

- **Commit and push rules live in `BOOT.md` §6.** `parts/git/` adds mechanics
  (conventional subjects, branch names, staging hygiene) and never overrides the
  runbook; push, deploy, PR and tag need the owner's word, one action each.
- **Release covers both worlds.** Our projects publish through
  the project's own publish procedure (subtree split into their own repository); an outside
  package follows its registry flow. `parts/release/` names which path applies
  before it starts.
- **Trackers write to Memora.** A technical change and a debt item are nodes
  under `root/project/<name>` (or `root/skill/ship` for workspace-wide work);
  the JSON/Markdown registries of the old parts are not the source of truth, and
  the retired `docs/` layer is never recreated.
- **Large parts are read by section.** `cloudflare-deploy` alone is 2.1 MB: open
  the section the task needs, never the whole tree, and never paste it into
  context "for background".
- **Forks worth `ask_questions`**: a version number that is not in the request, a
  dependency bump that changes public behavior, a deploy target, anything paid,
  and any publish or tag. Preparation is silent, publication is not.
- **Secrets** never appear in logs, commits or chat; key names live in `TOOLS.md`.

## Related

`dev` (writing the code), `loops` (unattended work never deploys), `review`
(`verify`), `mcp` (tool surface for CI and repositories).

From youlianvr/oper-share, CC-BY-4.0.

More from youlianvr/oper-share