Files

dtoro 5e3b946ded cleanup: fix all stale references across .agents/ docs

- Rewrite AGENTS.md: DB as source of truth, MCP knowledge tools, archive refs
- Fix OIKOS.md: seeds/ paths, remove Python-era notes, update deployment status
- Fix commands.md, agent-enrollment.md: archive/knowledge/ links
- Fix all SKILL.md files: remove hosts/*.yaml refs, point to inventory.yaml
- Fix HERMES.md, schema.md, page-templates.md, llm-wiki.md: update paths
- Fix bootstrap.sh: identity check reads inventory.yaml
- Fix README.md, cutover-checklist.md: stale wiki references
- Move convert-wiki.py to archive/ (one-shot done)

2026-07-07 21:00:39 +02:00

1.1 KiB

Raw Blame History

name, risk_class, inputs, verification, docs_update_checklist

name

risk_class

inputs

verification

docs_update_checklist

docs-lint

read_only

paths

python3 .agents/skills/docs-lint/lint.py

Docs lint

Check committed documentation against the mechanical rules in writing-style.md: banned vocabulary and broken relative markdown links. Prose-voice rules are not machine-checkable — those stay a review responsibility.

Run from the repo root:

python3 .agents/skills/docs-lint/lint.py            # default: knowledge/ .agents/ operations/ investigations/ plans/
python3 .agents/skills/docs-lint/lint.py archive/knowledge/containers/104-gitea.md

Exit code is non-zero when any violation is found, so it can gate a commit. The banned-vocabulary list mirrors writing-style.md; update both together if the standard changes.

Known baseline. archive/knowledge/archive/knowledge/containers/101-jellyfin.md links into a sibling repo (devops/homelab-authentik-admin) that this checkout does not contain — expected, not a bug. Any other broken link is a real regression; investigate before dismissing it as baseline noise.

1.1 KiB Raw Blame History

Docs lint

1.1 KiB

Raw Blame History