stack: SKILL.md-Links auf repo-root-relative Pfade umgestellt, docs verify/instructions verify pruefen Linkziele
Files changed: - CHANGES.md - VERSION - instructions/CONTRACT.md - instructions/dev/doc-pull-through.md - instructions/dev/stack-close/SKILL.md - instructions/dev/stack-dev/SKILL.md - instructions/wiki-ingest/SKILL.md - instructions/wiki-lint/SKILL.md - instructions/wiki-manage/SKILL.md - instructions/wiki-query/SKILL.md - instructions/wiki-status/SKILL.md - tools/CONTRACT.md - tools/chemenu/commands/docs_verify.py - tools/chemenu/commands/instructions_cmd.py - tools/chemenu/tests/test_docs_verify.py - tools/chemenu/tests/test_instructions_cmd.py
This commit is contained in:
@@ -11,7 +11,7 @@ description: Health-check the LLM wiki - broken links, orphan pages, uncovered r
|
||||
threshold reached - `wiki-ingest`'s last step checks it after every publish, so the count is
|
||||
never something an agent has to remember.
|
||||
|
||||
**Before the first `wikitool` call:** [session-setup.md](../session-setup.md).
|
||||
**Before the first `wikitool` call:** `instructions/session-setup.md`.
|
||||
|
||||
## Run checklist
|
||||
|
||||
@@ -51,7 +51,7 @@ mechanical half looks exactly like a complete one.
|
||||
The *Redundant see-also* section is the one that looks mechanical and is not - do **not**
|
||||
clear it under step 7. It names a `see-also` edge standing beside a specific label on the
|
||||
reverse direction, and the obvious repair destroys the thing worth keeping: `xref remove`
|
||||
clears the reference in *both* directions (see [tools/CONTRACT.md](../../tools/CONTRACT.md)),
|
||||
clears the reference in *both* directions (see `tools/CONTRACT.md`),
|
||||
so removing the weak edge takes the labelled one with it and the pair ends up saying nothing
|
||||
at all. Either relabel the weak edge to something true with `xref add`, which only ever
|
||||
touches the source page, or leave it and report it at step 9. Clearing a batch of these is a
|
||||
@@ -90,7 +90,7 @@ mechanical half looks exactly like a complete one.
|
||||
7. **Repair what is mechanical.** A dangling frontmatter reference is either a page that should
|
||||
exist (`tools/wikitool new ...`) or a reference that should not
|
||||
(`tools/wikitool xref remove --a "<Page>" --b "<Missing>"`). A title that changed is
|
||||
`tools/wikitool rename` - see [page-lifecycle.md](../page-lifecycle.md). Never hand-edit a
|
||||
`tools/wikitool rename` - see `instructions/page-lifecycle.md`. Never hand-edit a
|
||||
frontmatter array to clear one.
|
||||
|
||||
8. **Verify the stack.**
|
||||
@@ -129,7 +129,7 @@ mechanical half looks exactly like a complete one.
|
||||
|
||||
- **Publish?** Lint does not auto-publish. Run `tools/wikitool publish` only if asked.
|
||||
- **Bulk fixes touched 10+ files?** Expected for a lint pass: `publish` exits 42. Show the
|
||||
user its output and stop; see [gates.md](../gates.md). Consider `--path` batches instead.
|
||||
user its output and stop; see `instructions/gates.md`. Consider `--path` batches instead.
|
||||
- **The gate or loop-breaker keeps tripping?** That is a signal to stop and re-plan with the
|
||||
user, not to pass `--override-budget`. A full pass should land in roughly 20-35 calls.
|
||||
|
||||
@@ -140,7 +140,7 @@ mechanical half looks exactly like a complete one.
|
||||
`publish` (only if asked)
|
||||
|
||||
**Deliberately absent:** `rm` - a lint pass never deletes a page, and
|
||||
[page-lifecycle.md](../page-lifecycle.md) is where a deletion belongs. `log status` - it decides
|
||||
`instructions/page-lifecycle.md` is where a deletion belongs. `log status` - it decides
|
||||
this skill's *trigger*, but `wiki-ingest`'s last step is what runs it.
|
||||
|
||||
## Output
|
||||
|
||||
Reference in New Issue
Block a user