원클릭으로 Manus에서 모든 스킬 실행

drift-sweep

스타2

포크1

업데이트2026년 6월 12일 18:40

Bootstrap a repo's doc contract or audit doc drift — declares every markdown surface (LIVING/GENERATED/SOURCE/HISTORICAL), wires the CI doc-truth checker, migrates shadow trackers to GitHub issues, and reconciles out-of-band drift (closed issues, migration high-water marks, stale PRs, ghost worktrees). Use when the user says "drift sweep", "bootstrap the doc contract", "are these docs stale", after a rename or process retirement, or pre-launch.

설치

Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.

Manus에서 실행

출처

jckeen

jckeen/dotfiles

GitHub 저장소 열기 Creator 저장소 보기

다운로드

Manus에서 실행

Bootstrap mode

Inventory: git ls-files '*.md'. For each file propose a tier:
- LIVING — updated as a side effect of merges (README, CHANGELOG, maintained guides). Keep this list small; prefer deleting a stale doc over declaring it.
- GENERATED — produced or asserted by CI/scripts.
- SOURCE — markdown-as-config: skill/agent definitions, templates, rule files.
- HISTORICAL — point-in-time records: old audits, dated reviews, retired ledgers, plans, ADRs. Present the table to the user for confirmation before writing anything.
Shadow trackers get migrated, not tiered. A checkbox/TODO file (TODO.md, LAUNCH_CHECKLIST.md, or any file whose substance is open work items): for each open item run gh issue create --title "<item>" --body "Migrated from <file> by drift-sweep"; move closed items worth keeping into CHANGELOG.md. Then delete the file, or mark it HISTORICAL if the user wants the record kept.
Ask the user for old names, parked domains, and retired hosts; add a BANNED <regex> line per answer. Propose the checkbox guard BANNED:LIVING,GENERATED ^[[:space:]]*[-*] \[ \] by default (omit if the repo legitimately ships checklists in active docs).
Write .doc-contract at the repo root.
Add the banner to each HISTORICAL file missing one, as a quote line in the first 5 lines: > **Historical** — point-in-time record (<today>). Do not act on this. Files with ADR-style **Status:** + **Date:** headers already pass.
Vendor the checker: copy ~/.claude/scripts/check-doc-truth.sh into the repo's script directory (e.g. scripts/check-doc-truth.sh), chmod +x, and wire a CI step that runs it (a job/step in the repo's existing CI workflow; create a minimal workflow if the repo has none).
Run the checker; fix every violation:
- dead-ref → fix the path if the target moved; replace the link with backticked plain text if the target is gone.
- banned → repoint prose at the canonical source (a file, a script, the live command output) instead of the hardcoded fact.
- Retirement protocol: for anything newly marked HISTORICAL, run rg -il "system of record|single source of truth|canonical tracker" and repoint every doc that bills the dead thing as authoritative.
Ship one PR: contract + vendored checker + CI wiring + all fixes. End with a summary of ≤10 lines.

Sweep mode

Run the repo's vendored check-doc-truth.sh; collect violations.
Out-of-band reconciliation (the gap CI can't see):
- gh issue list --state all --limit 200 vs every issue-number mention in LIVING/GENERATED docs — fix stale open/closed language.
- If docs cite a migration/schema high-water mark, compare it against the migrations directory (e.g. prisma/migrations, supabase/migrations).
- gh pr list — surface any PR open >48h with its review + CI state.
- git worktree list — prune ghost worktrees; delete local branches with no unique commits (git branch --merged <default>).
Fix doc items in one small docs PR. End with a ≤10-line summary — or just "clean" if nothing drifted.

Never

Backfill dead ledgers or fabricate history — banner + repoint and move on.
Create a new tracker file to fix tracker drift — GitHub issues are the only open-work tracker.
Hardcode a count, SHA, host, or version in prose — point at the canonical source CI can assert.

이 저장소의 다른 Skills

같은 저장소

orchestrate

jckeen/dotfiles

Full-lifecycle orchestration for comprehensive, no-compromise execution — roll-calls the right skills, fans out parallel/worktree agents, then closes the loop (verify, review, simplify, changelog, handoff, retro). Use when you want maximum effort, to go all-in, or to orchestrate a big task end-to-end.

2026-07-102

session-retro

jckeen/dotfiles

Runs a short retrospective that PROPOSES edits to the user's Claude Code skills — capturing a newly-found gotcha, fixing a description that didn't auto-trigger, retiring a dead skill, or extracting a reusable pattern into a new skill. Improves the TOOLSET, not the session log. Use when the user signals satisfaction at the end of real work ("thanks", "thanks that worked", "that worked great", "nice", "perfect", "exactly what I needed"), or when they explicitly run /session-retro. Always proposes and waits for confirmation — never edits skills silently. In unattended runs (/orchestrate, overnight, or /session-retro --auto), writes proposals to ~/.claude/retro-proposals/ instead of blocking.

2026-07-102

handoff

jckeen/dotfiles

Generate a concise session handoff for resuming work later, including current state, decisions, open issues, and next steps.

2026-07-102

decompose

jckeen/dotfiles

Deep task decomposition into parallel workstreams with self-contained agent prompts. Use when you want to review the execution plan before committing to it.

2026-07-102

handoff

jckeen/dotfiles

Generate a handoff note for clean session transitions — preserves context across /clear or new sessions. Use when ending a session, when context is getting high, or when the user says "hand off", "wrap up the session", or "save state for next time".

2026-07-102

branch-hygiene

jckeen/dotfiles

Inspect and clean stale branches across multiple repositories using the dotfiles git-hygiene + gh-bootstrap toolchain. Use when the user asks about branch state, stale local branches, or "no ref was fetched" errors.

2026-07-092

name

drift-sweep

description

Work in the current repo. Mode is auto-detected: no .doc-contract at the repo root → Bootstrap; contract present → Sweep.

Bootstrap mode

Inventory: git ls-files '*.md'. For each file propose a tier:
- LIVING — updated as a side effect of merges (README, CHANGELOG, maintained guides). Keep this list small; prefer deleting a stale doc over declaring it.
- GENERATED — produced or asserted by CI/scripts.
- SOURCE — markdown-as-config: skill/agent definitions, templates, rule files.
- HISTORICAL — point-in-time records: old audits, dated reviews, retired ledgers, plans, ADRs. Present the table to the user for confirmation before writing anything.
Shadow trackers get migrated, not tiered. A checkbox/TODO file (TODO.md, LAUNCH_CHECKLIST.md, or any file whose substance is open work items): for each open item run gh issue create --title "<item>" --body "Migrated from <file> by drift-sweep"; move closed items worth keeping into CHANGELOG.md. Then delete the file, or mark it HISTORICAL if the user wants the record kept.
Ask the user for old names, parked domains, and retired hosts; add a BANNED <regex> line per answer. Propose the checkbox guard BANNED:LIVING,GENERATED ^[[:space:]]*[-*] \[ \] by default (omit if the repo legitimately ships checklists in active docs).
Write .doc-contract at the repo root.
Add the banner to each HISTORICAL file missing one, as a quote line in the first 5 lines: > **Historical** — point-in-time record (<today>). Do not act on this. Files with ADR-style **Status:** + **Date:** headers already pass.
Vendor the checker: copy ~/.claude/scripts/check-doc-truth.sh into the repo's script directory (e.g. scripts/check-doc-truth.sh), chmod +x, and wire a CI step that runs it (a job/step in the repo's existing CI workflow; create a minimal workflow if the repo has none).
Run the checker; fix every violation:
- dead-ref → fix the path if the target moved; replace the link with backticked plain text if the target is gone.
- banned → repoint prose at the canonical source (a file, a script, the live command output) instead of the hardcoded fact.
- Retirement protocol: for anything newly marked HISTORICAL, run rg -il "system of record|single source of truth|canonical tracker" and repoint every doc that bills the dead thing as authoritative.
Ship one PR: contract + vendored checker + CI wiring + all fixes. End with a summary of ≤10 lines.

Sweep mode

Run the repo's vendored check-doc-truth.sh; collect violations.
Out-of-band reconciliation (the gap CI can't see):
- gh issue list --state all --limit 200 vs every issue-number mention in LIVING/GENERATED docs — fix stale open/closed language.
- If docs cite a migration/schema high-water mark, compare it against the migrations directory (e.g. prisma/migrations, supabase/migrations).
- gh pr list — surface any PR open >48h with its review + CI state.
- git worktree list — prune ghost worktrees; delete local branches with no unique commits (git branch --merged <default>).
Fix doc items in one small docs PR. End with a ≤10-line summary — or just "clean" if nothing drifted.

Never

Backfill dead ledgers or fabricate history — banner + repoint and move on.
Create a new tracker file to fix tracker drift — GitHub issues are the only open-work tracker.
Hardcode a count, SHA, host, or version in prose — point at the canonical source CI can assert.