Repository navigation
Commit 8d9fbc4
docs: fix stale escape-helper and sharing claims, missing cross-links, and the cream-chrome conflict (#5876)
Closes #5847
## Summary
Four stale or conflicting statements in the comprehension docs, from
spec container #5835 (item A5). Documentation only; eight plugins get
patch bumps.
## Fix
- **Escape helper.** `visualization:visualize`, `architecture:improve`
(SKILL and `deepening.md`), the visualize eval, and
`docs/upstream/humanlayer-skills.md` said pull-request diffs, fetched
content and other repositories' files stay out of HTML "until the escape
helper ships". The helper shipped (`lib/html-escape.mjs`). They now say
the lane is held until it is wired through the helper, which matches the
rendered-views README and its changelog.
- **Artifact sharing.** The rendered-views README claimed cross-account
sharing was verified absent (as of v2.1.252). It now describes sharing
as the upstream artifacts doc states it (as of 2026-10-02, v2.1.287):
owner-only by default, named organization members or everyone with
viewer or editor roles on Team and Enterprise, public link off until an
Owner enables it. It carries a pointer and a recheck trigger. The doc
does not describe email invitations to people outside the organization,
so the paragraph says a plan that needs that checks the live Share
dialog; the issue states email invites exist, and I could not confirm it
from the docs.
- **Cross-links.** `eli5` and `visualize` name each other. `wait-what`,
`explain` and `clarify` name each other, each saying when to pick the
other.
- **Cream versus chrome.** The shared chrome's background is ivory,
while six skills told authors to leave out a cream or off-white
background. The README's chrome section now states the ivory background
is the sanctioned default, and the leave-out lists in `clarify`, `eli5`,
`teach`, `explore-directions`, `playgrounds:use` and `write-for-agents`
name layout habits only.
- Patch bumps with changelog entries: visualization 0.9.1, architecture
0.18.3, adhd 0.5.4, education 0.12.1, prototype 0.13.8, playgrounds
0.2.2, docs-hygiene 0.24.6, discipline 0.16.1.
`docs/conventions/rendered-views/CHANGELOG.md` records the posture
rulings.
`docs/adr/0025-...` still says "no cross-account sharing or editing
exists"; it is a decision record, so it is left as written.
## Verification
- `markdownlint-cli2` on all 22 changed Markdown files: 0 issues.
`typos`: clean. Changed JSON parses.
- `check-changelog-parity.sh` (`--check-bump`, `--check-order`,
`--check-preserved`), `check-changed-skills.sh`,
`check-skill-portability.sh`, `check-skill-description-voice.sh`,
`check-contract-clause-coverage.py`, `check-spoke-plugin-root.sh`,
`check-skill-count-claims.sh`, `check-plugin-manifest-presence.sh`,
`validate-plugins.sh`: pass.
- `affected-tests.sh --run`: every selected suite passes except
`scripts/check-script-contract.test.sh`, which fails 2 cases because
`node_modules/.bin/htmlhint` is absent (`run npm ci`). The same 2 cases
fail on a clean `main` checkout without `node_modules`, so they are
environmental. One Python suite is not run by that runner.
## Related
- Spec container #5835 (sub-issue A5); relates to #3605 (escape helper),
#3604.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
---------
Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>1 parent 84cf50f commit 8d9fbc4
32 files changed
Lines changed: 149 additions & 30 deletions
File tree
- docs
- conventions/rendered-views
- upstream
- plugins
- adhd
- .claude-plugin
- skills/clarify
- architecture
- .claude-plugin
- skills/improve
- actions
- discipline
- .claude-plugin
- skills/wait-what
- docs-hygiene
- .claude-plugin
- skills/write-for-agents
- education
- .claude-plugin
- skills
- eli5
- explain
- teach/context
- playgrounds
- .claude-plugin
- skills/use
- prototype
- .claude-plugin
- skills/explore-directions
- visualization
- .claude-plugin
- skills/visualize
- context
- evals
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
4 | 4 | | |
5 | 5 | | |
6 | 6 | | |
| 7 | + | |
| 8 | + | |
| 9 | + | |
| 10 | + | |
| 11 | + | |
| 12 | + | |
| 13 | + | |
| 14 | + | |
| 15 | + | |
| 16 | + | |
7 | 17 | | |
8 | 18 | | |
9 | 19 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
59 | 59 | | |
60 | 60 | | |
61 | 61 | | |
62 | | - | |
63 | | - | |
64 | | - | |
65 | | - | |
| 62 | + | |
| 63 | + | |
| 64 | + | |
| 65 | + | |
| 66 | + | |
| 67 | + | |
| 68 | + | |
| 69 | + | |
66 | 70 | | |
67 | 71 | | |
68 | 72 | | |
| |||
228 | 232 | | |
229 | 233 | | |
230 | 234 | | |
| 235 | + | |
| 236 | + | |
| 237 | + | |
| 238 | + | |
| 239 | + | |
| 240 | + | |
231 | 241 | | |
232 | 242 | | |
233 | 243 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
57 | 57 | | |
58 | 58 | | |
59 | 59 | | |
60 | | - | |
61 | | - | |
| 60 | + | |
| 61 | + | |
62 | 62 | | |
63 | 63 | | |
64 | 64 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
1 | 1 | | |
2 | 2 | | |
3 | 3 | | |
4 | | - | |
| 4 | + | |
5 | 5 | | |
6 | 6 | | |
7 | 7 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
3 | 3 | | |
4 | 4 | | |
5 | 5 | | |
| 6 | + | |
| 7 | + | |
| 8 | + | |
| 9 | + | |
| 10 | + | |
| 11 | + | |
| 12 | + | |
| 13 | + | |
| 14 | + | |
| 15 | + | |
| 16 | + | |
6 | 17 | | |
7 | 18 | | |
8 | 19 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
209 | 209 | | |
210 | 210 | | |
211 | 211 | | |
212 | | - | |
| 212 | + | |
213 | 213 | | |
214 | 214 | | |
215 | 215 | | |
| |||
228 | 228 | | |
229 | 229 | | |
230 | 230 | | |
| 231 | + | |
| 232 | + | |
| 233 | + | |
| 234 | + | |
| 235 | + | |
| 236 | + | |
| 237 | + | |
231 | 238 | | |
232 | 239 | | |
233 | 240 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
1 | 1 | | |
2 | 2 | | |
3 | 3 | | |
4 | | - | |
| 4 | + | |
5 | 5 | | |
6 | 6 | | |
7 | 7 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
3 | 3 | | |
4 | 4 | | |
5 | 5 | | |
| 6 | + | |
| 7 | + | |
| 8 | + | |
| 9 | + | |
| 10 | + | |
| 11 | + | |
| 12 | + | |
6 | 13 | | |
7 | 14 | | |
8 | 15 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
77 | 77 | | |
78 | 78 | | |
79 | 79 | | |
80 | | - | |
| 80 | + | |
81 | 81 | | |
82 | 82 | | |
83 | 83 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
71 | 71 | | |
72 | 72 | | |
73 | 73 | | |
74 | | - | |
| 74 | + | |
75 | 75 | | |
76 | 76 | | |
77 | 77 | | |
| |||
0 commit comments