Agent-Skills.md

Agent Skills: Gundam Doc Gardening

Audit Gundam AGENTS, skills, and living documentation against current code after package moves or architectural changes. Use for semantic drift that deterministic link checks cannot prove.

UncategorizedID: TheCardGoat/tcg-engines/doc-gardening

Repository

TheCardGoat/tcg-engines
TheCardGoatLicense: MIT
2910

Install this agent skill to your local

pnpm dlx add-skill https://github.com/TheCardGoat/tcg-engines/tree/HEAD/submodules/gundam/.agents/skills/doc-gardening

Skill Files

Browse the full folder contents for doc-gardening.

Download Skill

Loading file tree…

submodules/gundam/.agents/skills/doc-gardening/SKILL.md

Skill Metadata

Name
doc-gardening
Description
Audit Gundam AGENTS, skills, and living documentation against current code after package moves or architectural changes. Use for semantic drift that deterministic link checks cannot prove.

Gundam Doc Gardening

Run deterministic checks first:

pnpm run check:harness
pnpm run check:doc-drift

Then inspect only the living docs affected by recent code changes:

  1. Read docs/architecture.md and docs/design-docs/core-beliefs.md.
  2. Use the requested revision range, or recent package-moving commits, to find likely drift.
  3. Verify named paths, symbols, commands, and package boundaries against the current tree.
  4. Classify findings as a safe factual fix, a semantic change needing owner review, or historical documentation that should remain unchanged.
  5. Re-run deterministic checks after factual edits.

AGENTS.md owns current instructions; adjacent CLAUDE.md is its alias. Do not add divergent guidance to the alias. Keep completed execution plans as historical records unless they claim to be current.

Report each finding with file and line, current evidence, proposed action, and whether it was fixed or needs owner input.