[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7CEGXP29XZACB0QG7DX496R":3,"skill-same:01M7CEGXP29XZACB0QG7DX496R":48},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":26,"commitSha":27,"skillDirectory":28,"forksCount":29,"repositoryHtmlUrl":30,"repositoryHomepageUrl":31,"ownerHtmlUrl":32,"ownerBlogUrl":33,"ownerDescription":6,"updatedAt":34,"install":35,"resources":47},"01M7CEGXP29XZACB0QG7DX496R","prepare-release",null,"Prepare an alchemy release by converging the live test suite — nuke + clear:state the testing account, run every test through a tag-driven `--plan` (unit → per-provider live in parallel → local), triage failures as they stream in, fan out one fix agent per failing\u002Fleaking service, census leaks, and loop until two consecutive rounds are green and clean. Fixes land as one alchemy PR plus at most one distilled PR and one floci PR. Use for \"prepare a release\", \"\u002Fprepare-release\", \"release hardening run\", \"run the full suite before release\", optionally scoped (\"\u002Fprepare-release aws cloudflare\"). To harden one provider's suite on its own, use the harden skill.","systemfsoftware\u002Fomp-claude-compat","systemfsoftware","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F172220390?v=4","01M77N4P2T87WAH2KS0GYARYP3","System F Software","01M7CE0NBB6F9ERJWXRMT8CJ27",2,"Apache-2.0","https:\u002F\u002Fgithub.com\u002Fsystemfsoftware\u002Fomp-claude-compat\u002Fblob\u002Fmain\u002Frepos\u002Falchemy\u002F.agents\u002Fskills\u002Fprepare-release\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: prepare-release\ndescription: Prepare an alchemy release by converging the live test suite — nuke + clear:state the testing account, run every test through a tag-driven `--plan` (unit → per-provider live in parallel → local), triage failures as they stream in, fan out one fix agent per failing\u002Fleaking service, census leaks, and loop until two consecutive rounds are green and clean. Fixes land as one alchemy PR plus at most one distilled PR and one floci PR. Use for \"prepare a release\", \"\u002Fprepare-release\", \"release hardening run\", \"run the full suite before release\", optionally scoped (\"\u002Fprepare-release aws cloudflare\"). To harden one provider's suite on its own, use the harden skill.\nmetadata:\n  internal: true\n---\n\n# Prepare a release\n\nThis session is the **coordinator** of the convergence loop in AGENTS.md\n(\"The convergence loop: nuke → test → census → fix-fleet\"). You own the clean\nslate, the test runs, triage, type-checking, the census, and the PRs. Fix\nagents own one service each. The user merges; you never do.\n\nEach provider in scope converges with the **harden** skill\n(`.agents\u002Fskills\u002Fharden\u002FSKILL.md`): its loop, root-cause order, isolation\nrules and the provider-bug patterns it lists all apply here. This skill adds\nthe release-wide pieces around it: the clean slate, the plan across\nproviders, the fix fleet, and the PRs. When the user only asks to harden a\nprovider, use the harden skill instead of this one.\n\nThe arguments name the scope: providers (`aws cloudflare gcp …`) or `all`. With\nno arguments, propose a scope (default: unit + local + every `provider:*` live\ntag) and confirm it together with the nuke in a single question. **Nuking the\ntesting account is destructive — always get an explicit go-ahead first.**\n\n## 0. Preflight\n\nStart from a clean, up-to-date `main` in this worktree, on a fresh branch:\n\n```sh\ngit status                                   # must be clean; never git stash\ngit fetch origin main && git checkout -b release\u002Fprep-$(date +%Y-%m-%d) origin\u002Fmain\ngit submodule update --init -- submodules\u002Fdistilled\npnpm install\nbun --version                                # must be 1.3.13 — 1.4 fails every file at collection\n# if not: mkdir -p \u002Ftmp\u002Fbun1313 && (cd \u002Ftmp\u002Fbun1313 && npm i --no-save bun@1.3.13)\n#         export PATH=\u002Ftmp\u002Fbun1313\u002Fnode_modules\u002F.bin:$PATH   (prefix every pnpm test with this)\nnode -v                                      # alchemy CLI needs >= 24.11.1 and pnpm wants 24.x — node 25\n# makes pnpm print a [WARN] that breaks scripts\u002Fensure-built.ts. If not 24.11+:\n#   mkdir -p \u002Ftmp\u002Fnode24 && (cd \u002Ftmp\u002Fnode24 && npm i --no-save node@24)\n#   export PATH=\u002Ftmp\u002Fnode24\u002Fnode_modules\u002F.bin:$PATH\n# Put these PATH exports + `set -a; source .env; set +a` in \u002Ftmp\u002Frelease\u002Fenv.sh and\n# source it before every command — env doesn't persist between shell calls.\nset -a; source .env; set +a                  # Cloudflare creds (pnpm download:env if missing)\naws sso login                                # AWS live + nuke ride the SSO session\nmkdir -p \u002Ftmp\u002Frelease\npnpm exec tsrs -b                             # REQUIRED before live runs: emits distilled lib\u002F\n```\n\nRuntime bundles (Lambda, Fly, Hetzner, Neon Functions) resolve distilled\npackages through their `lib\u002F` build output, not `src\u002F`. A fresh worktree has\nno `lib\u002F` for most providers, so every deployed runtime would crash at boot\nwith `Cannot find package '@distilled.cloud\u002F…'`.\n\nNever set or unset `CI` for tests (a profile-store migration can wipe\n`~\u002F.alchemy`). If an AWS run fails in ~100ms during setup, the SSO session has\nexpired — re-run `aws sso login`.\n\n## 1. Clean slate\n\n```sh\npnpm nuke --yes --profile testing            # scripts\u002Fnuke.sh requires --profile; no --yes hangs\npnpm clear:state --profile testing --yes --no-input   # prompts without --yes, fails in a non-TTY\npnpm nuke --dry-run --profile testing > \u002Ftmp\u002Frelease\u002Fcensus-0.txt   # baseline; should be residue only\n```\n\nNever run nuke while any suite is running. Holdouts that survive two nuke\npasses are stuck deletes — put that service on the worklist; its delete path is\nthe bug. Documented-undeletable residue (excluded in `scripts\u002Fnuke.sh`, e.g.\n`AWS.BackupSearch.SearchJob`, zone singletons) is not a finding.\n\n## 2. Build the plan and dry-run it\n\nTests carry tags (`unit`, `live`, `local`, `provider:\u003Ccloud>`,\n`provider:\u003Ccloud>:\u003Cservice>`). `--tags` takes expressions with `&&`, `||`, `!`,\nparentheses and `*`; `--plan` takes a JSON array of sequential phases, where a\nnested array runs branches in parallel and **the first matching branch wins**.\nTags listed under `optInTags` only run when named explicitly (wildcards and\nnegations don't count) — never name one without asking; they gate paid add-ons\nand entitlements.\n\nDefault plan (drop providers outside the scope):\n\n```json\n[\n  { \"tags\": [\"unit && !live\"] },\n  [\n    { \"tags\": [\"live && provider:aws\"],        \"concurrency\": 32 },\n    { \"tags\": [\"live && provider:cloudflare\"], \"concurrency\": 16 },\n    { \"tags\": [\"live && provider:gcp\"],        \"concurrency\": 16 },\n    { \"tags\": [\"live && !provider:aws && !provider:cloudflare && !provider:gcp\"], \"concurrency\": 8 }\n  ],\n  { \"tags\": [\"local\"], \"concurrency\": 8 },\n  { \"tags\": [] }\n]\n```\n\n- Phase 1 runs the unit tests first: a broken unit layer makes every live\n  failure noise, so stop and fix it before spending cloud time.\n- The final `[]` branch is the catch-all for untagged tests. Everything it\n  picks up is a tagging gap — add the missing tags in the release PR.\n- Never use `\"unbounded\"` and never exceed 32 per branch. Saturation shows up\n  as hundreds of 0ms `beforeAll` TimeoutErrors; real failures fail slow.\n\nWrite the plan to `\u002Ftmp\u002Frelease\u002Fplan.json` and preview it:\n\n```sh\npnpm test --profile testing --plan \"$(cat \u002Ftmp\u002Frelease\u002Fplan.json)\" --dry-run\n```\n\nFor reference, on 2026-10-09 the default plan selected 11,614 tests in 2,880\nfiles (unit 3,089 · aws 3,361 · cloudflare 1,577 · gcp 2,085 · other live\n811 · local 592 · untagged 99 in 19 files). Collection takes ~10s. Check\nthe branch counts against expectations. A branch with 0 tests is an\ninvocation bug (bad tag, quoting), not a pass. Show the user the preview\nbefore the real run.\n\n## 3. Run it\n\nA full round can outlast a 2-hour background-task limit, so detach it and\nwatch the output file with a monitor that filters to failed results\n(`grep -E \"\\] ✗ |failed to run|^Tests:\"` — a bare `✗` also matches the\n`[n\u002FN ✓ ✗]` progress counter on every line):\n\n```sh\nnohup pnpm test --profile testing --plan \"$(cat \u002Ftmp\u002Frelease\u002Fplan.json)\" \\\n  > \u002Ftmp\u002Frelease\u002Fround-1.out 2>&1 & disown\n```\n\nKeep running notes in `\u002Ftmp\u002Frelease\u002FSTATE.md` (round, blockers, worklist,\nresidue) so the loop survives context compaction.\n\nNote the `Full log: .alchemy\u002Flog\u002Ftest\u002F…` path at the end. Failures print\ninline with their error as soon as they happen, so start triage at the first\nfailure rather than waiting for the run to finish.\n\nTest time is the release's biggest cost, so one slow or exclusive test must\nnever hold up the rest of a run. If it does, fix the runner or narrow the\nlock; don't lower concurrency and don't wait it out. Tests that only contend\nfor a shared cloud resource take a label (`{ exclusive: \"aws:ses-account\" }`)\ninstead of `exclusive: true`, which only process-global state needs. On\n2026-10-31 a writer-preferring `exclusive: true` gate froze the AWS suite\ntwice behind a 25-minute ElastiCache test.\n\n## 4. Triage\n\nGroup failures by their most specific `provider:\u003Ccloud>:\u003Cservice>` tag (the\nservice is the unit of ownership). Classify each:\n\n| Bucket | Signal | Fix lands in |\n| --- | --- | --- |\n| Provider bug | wrong reconcile\u002Fdiff\u002Fdelete, leak, crash | `packages\u002Falchemy\u002Fsrc\u002F…` (alchemy PR) |\n| Untyped error | `Unknown*Error`, out-of-union status error, wrong schema | distilled patch (distilled PR) |\n| Emulator bug | only fails under floci | `submodules\u002Ffloci` (floci PR) |\n| Test bug | non-deterministic or hard-coded name, unbounded wait, missing propagation retry | the test (alchemy PR) |\n| Platform\u002Fentitlement | plan-gated, slow async provisioning, beta API | skipIf-gate on the typed tag + exact error, keep an ungated probe |\n| Flake | passes alone, fails under load | re-run alone and on main first |\n\nRoot-cause priority is **provider bug > distilled patch > test fix**, and a\nlonger timeout comes last, only for work that is slow by nature (image\nbuilds, cold starts). Never paper over a provider leak or untyped error in a\ntest. A failure that only shows up in some runs is usually two runs touching\nthe same cloud object — a shared name or stage, a missing lock label, or a\nretry that leaks — not a flake; see the isolation rules in the harden skill.\nSkip a test only for a permanent account blocker (quota, entitlement), with\n`test.provider.skip` and a comment quoting the exact error. For suspected flakes,\nbuild a verdict table: `Failure | Re-run alone | On main | Verdict`. A failure\nthat also fails on main is still in scope for the release — it just isn't a\nregression.\n\n## 5. Census\n\nAfter the run finishes (and never while one is running):\n\n```sh\npnpm nuke --dry-run --profile testing > \u002Ftmp\u002Frelease\u002Fcensus-1.txt\ndiff \u002Ftmp\u002Frelease\u002Fcensus-0.txt \u002Ftmp\u002Frelease\u002Fcensus-1.txt\n```\n\nEvery new resource is a leak, and a green service can still leak. **Leave the\nleaked resources live** as evidence for the fix agents. The worklist is\nfailing services ∪ leaking services.\n\n## 6. Fix fleet\n\nLaunch one agent per service on the worklist, in parallel. In T3 Code each\nfixer is a detached top-level thread from `t3_thread_launch` with\n`workspaceStrategy: { type: \"existing_worktree\", worktreePath: \u003Cthis worktree> }`,\nnever a `delegate_task` subagent thread. Collect each result with\n`t3_thread_wait` + `t3_thread_read`. Run ~12 at once (\naccount-singleton services like CloudTrail, Config, SecurityHub, GuardDuty,\nControlTower and IdentityCenter run as one sequential chain). Agents work in\nthis worktree and **commit but don't push**; they touch only their service's\nfiles, plus single minimal insertions in shared files. The prompt is a\ncontract — include every item:\n\n1. The service it owns, its directory, and its tag (e.g. `provider:aws:ec2`).\n2. Its exact failures (error text + test names) and its leak inventory from the\n   census diff.\n3. Assess-first: partial work may exist from an interrupted run; finish it\n   rather than rewriting.\n4. Reading list: AGENTS.md Reconciler doctrine + Typed Error Doctrine + speed\n   doctrine, the resource source, the test, and the distilled service +\n   existing patches.\n5. Root-cause priority (provider > distilled > test) and the rule that it\n   never hides a leak in the test.\n6. **No `tsc`, no `pnpm build`, no `pnpm nuke`** — the coordinator owns these.\n7. Speed doctrine: every run is\n   `pnpm test --tags '\u003Cits tag>' --profile testing`; per-test\n   timeouts ≤ 90–120s; every retry bounded (`times ≤ 8–10`, \u003C 60s total);\n   three-iteration budget, then gate and report.\n8. Distilled patches for its service only, regenerated in place:\n   - Cloudflare: `cd submodules\u002Fdistilled\u002Fpackages\u002Fcloudflare && bun scripts\u002Fgenerate.ts --resource \u003Csvc> && pnpm exec oxfmt src\u002Fservices\u002F\u003Csvc>.ts`\n   - AWS: `cd submodules\u002Fdistilled\u002Fpackages\u002Faws && bun scripts\u002Fgenerate.ts --sdk \u003Csvc>`\n   Tests resolve distilled from `src\u002F`, so there's nothing to rebuild or wait for.\n9. Test rules: start and end with `stack.destroy()`, out-of-band verification\n   through distilled, no mocks. Names: let the resource generate the physical\n   name. Only a test about explicitly provided names passes one, and it is\n   derived from `stack.stage` so it is isolated to the user running the test.\n   Never `Date.now()`, UUIDs or random values in a name: every run is\n   deterministic and leaves no orphans. A resource the API can never delete\n   keeps one shared constant name that every run adopts. Fix any hard-coded\n   name you find in the suites you touch.\n10. Done means: its **full** tag passes, and distilled list\u002Fdescribe calls show\n    zero orphans from its service.\n11. Structured result: `{ service, tag, testsPassed, testCommand, rootCause,\n    files, patches (with reasons), skippedTests (with exact errors), leaksFixed,\n    notes }`.\n\nWhile agents run, watch for stalls: a transcript that hasn't been written for\n~5 minutes with no child test process is stalled — `t3_thread_interrupt` it\nand re-dispatch with a new `t3_thread_launch`.\n\nWhen results come in, review each diff yourself before accepting it. Reject\nany that catch a catch-all error, widen a cast, add `Effect.orDie` to a\nlifecycle op, mock a response, or skip a test without a typed reason.\n\n## 7. Gate\n\n```sh\npnpm exec tsrs -b                             # coordinator only, once per round\npnpm docs:check-jsdoc                        # if any props\u002Fattrs changed\n```\n\nFix cross-cutting fallout yourself (`Providers.ts` nested `Layer.mergeAll`\ngroups, barrel conflicts). Commit the round — one commit per service fix,\nconventional-commit scoped (`fix(aws\u002Fec2): …`) — and **push immediately**.\n\n## 8. Loop\n\n**Converge with targeted runs, then confirm with full ones.** Live tests are\nslow, so after the first full plan every fixing run is targeted:\n\n1. **Track passes cumulatively.** Every run (yours and the agents') writes\n   `PASS \u003Cfile> > \u003Ctitle>` lines to `packages\u002Falchemy\u002F.alchemy\u002Flog\u002Ftest\u002F*.log`.\n   Rebuild the passed set from all logs, not just the last round:\n   ```sh\n   cat packages\u002Falchemy\u002F.alchemy\u002Flog\u002Ftest\u002F*.log | grep -E \"^PASS \" \\\n     | sed -E 's\u002F^PASS \u002F\u002F; s\u002F \\([0-9.]+m?s\\).*$\u002F\u002F' | sort -u > \u002Ftmp\u002Frelease\u002Fpassed.txt\n   ```\n2. **Compute the residual:** tests with a `FAIL` line and no `PASS` line, plus\n   tests that never finished (a killed or stalled round) — find those by\n   diffing the run's test list against the result lines.\n3. **Fix agents get each failing area passing individually** (their own\n   suites, `-t` for single tests in long sequential files).\n4. **One residual run** of only what's still unpassed — file paths, narrowed\n   with `-t` where a file is long and sequential (e.g. `Fly\u002FBlueGreen.test.ts`\n   has ~180 tests at ~100s each; never run it unfiltered).\n5. **Confirm stability per provider** with the harden skill's loop: full\n   runs of each provider's suite, a census after each, until two consecutive\n   runs are green and clean. One green run proves little — retry leaks, lagging\n   listings and shared names only show up across runs.\n6. **Finish with nuke + clear:state + census.** The goal is consecutive green\n   runs and a census that shows `Nothing to delete`.\n\nIf a census leftover reappears after nuke, its `list` or `delete` is the bug\n(e.g. `list` returning archived or Cloudflare-managed objects), not the test.\n\nReport each round to the user, briefly:\n\n```md\n### Round N: 1834 passed · 12 failed · 3 leaking services\n\n| Service | Tag | Failure | Bucket | Status |\n| --- | --- | --- | --- | --- |\n| EC2 | provider:aws:ec2 | InternetGateway delete timeout | provider bug | fixed, 63\u002F63 |\n| R2 | provider:cloudflare:r2 | UnknownCloudflareError 10058 | distilled | patched, 30\u002F30 |\n\nNext: round N+1 (full plan).\n```\n\n## 9. PRs\n\nAt most three, one per repo. Open them as soon as there is a first fix, and\npush every later fix promptly.\n\n**distilled** (only if there are patches) — work in a standalone clone, never\na `git worktree add` from inside `submodules\u002Fdistilled` (its `core.worktree`\nbelongs to another checkout):\n\n```sh\ngit clone --reference submodules\u002Fdistilled https:\u002F\u002Fgithub.com\u002Falchemy-run\u002Fdistilled \u002Ftmp\u002Frelease\u002Fdistilled\ncd \u002Ftmp\u002Frelease\u002Fdistilled && git checkout -b fix\u002Frelease-prep-$(date +%Y-%m-%d)\n# copy the patches + regenerated services from submodules\u002Fdistilled, commit per service\n```\n\nTitle: `fix: typed errors and schema fixes from release prep`. The body lists\neach patch with the error it types, e.g. `R2 putBucketLifecycle: code 10058 →\nLifecycleRuleInvalid`.\n\n**floci** (only if emulator fixes are needed) — floci is skipped by default\n(`git submodule update --init --checkout -- submodules\u002Ffloci`); use the same\nstandalone-clone pattern against `https:\u002F\u002Fgithub.com\u002Falchemy-run\u002Ffloci`. If alchemy needs the new emulator image, it needs a release\ntag.\n\n**alchemy** — branch `release\u002Fprep-\u003Cdate>`, title\n`fix: release hardening (\u003Cdate>)`. It contains the provider, test, gating and\ntagging fixes, plus submodule bumps pointing at the distilled\u002Ffloci PR heads.\nThe merge order is distilled → floci → alchemy. After each upstream PR merges,\nrepoint the submodule at its **`main` merge commit** (never a side branch),\nrerun the affected tags, and push.\n\nDescriptions follow AGENTS.md's PR conventions: one plain sentence, then\nuser-facing snippets or a per-service table of what was fixed. No `#`\u002F`##`\nheadings and no test plan. Write the body to a file and pass `--body-file`.\nLink every PR to this thread with the T3 `link_pull_request` tool when it's\navailable. Leave PRs as drafts until the gate passes, then `gh pr ready`.\n\n## 10. Final report\n\nEnd with the merge ask:\n\n```md\n### Release prep converged after N rounds. I recommend merging, in this order:\n\n1. distilled — \u003Cwhat it types>\n   https:\u002F\u002Fgithub.com\u002Falchemy-run\u002Fdistilled\u002Fpull\u002FX\n2. alchemy — \u003CK> service fixes, \u003CG> gated tests, \u003CT> tagging fixes\n   https:\u002F\u002Fgithub.com\u002Falchemy-run\u002Falchemy\u002Fpull\u002FY\n\n| Phase | Tests | Result |\n| --- | --- | --- |\n| unit | 856 | ✅ |\n| live provider:aws | 1662 | ✅ 1650 · 12 skipped (gated) |\n| … | | |\n\nGated (needs entitlement \u002F platform): \u003Ctest → exact error>.\nFails on main too (pre-existing, now fixed): \u003Clist>.\nCensus: clean except \u003Cdocumented residue>.\n```\n\nSay plainly what was **not** run (out-of-scope providers, opt-in tags). Don't\nreport CI status in place of the test results.\n\n## Pitfalls seen in practice\n\n- **Commit with the pinned env sourced.** The pre-commit hook runs pnpm; with\n  the wrong bun\u002Fnode or a stray temp workspace dir under `examples\u002F` (left by\n  a killed test) it re-installs and rewrites `pnpm-lock.yaml`. Never commit\n  the lockfile or Prisma `generated\u002Fcontract.*` churn.\n- **Distilled regeneration can `pnpm install` inside `submodules\u002Fdistilled`**,\n  creating a nested `node_modules` with a second `effect` copy (\"Unable to get\n  redacted value\" everywhere). Move `submodules\u002Fdistilled\u002Fnode_modules` aside\n  and check `packages\u002F*\u002Fnode_modules\u002Feffect` links point at the root store.\n- **Other sessions share the account.** Another worktree's live resources\n  show up in your census; check `ps -eo etime,command | grep alchemy-test`\n  before deleting a leftover you can't trace to your own run. A linked\n  worktree defaults to its own test stage (`test_$USER_\u003Cworktree>`), so two\n  worktrees don't collide; suites that set their own stage must prefix it\n  with `Test.defaultStage()`.\n- **Provider `console.log` doesn't reach the run log.** Debug with\n  `Effect.logInfo`, and probe API behavior with a throwaway test file rather\n  than guessing.\n- **Account blockers are not code.** Billing (GCP), token permission groups\n  (e.g. Cloudflare K2) and retired services (AWS FinSpace) get reported to the\n  user with the exact error; never enable billing or edit shared tokens.\n","# Prepare a release\n\nThis session is the **coordinator** of the convergence loop in AGENTS.md\n(\"The convergence loop: nuke → test → census → fix-fleet\"). You own the clean\nslate, the test runs, triage, type-checking, the census, and the PRs. Fix\nagents own one service each. The user merges; you never do.\n\nEach provider in scope converges with the **harden** skill\n(`.agents\u002Fskills\u002Fharden\u002FSKILL.md`): its loop, root-cause order, isolation\nrules and the provider-bug patterns it lists all apply here. This skill adds\nthe release-wide pieces around it: the clean slate, the plan across\nproviders, the fix fleet, and the PRs. When the user only asks to harden a\nprovider, use the harden skill instead of this one.\n\nThe arguments name the scope: providers (`aws cloudflare gcp …`) or `all`. With\nno arguments, propose a scope (default: unit + local + every `provider:*` live\ntag) and confirm it together with the nuke in a single question. **Nuking the\ntesting account is destructive — always get an explicit go-ahead first.**\n\n## 0. Preflight\n\nStart from a clean, up-to-date `main` in this worktree, on a fresh branch:\n\n```sh\ngit status                                   # must be clean; never git stash\ngit fetch origin main && git checkout -b release\u002Fprep-$(date +%Y-%m-%d) origin\u002Fmain\ngit submodule update --init -- submodules\u002Fdistilled\npnpm install\nbun --version                                # must be 1.3.13 — 1.4 fails every file at collection\n# if not: mkdir -p \u002Ftmp\u002Fbun1313 && (cd \u002Ftmp\u002Fbun1313 && npm i --no-save bun@1.3.13)\n#         export PATH=\u002Ftmp\u002Fbun1313\u002Fnode_modules\u002F.bin:$PATH   (prefix every pnpm test with this)\nnode -v                                      # alchemy CLI needs >= 24.11.1 and pnpm wants 24.x — node 25\n# makes pnpm print a [WARN] that breaks scripts\u002Fensure-built.ts. If not 24.11+:\n#   mkdir -p \u002Ftmp\u002Fnode24 && (cd \u002Ftmp\u002Fnode24 && npm i --no-save node@24)\n#   export PATH=\u002Ftmp\u002Fnode24\u002Fnode_modules\u002F.bin:$PATH\n# Put these PATH exports + `set -a; source .env; set +a` in \u002Ftmp\u002Frelease\u002Fenv.sh and\n# source it before every command — env doesn't persist between shell calls.\nset -a; source .env; set +a                  # Cloudflare creds (pnpm download:env if missing)\naws sso login                                # AWS live + nuke ride the SSO session\nmkdir -p \u002Ftmp\u002Frelease\npnpm exec tsrs -b                             # REQUIRED before live runs: emits distilled lib\u002F\n```\n\nRuntime bundles (Lambda, Fly, Hetzner, Neon Functions) resolve distilled\npackages through their `lib\u002F` build output, not `src\u002F`. A fresh worktree has\nno `lib\u002F` for most providers, so every deployed runtime would crash at boot\nwith `Cannot find package '@distilled.cloud\u002F…'`.\n\nNever set or unset `CI` for tests (a profile-store migration can wipe\n`~\u002F.alchemy`). If an AWS run fails in ~100ms during setup, the SSO session has\nexpired — re-run `aws sso login`.\n\n## 1. Clean slate\n\n```sh\npnpm nuke --yes --profile testing            # scripts\u002Fnuke.sh requires --profile; no --yes hangs\npnpm clear:state --profile testing --yes --no-input   # prompts without --yes, fails in a non-TTY\npnpm nuke --dry-run --profile testing > \u002Ftmp\u002Frelease\u002Fcensus-0.txt   # baseline; should be residue only\n```\n\nNever run nuke while any suite is running. Holdouts that survive two nuke\npasses are stuck deletes — put that service on the worklist; its delete path is\nthe bug. Documented-undeletable residue (excluded in `scripts\u002Fnuke.sh`, e.g.\n`AWS.BackupSearch.SearchJob`, zone singletons) is not a finding.\n\n## 2. Build the plan and dry-run it\n\nTests carry tags (`unit`, `live`, `local`, `provider:\u003Ccloud>`,\n`provider:\u003Ccloud>:\u003Cservice>`). `--tags` takes expressions with `&&`, `||`, `!`,\nparentheses and `*`; `--plan` takes a JSON array of sequential phases, where a\nnested array runs branches in parallel and **the first matching branch wins**.\nTags listed under `optInTags` only run when named explicitly (wildcards and\nnegations don't count) — never name one without asking; they gate paid add-ons\nand entitlements.\n\nDefault plan (drop providers outside the scope):\n\n```json\n[\n  { \"tags\": [\"unit && !live\"] },\n  [\n    { \"tags\": [\"live && provider:aws\"],        \"concurrency\": 32 },\n    { \"tags\": [\"live && provider:cloudflare\"], \"concurrency\": 16 },\n    { \"tags\": [\"live && provider:gcp\"],        \"concurrency\": 16 },\n    { \"tags\": [\"live && !provider:aws && !provider:cloudflare && !provider:gcp\"], \"concurrency\": 8 }\n  ],\n  { \"tags\": [\"local\"], \"concurrency\": 8 },\n  { \"tags\": [] }\n]\n```\n\n- Phase 1 runs the unit tests first: a broken unit layer makes every live\n  failure noise, so stop and fix it before spending cloud time.\n- The final `[]` branch is the catch-all for untagged tests. Everything it\n  picks up is a tagging gap — add the missing tags in the release PR.\n- Never use `\"unbounded\"` and never exceed 32 per branch. Saturation shows up\n  as hundreds of 0ms `beforeAll` TimeoutErrors; real failures fail slow.\n\nWrite the plan to `\u002Ftmp\u002Frelease\u002Fplan.json` and preview it:\n\n```sh\npnpm test --profile testing --plan \"$(cat \u002Ftmp\u002Frelease\u002Fplan.json)\" --dry-run\n```\n\nFor reference, on 2026-10-09 the default plan selected 11,614 tests in 2,880\nfiles (unit 3,089 · aws 3,361 · cloudflare 1,577 · gcp 2,085 · other live\n811 · local 592 · untagged 99 in 19 files). Collection takes ~10s. Check\nthe branch counts against expectations. A branch with 0 tests is an\ninvocation bug (bad tag, quoting), not a pass. Show the user the preview\nbefore the real run.\n\n## 3. Run it\n\nA full round can outlast a 2-hour background-task limit, so detach it and\nwatch the output file with a monitor that filters to failed results\n(`grep -E \"\\] ✗ |failed to run|^Tests:\"` — a bare `✗` also matches the\n`[n\u002FN ✓ ✗]` progress counter on every line):\n\n```sh\nnohup pnpm test --profile testing --plan \"$(cat \u002Ftmp\u002Frelease\u002Fplan.json)\" \\\n  > \u002Ftmp\u002Frelease\u002Fround-1.out 2>&1 & disown\n```\n\nKeep running notes in `\u002Ftmp\u002Frelease\u002FSTATE.md` (round, blockers, worklist,\nresidue) so the loop survives context compaction.\n\nNote the `Full log: .alchemy\u002Flog\u002Ftest\u002F…` path at the end. Failures print\ninline with their error as soon as they happen, so start triage at the first\nfailure rather than waiting for the run to finish.\n\nTest time is the release's biggest cost, so one slow or exclusive test must\nnever hold up the rest of a run. If it does, fix the runner or narrow the\nlock; don't lower concurrency and don't wait it out. Tests that only contend\nfor a shared cloud resource take a label (`{ exclusive: \"aws:ses-account\" }`)\ninstead of `exclusive: true`, which only process-global state needs. On\n2026-10-31 a writer-preferring `exclusive: true` gate froze the AWS suite\ntwice behind a 25-minute ElastiCache test.\n\n## 4. Triage\n\nGroup failures by their most specific `provider:\u003Ccloud>:\u003Cservice>` tag (the\nservice is the unit of ownership). Classify each:\n\n| Bucket | Signal | Fix lands in |\n| --- | --- | --- |\n| Provider bug | wrong reconcile\u002Fdiff\u002Fdelete, leak, crash | `packages\u002Falchemy\u002Fsrc\u002F…` (alchemy PR) |\n| Untyped error | `Unknown*Error`, out-of-union status error, wrong schema | distilled patch (distilled PR) |\n| Emulator bug | only fails under floci | `submodules\u002Ffloci` (floci PR) |\n| Test bug | non-deterministic or hard-coded name, unbounded wait, missing propagation retry | the test (alchemy PR) |\n| Platform\u002Fentitlement | plan-gated, slow async provisioning, beta API | skipIf-gate on the typed tag + exact error, keep an ungated probe |\n| Flake | passes alone, fails under load | re-run alone and on main first |\n\nRoot-cause priority is **provider bug > distilled patch > test fix**, and a\nlonger timeout comes last, only for work that is slow by nature (image\nbuilds, cold starts). Never paper over a provider leak or untyped error in a\ntest. A failure that only shows up in some runs is usually two runs touching\nthe same cloud object — a shared name or stage, a missing lock label, or a\nretry that leaks — not a flake; see the isolation rules in the harden skill.\nSkip a test only for a permanent account blocker (quota, entitlement), with\n`test.provider.skip` and a comment quoting the exact error. For suspected flakes,\nbuild a verdict table: `Failure | Re-run alone | On main | Verdict`. A failure\nthat also fails on main is still in scope for the release — it just isn't a\nregression.\n\n## 5. Census\n\nAfter the run finishes (and never while one is running):\n\n```sh\npnpm nuke --dry-run --profile testing > \u002Ftmp\u002Frelease\u002Fcensus-1.txt\ndiff \u002Ftmp\u002Frelease\u002Fcensus-0.txt \u002Ftmp\u002Frelease\u002Fcensus-1.txt\n```\n\nEvery new resource is a leak, and a green service can still leak. **Leave the\nleaked resources live** as evidence for the fix agents. The worklist is\nfailing services ∪ leaking services.\n\n## 6. Fix fleet\n\nLaunch one agent per service on the worklist, in parallel. In T3 Code each\nfixer is a detached top-level thread from `t3_thread_launch` with\n`workspaceStrategy: { type: \"existing_worktree\", worktreePath: \u003Cthis worktree> }`,\nnever a `delegate_task` subagent thread. Collect each result with\n`t3_thread_wait` + `t3_thread_read`. Run ~12 at once (\naccount-singleton services like CloudTrail, Config, SecurityHub, GuardDuty,\nControlTower and IdentityCenter run as one sequential chain). Agents work in\nthis worktree and **commit but don't push**; they touch only their service's\nfiles, plus single minimal insertions in shared files. The prompt is a\ncontract — include every item:\n\n1. The service it owns, its directory, and its tag (e.g. `provider:aws:ec2`).\n2. Its exact failures (error text + test names) and its leak inventory from the\n   census diff.\n3. Assess-first: partial work may exist from an interrupted run; finish it\n   rather than rewriting.\n4. Reading list: AGENTS.md Reconciler doctrine + Typed Error Doctrine + speed\n   doctrine, the resource source, the test, and the distilled service +\n   existing patches.\n5. Root-cause priority (provider > distilled > test) and the rule that it\n   never hides a leak in the test.\n6. **No `tsc`, no `pnpm build`, no `pnpm nuke`** — the coordinator owns these.\n7. Speed doctrine: every run is\n   `pnpm test --tags '\u003Cits tag>' --profile testing`; per-test\n   timeouts ≤ 90–120s; every retry bounded (`times ≤ 8–10`, \u003C 60s total);\n   three-iteration budget, then gate and report.\n8. Distilled patches for its service only, regenerated in place:\n   - Cloudflare: `cd submodules\u002Fdistilled\u002Fpackages\u002Fcloudflare && bun scripts\u002Fgenerate.ts --resource \u003Csvc> && pnpm exec oxfmt src\u002Fservices\u002F\u003Csvc>.ts`\n   - AWS: `cd submodules\u002Fdistilled\u002Fpackages\u002Faws && bun scripts\u002Fgenerate.ts --sdk \u003Csvc>`\n   Tests resolve distilled from `src\u002F`, so there's nothing to rebuild or wait for.\n9. Test rules: start and end with `stack.destroy()`, out-of-band verification\n   through distilled, no mocks. Names: let the resource generate the physical\n   name. Only a test about explicitly provided names passes one, and it is\n   derived from `stack.stage` so it is isolated to the user running the test.\n   Never `Date.now()`, UUIDs or random values in a name: every run is\n   deterministic and leaves no orphans. A resource the API can never delete\n   keeps one shared constant name that every run adopts. Fix any hard-coded\n   name you find in the suites you touch.\n10. Done means: its **full** tag passes, and distilled list\u002Fdescribe calls show\n    zero orphans from its service.\n11. Structured result: `{ service, tag, testsPassed, testCommand, rootCause,\n    files, patches (with reasons), skippedTests (with exact errors), leaksFixed,\n    notes }`.\n\nWhile agents run, watch for stalls: a transcript that hasn't been written for\n~5 minutes with no child test process is stalled — `t3_thread_interrupt` it\nand re-dispatch with a new `t3_thread_launch`.\n\nWhen results come in, review each diff yourself before accepting it. Reject\nany that catch a catch-all error, widen a cast, add `Effect.orDie` to a\nlifecycle op, mock a response, or skip a test without a typed reason.\n\n## 7. Gate\n\n```sh\npnpm exec tsrs -b                             # coordinator only, once per round\npnpm docs:check-jsdoc                        # if any props\u002Fattrs changed\n```\n\nFix cross-cutting fallout yourself (`Providers.ts` nested `Layer.mergeAll`\ngroups, barrel conflicts). Commit the round — one commit per service fix,\nconventional-commit scoped (`fix(aws\u002Fec2): …`) — and **push immediately**.\n\n## 8. Loop\n\n**Converge with targeted runs, then confirm with full ones.** Live tests are\nslow, so after the first full plan every fixing run is targeted:\n\n1. **Track passes cumulatively.** Every run (yours and the agents') writes\n   `PASS \u003Cfile> > \u003Ctitle>` lines to `packages\u002Falchemy\u002F.alchemy\u002Flog\u002Ftest\u002F*.log`.\n   Rebuild the passed set from all logs, not just the last round:\n   ```sh\n   cat packages\u002Falchemy\u002F.alchemy\u002Flog\u002Ftest\u002F*.log | grep -E \"^PASS \" \\\n     | sed -E 's\u002F^PASS \u002F\u002F; s\u002F \\([0-9.]+m?s\\).*$\u002F\u002F' | sort -u > \u002Ftmp\u002Frelease\u002Fpassed.txt\n   ```\n2. **Compute the residual:** tests with a `FAIL` line and no `PASS` line, plus\n   tests that never finished (a killed or stalled round) — find those by\n   diffing the run's test list against the result lines.\n3. **Fix agents get each failing area passing individually** (their own\n   suites, `-t` for single tests in long sequential files).\n4. **One residual run** of only what's still unpassed — file paths, narrowed\n   with `-t` where a file is long and sequential (e.g. `Fly\u002FBlueGreen.test.ts`\n   has ~180 tests at ~100s each; never run it unfiltered).\n5. **Confirm stability per provider** with the harden skill's loop: full\n   runs of each provider's suite, a census after each, until two consecutive\n   runs are green and clean. One green run proves little — retry leaks, lagging\n   listings and shared names only show up across runs.\n6. **Finish with nuke + clear:state + census.** The goal is consecutive green\n   runs and a census that shows `Nothing to delete`.\n\nIf a census leftover reappears after nuke, its `list` or `delete` is the bug\n(e.g. `list` returning archived or Cloudflare-managed objects), not the test.\n\nReport each round to the user, briefly:\n\n```md\n### Round N: 1834 passed · 12 failed · 3 leaking services\n\n| Service | Tag | Failure | Bucket | Status |\n| --- | --- | --- | --- | --- |\n| EC2 | provider:aws:ec2 | InternetGateway delete timeout | provider bug | fixed, 63\u002F63 |\n| R2 | provider:cloudflare:r2 | UnknownCloudflareError 10058 | distilled | patched, 30\u002F30 |\n\nNext: round N+1 (full plan).\n```\n\n## 9. PRs\n\nAt most three, one per repo. Open them as soon as there is a first fix, and\npush every later fix promptly.\n\n**distilled** (only if there are patches) — work in a standalone clone, never\na `git worktree add` from inside `submodules\u002Fdistilled` (its `core.worktree`\nbelongs to another checkout):\n\n```sh\ngit clone --reference submodules\u002Fdistilled https:\u002F\u002Fgithub.com\u002Falchemy-run\u002Fdistilled \u002Ftmp\u002Frelease\u002Fdistilled\ncd \u002Ftmp\u002Frelease\u002Fdistilled && git checkout -b fix\u002Frelease-prep-$(date +%Y-%m-%d)\n# copy the patches + regenerated services from submodules\u002Fdistilled, commit per service\n```\n\nTitle: `fix: typed errors and schema fixes from release prep`. The body lists\neach patch with the error it types, e.g. `R2 putBucketLifecycle: code 10058 →\nLifecycleRuleInvalid`.\n\n**floci** (only if emulator fixes are needed) — floci is skipped by default\n(`git submodule update --init --checkout -- submodules\u002Ffloci`); use the same\nstandalone-clone pattern against `https:\u002F\u002Fgithub.com\u002Falchemy-run\u002Ffloci`. If alchemy needs the new emulator image, it needs a release\ntag.\n\n**alchemy** — branch `release\u002Fprep-\u003Cdate>`, title\n`fix: release hardening (\u003Cdate>)`. It contains the provider, test, gating and\ntagging fixes, plus submodule bumps pointing at the distilled\u002Ffloci PR heads.\nThe merge order is distilled → floci → alchemy. After each upstream PR merges,\nrepoint the submodule at its **`main` merge commit** (never a side branch),\nrerun the affected tags, and push.\n\nDescriptions follow AGENTS.md's PR conventions: one plain sentence, then\nuser-facing snippets or a per-service table of what was fixed. No `#`\u002F`##`\nheadings and no test plan. Write the body to a file and pass `--body-file`.\nLink every PR to this thread with the T3 `link_pull_request` tool when it's\navailable. Leave PRs as drafts until the gate passes, then `gh pr ready`.\n\n## 10. Final report\n\nEnd with the merge ask:\n\n```md\n### Release prep converged after N rounds. I recommend merging, in this order:\n\n1. distilled — \u003Cwhat it types>\n   https:\u002F\u002Fgithub.com\u002Falchemy-run\u002Fdistilled\u002Fpull\u002FX\n2. alchemy — \u003CK> service fixes, \u003CG> gated tests, \u003CT> tagging fixes\n   https:\u002F\u002Fgithub.com\u002Falchemy-run\u002Falchemy\u002Fpull\u002FY\n\n| Phase | Tests | Result |\n| --- | --- | --- |\n| unit | 856 | ✅ |\n| live provider:aws | 1662 | ✅ 1650 · 12 skipped (gated) |\n| … | | |\n\nGated (needs entitlement \u002F platform): \u003Ctest → exact error>.\nFails on main too (pre-existing, now fixed): \u003Clist>.\nCensus: clean except \u003Cdocumented residue>.\n```\n\nSay plainly what was **not** run (out-of-scope providers, opt-in tags). Don't\nreport CI status in place of the test results.\n\n## Pitfalls seen in practice\n\n- **Commit with the pinned env sourced.** The pre-commit hook runs pnpm; with\n  the wrong bun\u002Fnode or a stray temp workspace dir under `examples\u002F` (left by\n  a killed test) it re-installs and rewrites `pnpm-lock.yaml`. Never commit\n  the lockfile or Prisma `generated\u002Fcontract.*` churn.\n- **Distilled regeneration can `pnpm install` inside `submodules\u002Fdistilled`**,\n  creating a nested `node_modules` with a second `effect` copy (\"Unable to get\n  redacted value\" everywhere). Move `submodules\u002Fdistilled\u002Fnode_modules` aside\n  and check `packages\u002F*\u002Fnode_modules\u002Feffect` links point at the root store.\n- **Other sessions share the account.** Another worktree's live resources\n  show up in your census; check `ps -eo etime,command | grep alchemy-test`\n  before deleting a leftover you can't trace to your own run. A linked\n  worktree defaults to its own test stage (`test_$USER_\u003Cworktree>`), so two\n  worktrees don't collide; suites that set their own stage must prefix it\n  with `Test.defaultStage()`.\n- **Provider `console.log` doesn't reach the run log.** Debug with\n  `Effect.logInfo`, and probe API behavior with a throwaway test file rather\n  than guessing.\n- **Account blockers are not code.** Billing (GCP), token permission groups\n  (e.g. Cloudflare K2) and retired services (AWS FinSpace) get reported to the\n  user with the exact error; never enable billing or edit shared tokens.\n",{"name":5,"metadata":24,"description":7},{"internal":25},true,"main","74a37f7f6ee0e64cd4ec0f5ad712ec3347c549dc","repos\u002Falchemy\u002F.agents\u002Fskills\u002Fprepare-release",0,"https:\u002F\u002Fgithub.com\u002Fsystemfsoftware\u002Fomp-claude-compat","https:\u002F\u002Fsystemfsoftware.com","https:\u002F\u002Fgithub.com\u002Fsystemfsoftware","https:\u002F\u002Fsystemfsoftware.com\u002F","2026-11-13 17:18:44",{"source":8,"skillName":5,"commands":36,"prompt":46,"zipAvailable":25},[37,40,43],{"tool":38,"command":39},"npx","npx skills add systemfsoftware\u002Fomp-claude-compat --skill prepare-release",{"tool":41,"command":42},"bunx","bunx skills add systemfsoftware\u002Fomp-claude-compat --skill prepare-release",{"tool":44,"command":45},"pnpm","pnpm dlx skills add systemfsoftware\u002Fomp-claude-compat --skill prepare-release","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fsystemfsoftware\u002Fomp-claude-compat\u002Fblob\u002Fmain\u002Frepos\u002Falchemy\u002F.agents\u002Fskills\u002Fprepare-release\u002FSKILL.md",[],[49,56,63,70,77,84],{"skillNo":50,"name":51,"nameZh":6,"description":52,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":53,"categories":54,"keywords":55,"publishedAt":19},"01M7CEK01YFJ861EQWA0GYETMW","vendored-assets","Vendored assets. Use when importing or updating checked-in third-party or externally generated JavaScript, CSS, registries, schemas, snapshots, or Scalar, Swagger, and MIME artifacts.","https:\u002F\u002Fgithub.com\u002Fsystemfsoftware\u002Fomp-claude-compat\u002Fblob\u002Fmain\u002Frepos\u002Feffect\u002F.agents\u002Fskills\u002Fvendored-assets\u002FSKILL.md",[],[],{"skillNo":57,"name":58,"nameZh":6,"description":59,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":60,"categories":61,"keywords":62,"publishedAt":19},"01M7CEJXK1X8E48GB0M2V6RMGC","test-development","Test development. Use when adding or changing Vitest or Tstyche coverage. Choose Tstyche only for intended compiler behavior such as inference, assignability, rejection, or displayed public types.","https:\u002F\u002Fgithub.com\u002Fsystemfsoftware\u002Fomp-claude-compat\u002Fblob\u002Fmain\u002Frepos\u002Feffect\u002F.agents\u002Fskills\u002Ftest-development\u002FSKILL.md",[],[],{"skillNo":64,"name":65,"nameZh":6,"description":66,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":67,"categories":68,"keywords":69,"publishedAt":19},"01M7CEJVPY11HPB97R4MVDP5EQ","pull-requests","Pull request finalization. Use when a change works and is about to be opened as a pull request, or when updating or continuing an existing one.","https:\u002F\u002Fgithub.com\u002Fsystemfsoftware\u002Fomp-claude-compat\u002Fblob\u002Fmain\u002Frepos\u002Feffect\u002F.agents\u002Fskills\u002Fpull-requests\u002FSKILL.md",[],[],{"skillNo":71,"name":72,"nameZh":6,"description":73,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":74,"categories":75,"keywords":76,"publishedAt":19},"01M7CEJSF92NA5KNYEEM9JB37Z","performance-analysis","Performance analysis. Use for runtime throughput or latency benchmarks, TypeScript compiler cost, performance regressions, comparison harnesses, or thresholds.","https:\u002F\u002Fgithub.com\u002Fsystemfsoftware\u002Fomp-claude-compat\u002Fblob\u002Fmain\u002Frepos\u002Feffect\u002F.agents\u002Fskills\u002Fperformance-analysis\u002FSKILL.md",[],[],{"skillNo":78,"name":79,"nameZh":6,"description":80,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":81,"categories":82,"keywords":83,"publishedAt":19},"01M7CEJQHJ888WYE69Z1GMCR16","package-development","Package registration. Use when adding a workspace package, making a private package publishable, renaming a package, or moving its workspace path.","https:\u002F\u002Fgithub.com\u002Fsystemfsoftware\u002Fomp-claude-compat\u002Fblob\u002Fmain\u002Frepos\u002Feffect\u002F.agents\u002Fskills\u002Fpackage-development\u002FSKILL.md",[],[],{"skillNo":85,"name":86,"nameZh":6,"description":87,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":88,"categories":89,"keywords":90,"publishedAt":19},"01M7CEJNDV264J32BSMXNPRXAG","migration-guidance","Use when changing how a v3 public API maps to v4, editing migration annotations, or regenerating migration\u002Fv3-to-v4.md.","https:\u002F\u002Fgithub.com\u002Fsystemfsoftware\u002Fomp-claude-compat\u002Fblob\u002Fmain\u002Frepos\u002Feffect\u002F.agents\u002Fskills\u002Fmigration-guidance\u002FSKILL.md",[],[]]