docs-drift-audit

Étoiles7

Forks0

Mis à jour24 mars 2026 à 15:30

Audit whether onboarding docs, `docs/agent/*`, and layered `AGENTS.md` files still match the actual workspace. Use when documentation, agent instructions, or readiness scripts may have drifted.

Installation

Installer avec Codex ou Claude Copiez ce prompt, collez-le dans Codex, Claude ou un autre assistant, puis laissez-le vérifier la page du skill et l'installer pour vous.

Exécuter dans Manus

Source

defin85

defin85/bsl-gradual-types

Ouvrir le dépôt GitHub Voir les dépôts du créateur

Téléchargement

Exécuter dans Manus

Métiers associésSOC

Basé sur la classification professionnelle SOC

Développeurs de logicielsProfessions informatiques et mathématiques·SOC 15-1252

SKILL.md

readonly

name	docs-drift-audit
description	Audit whether onboarding docs, `docs/agent/*`, and layered `AGENTS.md` files still match the actual workspace. Use when documentation, agent instructions, or readiness scripts may have drifted.

Docs Drift Audit

Используй этот skill, когда нужно проверить, что onboarding docs, docs/agent/* и layered AGENTS.md не разошлись с реальным workspace.

Steps

Запусти ./scripts/run-agent-readiness-checks.sh.
Проверь primary onboarding docs: README.md docs/README.md docs/BUILD_GUIDE.md docs/guides/development-workflow.md
Убедись, что root AGENTS.md остаётся каноническим dispatcher, а локальные AGENTS.md не дублируют global playbook.
Если drift найден, правь docs до того, как менять более широкий README/CI narrative.

Expected Outcome

stale binary/package names отловлены fail-closed
canonical docs и local instructions существуют и ссылаются друг на друга корректно

Plus depuis ce dépôt

même dépôt

bsl-agent-mcp-smoke

defin85/bsl-gradual-types

Run smoke checks for changes touching `bsl-agent`, MCP bootstrap, `.mcp.json`, or the read-only HTTP UI. Use to verify CLI help, UI helper commands, and bootstrap/docs alignment.

2026-03-247

openspec-delivery-matrix

defin85/bsl-gradual-types

Build a Requirement -> Artifact -> Validation matrix for an approved OpenSpec change before handoff. Use when preparing delivery evidence or checking traceability for requirements in `openspec/changes/<change-id>`.

2026-03-247

verify-workspace

defin85/bsl-gradual-types

Verify that the current workspace, agent-facing docs, and the default smoke path remain consistent. Use for quick post-change validation before handoff or after documentation/runtime updates.

2026-03-247

name	docs-drift-audit
description	Audit whether onboarding docs, `docs/agent/*`, and layered `AGENTS.md` files still match the actual workspace. Use when documentation, agent instructions, or readiness scripts may have drifted.

Docs Drift Audit

Используй этот skill, когда нужно проверить, что onboarding docs, docs/agent/* и layered AGENTS.md не разошлись с реальным workspace.

Steps

Запусти ./scripts/run-agent-readiness-checks.sh.
Проверь primary onboarding docs: README.md docs/README.md docs/BUILD_GUIDE.md docs/guides/development-workflow.md
Убедись, что root AGENTS.md остаётся каноническим dispatcher, а локальные AGENTS.md не дублируют global playbook.
Если drift найден, правь docs до того, как менять более широкий README/CI narrative.

Expected Outcome

stale binary/package names отловлены fail-closed
canonical docs и local instructions существуют и ссылаются друг на друга корректно