flext-sh

doc-drift

'documentation drift, runtime contracts, authority reconciliation'

flext-sh 0 Actualitzat fa 1 mes
GitHub

Instal·la

npx skillscat add flext-sh/flext-tests/doc-drift

Instal·la des del registre de SkillsCat.

SKILL.md

Documentation drift

Compare active documentation with code, declared configuration, and canonical
upstream documentation. Treat commands and schemas as executable interfaces.

Before changing documentation, load every affected claim, canonical owner,
consumer, generator, destination, and validation command. The first missing or
conflicting owner stops with zero writes and no inferred replacement.

  1. Read repository law and owner configuration.
  2. Inventory commands, flags, paths, schemas, versions, and generated files.
  3. Verify each claim against owning code or a pinned upstream source.
  4. Remove extinct contracts and update all consumers, fixtures, and evals as one
    atomic cutover.
  5. Change generated output only through its owner and prove fixed point.
  6. Run native documentation, validation, and contradiction gates.

The first causal validation failure stops that invocation without an unchanged
retry, warning, alternate command, or partial convergence. Correct the owner and
rerun invalidated gates in the same cutover. Publish only the complete verified
result and require zero extinct-command, copied-schema, stale-fixture, and
generated-output residue. Tool-specific drift belongs to its owner.