| name | wiki-lint |
| description | Audit the local project wiki for broken links, orphan pages, contradictions, stale claims, missing citations, schema drift, and secret exposure. |
Wiki Lint
Audit project wiki content without reading raw private sources.
Workflow
- Resolve the requested wiki scope, defaulting to
ai_context/wiki/.
- Refuse to inspect
ai_context/sources/, ignored paths, credentials, or environment
files.
- Create
ai_context/.spk-wiki-build before the audit when the repository provides
that guard. While active, use only non-shell read/search tools; shell execution is
fail-closed except for an exact marker-cleanup command. Remove the marker in a
finally-style cleanup on success or failure. This bounded temporary marker is the
workflow's only permitted project write.
- Check orphan pages, contradictions, stale claims, missing citations, dead links,
index drift, and secret-shaped strings.
- Rank evidence-backed findings and propose fixes; do not apply them unless requested.
- Run an explicit verifier pass over the report and cleanup state.
Evidence Receipt
Return spk.evidence/v1 with audited pages, ranked findings, verification results,
guard cleanup, proposed fixes, risks, and next action.
Guardrails
- Read wiki pages only; never inspect raw private sources.
- Invoke implicitly only for a current explicit wiki-audit intent, never as an
adjacent cleanup step.
- Do not apply proposed fixes without explicit authorization.
- Do not write project state other than the temporary guard marker.
- Fail closed on secret-scan failure and always remove the temporary guard.
