validate
Goal: block objectively broken documentation before an agent reports work as complete.
Run
bash scripts/docflow-validate.sh --target <REPO ROOT>
If running from an installed plugin where scripts are not in the target repo, use the plugin script path.
Interpret
Errorsare blockers. Fix them before saying the docs are complete.Warningsare legacy/adoption cleanup. Report them, but they do not block unless the user asked for a strict cleanup.- Fresh scaffold placeholders are warnings because new repos intentionally start from templates.
Rules
- Run after
/docflow:author,/docflow:changelog,/docflow:repair, or any manual docs edit. - Regenerate
INDEX.mdbefore validation when files were added, renamed, or removed. - Keep the output concise: status, blockers, warnings worth acting on.
Source: hashgraph-online/awesome-codex-plugins → plugins/MedAdemBHA/docflow/skills/validate/SKILL.md