From 7e583e95881171c79942ee2922e7a177456f30b0 Mon Sep 17 00:00:00 2001 From: Claude Date: Sun, 6 Sep 2026 08:16:38 +0000 Subject: [PATCH] docs(guide): redraw agent-skills.md's tree from disk skills/objectui/rules/ and guides/ drifted from the tree agent-skills.md drew: #7251 moved rules/no-touch-zones.md and guides/console-development.md out to the repo-internal .claude/skills/objectui-contributor/ skill, and guides/app-composition.md landed without ever being added to the drawn tree. Redraw both subtrees from `find skills/objectui -type f`, and add a paragraph saying where the two contributor-only files went and why (a customer install has no apps/console/ or packages/components/src/ui/). ci-cd-pipeline.md:581 is deliberately left unchanged: re-running node scripts/check-skills-paths.mjs today confirms the baseline still carries exactly one entry (88/89 stated paths resolve across 20 guide files; 1 baselined), matching the note in scripts/skills-path-baseline.json that the entry was re-stated under the guide's post-move key rather than deleted. The sentence at :581 never named the guide's directory or the moved-to path, so nothing in it went stale. evals/console-development.json is confirmed gone from disk, but the tree never listed individual eval filenames to begin with, so there was no row to remove. Co-Authored-By: Claude Fable 5.1 Claude-Session: https://claude.ai/code/session_01MM7kaS4dPpYHV5BsMyu4tQ --- content/docs/guide/agent-skills.md | 15 +++++++++++---- 1 file changed, 11 insertions(+), 4 deletions(-) diff --git a/content/docs/guide/agent-skills.md b/content/docs/guide/agent-skills.md index bb341f03f9..4c6411f3dc 100644 --- a/content/docs/guide/agent-skills.md +++ b/content/docs/guide/agent-skills.md @@ -43,10 +43,10 @@ skills/objectui/ ├── rules/ # Non-negotiable global constraints │ ├── protocol.md │ ├── styling.md -│ ├── composition.md -│ └── no-touch-zones.md +│ └── composition.md ├── guides/ # Domain-specific deep dives, loaded on demand │ ├── architecture.md +│ ├── app-composition.md │ ├── page-builder.md │ ├── plugin-development.md │ ├── schema-expressions.md @@ -55,11 +55,18 @@ skills/objectui/ │ ├── testing.md │ ├── i18n.md │ ├── mobile.md -│ ├── auth-permissions.md -│ └── console-development.md +│ └── auth-permissions.md └── evals/ # Machine-checkable prompts (one per guide) ``` +Two files that once shipped in this bundle — `rules/no-touch-zones.md` and +`guides/console-development.md` — moved into the repo-internal +[`.claude/skills/objectui-contributor/`](https://github.com/objectstack-ai/objectui/tree/main/.claude/skills/objectui-contributor) +skill instead. Both talk about paths that only exist inside this monorepo — `apps/console/` +and `packages/components/src/ui/` — which a customer install of the published skill never +has, so they stayed behind as contributor-only guidance rather than shipping to every +consumer. + When the agent picks up a task it: 1. Reads `SKILL.md` for core principles, scope boundaries, and the package map.