[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7827K7XF5KF2VNWD99DWR02":3,"skill-same:01M7827K7XF5KF2VNWD99DWR02":53},{"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":24,"commitSha":25,"skillDirectory":26,"forksCount":27,"repositoryHtmlUrl":28,"repositoryHomepageUrl":6,"ownerHtmlUrl":29,"ownerBlogUrl":30,"ownerDescription":31,"updatedAt":32,"install":33,"resources":46},"01M7827K7XF5KF2VNWD99DWR02","docs-lifecycle-sweep",null,"Docs lifecycle sweep — Tier-B classification with evidence for stale docs. Use when user says doc sweep, clean up stale docs, compact audits, doc janitor, or promote\u002Flift\u002Fretire a doc.","stainless-code\u002Fpersist","stainless-code","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F188862219?v=4","01M7826VYMCF2NTQWQZRWQ454T","STAINLESS CODE","01M7826VZKNC149Y9ZNK0F93N7",5,"MIT","https:\u002F\u002Fgithub.com\u002Fstainless-code\u002Fpersist\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fdocs-lifecycle-sweep\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: docs-lifecycle-sweep\ndescription: Docs lifecycle sweep — Tier-B classification with evidence for stale docs. Use when user says doc sweep, clean up stale docs, compact audits, doc janitor, or promote\u002Flift\u002Fretire a doc.\n---\n\n# Docs lifecycle sweep — the doc janitor\n\n[`docs-governance`](..\u002Fdocs-governance\u002FSKILL.md) defines **what** every doc should be (lifecycle types, existence test, closing prescriptions, cross-reference discipline). This skill is the **how** — it walks the repo-wide `docs\u002F` surface, applies the spec mechanically, and produces a per-file action plan the user approves before anything is touched.\n\nThe promise: at the end of a sweep, every remaining file passes the existence test, every closed plan is lifted, every closed audit is either kept-with-justification or deleted-with-knowledge-lifted, every cross-reference still resolves, and there is **no dead weight**.\n\n## When to fire\n\nUser intent (any phrase is enough):\n\n- \"clean up stale docs\" \u002F \"doc janitor\" \u002F \"doc sweep\"\n- \"audit docs lifecycle\" \u002F \"compact audits\" \u002F \"compact plans\"\n- \"are these audits still earning their keep\"\n- \"what's gone stale in `docs\u002F`\"\n- \"delete tombstones\" \u002F \"no tombstones, please\"\n- \"promote \u002F lift \u002F retire `\u003Cdoc>`\"\n- \"is this audit closed properly\"\n- After landing a substantive PR, asking \"did anything in docs go stale because of this?\"\n\nAlso fire **proactively** when:\n\n- Closing a Plan, Audit, or Research file via [`improve-codebase-architecture`](..\u002Fimprove-codebase-architecture\u002FSKILL.md) or any normal commit that ships a tracked `roadmap.md` item — the closure is a natural sweep trigger for that file's neighbours.\n- A PR adds a new `docs\u002Faudits\u002F\u003Ctopic>.md` — sweep the rest of `docs\u002Faudits\u002F` to catch anything the new audit just superseded.\n- A repo-wide refactor changes paths or symbol names cited from docs (cross-reference rot risk).\n\n## Scope (which surfaces this skill walks)\n\nThis repo is **Tier B only** — one repo-wide `docs\u002F` surface, no per-feature subtrees, no per-shared-component READMEs. Two surfaces:\n\n| Tier                     | Substrate              | Sweep scope                                                                                             |\n| ------------------------ | ---------------------- | ------------------------------------------------------------------------------------------------------- |\n| **B** — repo-wide        | `docs\u002F` at repo root   | All 5 lifecycle types: `architecture.md`, `roadmap.md`, `glossary.md`, `audits\u002F`, `plans\u002F`, `research\u002F` |\n| **0** — per-tooling-area | `.agents\u002F`, `.cursor\u002F` | Each rule + skill — apply existence test; check Tier-1 always-on cost still earns its keep              |\n\nDefault: the user names a surface (e.g. \"sweep `docs\u002Faudits\u002F`\"), and we walk just that one. If they say \"sweep docs\" without scope, walk all of `docs\u002F`.\n\n**Procedure:** [WORKFLOW.md](.\u002FWORKFLOW.md) — enumerate → existence test → classify → report → execute on approval.\n\n## Hooking the sweep into normal workflows\n\nThe skill is **discoverable** (Tier 3) — it fires on user intent. To make it run more automatically:\n\n- **End of every PR-closing commit** — when an agent closes a Plan or Audit (e.g. via [`improve-codebase-architecture`](..\u002Fimprove-codebase-architecture\u002FSKILL.md)), it should call this skill on the affected `audits\u002F` or `plans\u002F` directory as the final step.\n- **End of every material refactor** — when `src\u002F` files move or symbols rename, run this skill on `docs\u002F` to catch cross-reference rot.\n- **Pre-merge hygiene** — before merging a long-lived branch, sweep the `docs\u002F` surfaces it touches so stale claims don't land on `main`.\n\n## Anti-patterns\n\n- ❌ **Deleting without surfacing the classification first.** The user owns the call. The skill produces evidence; it does not unilaterally decide.\n- ❌ **Slimming without grepping for cited rule numbers \u002F section anchors.** Anchor breakage is silent and degrades over time. [`docs-governance` § 6](..\u002Fdocs-governance\u002FLIFECYCLE.md#6-cross-reference-preservation) is non-negotiable.\n- ❌ **Leaving tombstones.** A \"this audit was closed and deleted, see commit X\" pointer file IS the dead weight the sweep is supposed to eliminate. Trust `git log --follow`. A single `roadmap.md` line under \"Closed audits (pointers)\" is the maximum allowed surface for \"this used to exist.\"\n- ❌ **Lifting trivia.** Not every closed audit has knowledge worth lifting. If the audit's findings are 100% mechanical (\"rename X to Y, delete dead file Z\") and the result is visible in source, **lift nothing, delete the file.**\n- ❌ **Reformatting \"while we're here.\"** A sweep edits structure (delete \u002F slim \u002F lift \u002F pointer-update). Cosmetic re-flowing of unrelated docs is a separate PR.\n- ❌ **Sweeping Tier-1 rules without checking the always-on cost ledger.** A Tier-1 rule that no longer earns its always-on cost should demote to Tier 2 \u002F Tier 3 (per [`agents-tier-system`](..\u002F..\u002Frules\u002Fagents-tier-system.md)), not get deleted outright.\n- ❌ **Leaving enumerated cross-reference indexes inline after a slim or delete.** A line like _\"Cited from `architecture.md`, `glossary.md`\"_ in any doc is a hand-maintained index that goes stale every time the sweep runs. When you encounter one, replace it with the lookup command (`rg \"\u003Canchor>\" docs\u002F`) — the command IS the index. See [`docs-governance` § 6](..\u002Fdocs-governance\u002FLIFECYCLE.md#6-cross-reference-preservation).\n- ❌ **Citing specific audit \u002F plan \u002F research filenames as canonical examples in skills or rules.** Skills are durable; the docs they describe are mortal under this very lifecycle. **Use shape placeholders** (`\u003CYYYY-MM-DD>-\u003Ctopic>.md`, `docs\u002Faudits\u002F\u003Ctopic>.md`) and describe the **shape** of what to look for, not which file does it today. Same hazard in rules — see [authoring-discipline](..\u002F..\u002Frules\u002Fauthoring-discipline.md) + [`authoring-discipline\u002FPROSE.md`](..\u002Fauthoring-discipline\u002FPROSE.md) (no mortal filename anchors).\n\n## Reference\n\n- [`docs-governance`](..\u002Fdocs-governance\u002FSKILL.md) — the spec this skill operationalises (lifecycle types, existence test, closing prescriptions, cross-reference discipline).\n- [`docs-governance-priming`](..\u002F..\u002Frules\u002Fdocs-governance-priming.md) — Tier 2 priming; cites docs-governance + this skill on doc edits.\n- [`improve-codebase-architecture`](..\u002Fimprove-codebase-architecture\u002FSKILL.md) — natural caller; closes plans and triggers a sweep on the surrounding `plans\u002F` folder.\n- [WORKFLOW.md](.\u002FWORKFLOW.md) — 5-step procedure + output substrate.\n- [`agents-tier-system`](..\u002F..\u002Frules\u002Fagents-tier-system.md) — applies when sweeping Tier 0 (`.agents\u002Frules\u002F`, `.agents\u002Fskills\u002F`).\n","# Docs lifecycle sweep — the doc janitor\n\n[`docs-governance`](..\u002Fdocs-governance\u002FSKILL.md) defines **what** every doc should be (lifecycle types, existence test, closing prescriptions, cross-reference discipline). This skill is the **how** — it walks the repo-wide `docs\u002F` surface, applies the spec mechanically, and produces a per-file action plan the user approves before anything is touched.\n\nThe promise: at the end of a sweep, every remaining file passes the existence test, every closed plan is lifted, every closed audit is either kept-with-justification or deleted-with-knowledge-lifted, every cross-reference still resolves, and there is **no dead weight**.\n\n## When to fire\n\nUser intent (any phrase is enough):\n\n- \"clean up stale docs\" \u002F \"doc janitor\" \u002F \"doc sweep\"\n- \"audit docs lifecycle\" \u002F \"compact audits\" \u002F \"compact plans\"\n- \"are these audits still earning their keep\"\n- \"what's gone stale in `docs\u002F`\"\n- \"delete tombstones\" \u002F \"no tombstones, please\"\n- \"promote \u002F lift \u002F retire `\u003Cdoc>`\"\n- \"is this audit closed properly\"\n- After landing a substantive PR, asking \"did anything in docs go stale because of this?\"\n\nAlso fire **proactively** when:\n\n- Closing a Plan, Audit, or Research file via [`improve-codebase-architecture`](..\u002Fimprove-codebase-architecture\u002FSKILL.md) or any normal commit that ships a tracked `roadmap.md` item — the closure is a natural sweep trigger for that file's neighbours.\n- A PR adds a new `docs\u002Faudits\u002F\u003Ctopic>.md` — sweep the rest of `docs\u002Faudits\u002F` to catch anything the new audit just superseded.\n- A repo-wide refactor changes paths or symbol names cited from docs (cross-reference rot risk).\n\n## Scope (which surfaces this skill walks)\n\nThis repo is **Tier B only** — one repo-wide `docs\u002F` surface, no per-feature subtrees, no per-shared-component READMEs. Two surfaces:\n\n| Tier                     | Substrate              | Sweep scope                                                                                             |\n| ------------------------ | ---------------------- | ------------------------------------------------------------------------------------------------------- |\n| **B** — repo-wide        | `docs\u002F` at repo root   | All 5 lifecycle types: `architecture.md`, `roadmap.md`, `glossary.md`, `audits\u002F`, `plans\u002F`, `research\u002F` |\n| **0** — per-tooling-area | `.agents\u002F`, `.cursor\u002F` | Each rule + skill — apply existence test; check Tier-1 always-on cost still earns its keep              |\n\nDefault: the user names a surface (e.g. \"sweep `docs\u002Faudits\u002F`\"), and we walk just that one. If they say \"sweep docs\" without scope, walk all of `docs\u002F`.\n\n**Procedure:** [WORKFLOW.md](.\u002FWORKFLOW.md) — enumerate → existence test → classify → report → execute on approval.\n\n## Hooking the sweep into normal workflows\n\nThe skill is **discoverable** (Tier 3) — it fires on user intent. To make it run more automatically:\n\n- **End of every PR-closing commit** — when an agent closes a Plan or Audit (e.g. via [`improve-codebase-architecture`](..\u002Fimprove-codebase-architecture\u002FSKILL.md)), it should call this skill on the affected `audits\u002F` or `plans\u002F` directory as the final step.\n- **End of every material refactor** — when `src\u002F` files move or symbols rename, run this skill on `docs\u002F` to catch cross-reference rot.\n- **Pre-merge hygiene** — before merging a long-lived branch, sweep the `docs\u002F` surfaces it touches so stale claims don't land on `main`.\n\n## Anti-patterns\n\n- ❌ **Deleting without surfacing the classification first.** The user owns the call. The skill produces evidence; it does not unilaterally decide.\n- ❌ **Slimming without grepping for cited rule numbers \u002F section anchors.** Anchor breakage is silent and degrades over time. [`docs-governance` § 6](..\u002Fdocs-governance\u002FLIFECYCLE.md#6-cross-reference-preservation) is non-negotiable.\n- ❌ **Leaving tombstones.** A \"this audit was closed and deleted, see commit X\" pointer file IS the dead weight the sweep is supposed to eliminate. Trust `git log --follow`. A single `roadmap.md` line under \"Closed audits (pointers)\" is the maximum allowed surface for \"this used to exist.\"\n- ❌ **Lifting trivia.** Not every closed audit has knowledge worth lifting. If the audit's findings are 100% mechanical (\"rename X to Y, delete dead file Z\") and the result is visible in source, **lift nothing, delete the file.**\n- ❌ **Reformatting \"while we're here.\"** A sweep edits structure (delete \u002F slim \u002F lift \u002F pointer-update). Cosmetic re-flowing of unrelated docs is a separate PR.\n- ❌ **Sweeping Tier-1 rules without checking the always-on cost ledger.** A Tier-1 rule that no longer earns its always-on cost should demote to Tier 2 \u002F Tier 3 (per [`agents-tier-system`](..\u002F..\u002Frules\u002Fagents-tier-system.md)), not get deleted outright.\n- ❌ **Leaving enumerated cross-reference indexes inline after a slim or delete.** A line like _\"Cited from `architecture.md`, `glossary.md`\"_ in any doc is a hand-maintained index that goes stale every time the sweep runs. When you encounter one, replace it with the lookup command (`rg \"\u003Canchor>\" docs\u002F`) — the command IS the index. See [`docs-governance` § 6](..\u002Fdocs-governance\u002FLIFECYCLE.md#6-cross-reference-preservation).\n- ❌ **Citing specific audit \u002F plan \u002F research filenames as canonical examples in skills or rules.** Skills are durable; the docs they describe are mortal under this very lifecycle. **Use shape placeholders** (`\u003CYYYY-MM-DD>-\u003Ctopic>.md`, `docs\u002Faudits\u002F\u003Ctopic>.md`) and describe the **shape** of what to look for, not which file does it today. Same hazard in rules — see [authoring-discipline](..\u002F..\u002Frules\u002Fauthoring-discipline.md) + [`authoring-discipline\u002FPROSE.md`](..\u002Fauthoring-discipline\u002FPROSE.md) (no mortal filename anchors).\n\n## Reference\n\n- [`docs-governance`](..\u002Fdocs-governance\u002FSKILL.md) — the spec this skill operationalises (lifecycle types, existence test, closing prescriptions, cross-reference discipline).\n- [`docs-governance-priming`](..\u002F..\u002Frules\u002Fdocs-governance-priming.md) — Tier 2 priming; cites docs-governance + this skill on doc edits.\n- [`improve-codebase-architecture`](..\u002Fimprove-codebase-architecture\u002FSKILL.md) — natural caller; closes plans and triggers a sweep on the surrounding `plans\u002F` folder.\n- [WORKFLOW.md](.\u002FWORKFLOW.md) — 5-step procedure + output substrate.\n- [`agents-tier-system`](..\u002F..\u002Frules\u002Fagents-tier-system.md) — applies when sweeping Tier 0 (`.agents\u002Frules\u002F`, `.agents\u002Fskills\u002F`).\n",{"name":5,"description":7},"main","29ca2183c92cd13e04ce6c14fb431fd6993862cd",".agents\u002Fskills\u002Fdocs-lifecycle-sweep",0,"https:\u002F\u002Fgithub.com\u002Fstainless-code\u002Fpersist","https:\u002F\u002Fgithub.com\u002Fstainless-code","https:\u002F\u002Fstainless-code.com\u002F","Open-source tooling for JS\u002FTS and AI agents.","2026-11-01 20:56:20",{"source":8,"skillName":5,"commands":34,"prompt":44,"zipAvailable":45},[35,38,41],{"tool":36,"command":37},"npx","npx skills add stainless-code\u002Fpersist --skill docs-lifecycle-sweep",{"tool":39,"command":40},"bunx","bunx skills add stainless-code\u002Fpersist --skill docs-lifecycle-sweep",{"tool":42,"command":43},"pnpm","pnpm dlx skills add stainless-code\u002Fpersist --skill docs-lifecycle-sweep","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fstainless-code\u002Fpersist\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fdocs-lifecycle-sweep\u002FSKILL.md",true,[47],{"path":48,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":51,"sourceHtmlUrl":52},"WORKFLOW.md","REFERENCE","参考文档",8550,"https:\u002F\u002Fgithub.com\u002Fstainless-code\u002Fpersist\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fdocs-lifecycle-sweep\u002FWORKFLOW.md",[54,61,68,75,82,89],{"skillNo":55,"name":56,"nameZh":6,"description":57,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":58,"categories":59,"keywords":60,"publishedAt":19},"01M782D4ZQGJPNT470FSKDB6A8","vue-persist","Gate Vue 3 UI on Persist hydration with useHydrated (shallowRef). Use in setup\u002FeffectScope when avoiding flash of default state on async backends.","https:\u002F\u002Fgithub.com\u002Fstainless-code\u002Fpersist\u002Fblob\u002Fmain\u002Fskills\u002Fvue-persist\u002FSKILL.md",[],[],{"skillNo":62,"name":63,"nameZh":6,"description":64,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":65,"categories":66,"keywords":67,"publishedAt":19},"01M782D1GJRWNQ3458F3H1FK2F","svelte-store-persist","Gate Svelte store-based UI on Persist hydration with hydratedStore (Readable). Use for Svelte 3–4 or Svelte 5 apps that still use stores; runes UI → svelte-persist.","https:\u002F\u002Fgithub.com\u002Fstainless-code\u002Fpersist\u002Fblob\u002Fmain\u002Fskills\u002Fsvelte-store-persist\u002FSKILL.md",[],[],{"skillNo":69,"name":70,"nameZh":6,"description":71,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":72,"categories":73,"keywords":74,"publishedAt":19},"01M782CWBTRWAQ52TBNQ8665CC","svelte-persist","Gate Svelte 5 runes UI on Persist hydration with hydratedRune (.current). Use for Svelte 5; for stores \u002F Svelte 3–4 use svelte-store-persist.","https:\u002F\u002Fgithub.com\u002Fstainless-code\u002Fpersist\u002Fblob\u002Fmain\u002Fskills\u002Fsvelte-persist\u002FSKILL.md",[],[],{"skillNo":76,"name":77,"nameZh":6,"description":78,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":79,"categories":80,"keywords":81,"publishedAt":19},"01M782CR8Z2V3SJW661RTMWY2F","solid-persist","Gate Solid UI on Persist hydration with useHydrated (Accessor). Use when avoiding flash of default state on async backends; read hydrated() in reactive scopes.","https:\u002F\u002Fgithub.com\u002Fstainless-code\u002Fpersist\u002Fblob\u002Fmain\u002Fskills\u002Fsolid-persist\u002FSKILL.md",[],[],{"skillNo":83,"name":84,"nameZh":6,"description":85,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":86,"categories":87,"keywords":88,"publishedAt":19},"01M782CJQGP7739WA9BS801HZP","react-persist","Gate React UI on Persist hydration with useHydrated + toHydrationSignal. Use when avoiding flash of default state on async backends (IndexedDB), SSR snapshot true, or wiring HydrationSignal into React 18\u002F19.","https:\u002F\u002Fgithub.com\u002Fstainless-code\u002Fpersist\u002Fblob\u002Fmain\u002Fskills\u002Freact-persist\u002FSKILL.md",[],[],{"skillNo":90,"name":91,"nameZh":6,"description":92,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":93,"categories":94,"keywords":95,"publishedAt":19},"01M782CF96RMXCDETM5TF2JDRV","preact-persist","Gate Preact UI on Persist hydration with useHydrated (preact\u002Fcompat useSyncExternalStore). Use when avoiding flash of default state on async backends or wiring HydrationSignal into Preact.","https:\u002F\u002Fgithub.com\u002Fstainless-code\u002Fpersist\u002Fblob\u002Fmain\u002Fskills\u002Fpreact-persist\u002FSKILL.md",[],[]]