@agent-native/core 0.182.0 → 0.182.1-nightly-20260916195744
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/corpus/README.md +1 -1
- package/corpus/templates/analytics/.agents/skills/shadcn-ui/SKILL.md +65 -6
- package/corpus/templates/analytics/.mcp.json +8 -0
- package/corpus/templates/assets/.agents/skills/shadcn-ui/SKILL.md +65 -6
- package/corpus/templates/assets/.mcp.json +8 -0
- package/corpus/templates/brain/.agents/skills/shadcn-ui/SKILL.md +65 -6
- package/corpus/templates/brain/.mcp.json +8 -0
- package/corpus/templates/calendar/.agents/skills/shadcn-ui/SKILL.md +65 -6
- package/corpus/templates/calendar/.mcp.json +8 -0
- package/corpus/templates/chat/.agents/skills/shadcn-ui/SKILL.md +65 -6
- package/corpus/templates/chat/.mcp.json +8 -0
- package/corpus/templates/clips/.agents/skills/shadcn-ui/SKILL.md +65 -6
- package/corpus/templates/clips/.mcp.json +8 -0
- package/corpus/templates/clips/desktop/.mcp.json +8 -0
- package/corpus/templates/content/.agents/skills/shadcn-ui/SKILL.md +65 -6
- package/corpus/templates/content/.mcp.json +8 -0
- package/corpus/templates/crm/.agents/skills/shadcn-ui/SKILL.md +65 -6
- package/corpus/templates/crm/.mcp.json +8 -0
- package/corpus/templates/design/.agents/skills/shadcn-ui/SKILL.md +65 -6
- package/corpus/templates/design/.mcp.json +8 -0
- package/corpus/templates/dispatch/.agents/skills/shadcn-ui/SKILL.md +65 -6
- package/corpus/templates/dispatch/.mcp.json +8 -0
- package/corpus/templates/factory/.agents/skills/shadcn-ui/SKILL.md +65 -6
- package/corpus/templates/factory/.mcp.json +8 -0
- package/corpus/templates/forms/.agents/skills/shadcn-ui/SKILL.md +65 -6
- package/corpus/templates/forms/.mcp.json +8 -0
- package/corpus/templates/mail/.agents/skills/shadcn-ui/SKILL.md +65 -6
- package/corpus/templates/mail/.mcp.json +8 -0
- package/corpus/templates/plan/.agents/skills/shadcn-ui/SKILL.md +65 -6
- package/corpus/templates/plan/.mcp.json +8 -0
- package/corpus/templates/slides/.agents/skills/shadcn-ui/SKILL.md +65 -6
- package/corpus/templates/slides/.mcp.json +8 -0
- package/corpus/templates/tasks/.agents/skills/shadcn-ui/SKILL.md +65 -6
- package/corpus/templates/tasks/.mcp.json +8 -0
- package/dist/collab/routes.d.ts +1 -1
- package/dist/collab/struct-routes.d.ts +1 -1
- package/dist/mcp/screen-memory-stdio.d.ts +7 -7
- package/dist/notifications/routes.d.ts +4 -4
- package/dist/observability/routes.d.ts +8 -8
- package/dist/org/handlers.d.ts +1 -1
- package/dist/progress/routes.d.ts +1 -1
- package/dist/provider-api/actions/provider-api.d.ts +4 -4
- package/dist/resources/handlers.d.ts +1 -1
- package/dist/server/agent-engine-api-key-route.d.ts +1 -1
- package/dist/server/core-routes-plugin.d.ts +1 -1
- package/dist/templates/chat/.agents/skills/shadcn-ui/SKILL.md +65 -6
- package/dist/templates/chat/.mcp.json +8 -0
- package/dist/templates/default/.agents/skills/shadcn-ui/SKILL.md +65 -6
- package/dist/templates/default/.mcp.json +8 -0
- package/dist/templates/workspace-core/.agents/skills/shadcn-ui/SKILL.md +65 -6
- package/dist/templates/workspace-root/package.json +1 -1
- package/dist/templates/workspace-root/pnpm-workspace.yaml +18 -0
- package/package.json +1 -1
- package/src/templates/chat/.agents/skills/shadcn-ui/SKILL.md +65 -6
- package/src/templates/chat/.mcp.json +8 -0
- package/src/templates/default/.agents/skills/shadcn-ui/SKILL.md +65 -6
- package/src/templates/default/.mcp.json +8 -0
- package/src/templates/workspace-core/.agents/skills/shadcn-ui/SKILL.md +65 -6
- package/src/templates/workspace-root/package.json +1 -1
- package/src/templates/workspace-root/pnpm-workspace.yaml +18 -0
|
@@ -1,10 +1,9 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: shadcn-ui
|
|
3
3
|
description: >-
|
|
4
|
-
|
|
5
|
-
when adding
|
|
6
|
-
|
|
7
|
-
file that happens to import a shadcn component.
|
|
4
|
+
Project-aware shadcn/ui components, registry MCP, theming, and design-system
|
|
5
|
+
lint feedback. Use when adding or changing React/Tailwind UI, a primitive,
|
|
6
|
+
theme, registry, or component contract in an Agent-Native app.
|
|
8
7
|
scope: dev
|
|
9
8
|
source: https://ui.shadcn.com/docs/skills
|
|
10
9
|
local-changes: >-
|
|
@@ -16,11 +15,18 @@ metadata:
|
|
|
16
15
|
|
|
17
16
|
# shadcn/ui
|
|
18
17
|
|
|
19
|
-
This skill keeps shadcn/ui work project-aware. Components are source files in the
|
|
18
|
+
This skill keeps shadcn/ui work project-aware. Components are source files in the
|
|
19
|
+
app, so always inspect the local project before adding, importing, or rewriting
|
|
20
|
+
them. When `@shadcn/lint` is configured, treat its feedback as implementation
|
|
21
|
+
guidance, not cosmetic noise. The framework repository runs it through the root
|
|
22
|
+
Oxlint configuration; generated workspaces carry this skill and the MCP
|
|
23
|
+
workflow, but do not automatically inherit that repository-only lint setup.
|
|
20
24
|
|
|
21
25
|
## First Steps
|
|
22
26
|
|
|
23
|
-
1. Work from the app root that owns `components.json`.
|
|
27
|
+
1. Work from the app root that owns `components.json`. In this monorepo, that is
|
|
28
|
+
the selected app/template directory (usually under `templates/`), not the
|
|
29
|
+
repository root.
|
|
24
30
|
2. In an Agent-Native app, inspect `app/design-system.ts` and
|
|
25
31
|
`ToolkitProvider` before choosing a primitive. A registered company design
|
|
26
32
|
system takes precedence over the default shadcn adapter.
|
|
@@ -29,6 +35,59 @@ This skill keeps shadcn/ui work project-aware. Components are source files in th
|
|
|
29
35
|
5. Check `app/components/ui/` or the resolved `ui` path before importing a component.
|
|
30
36
|
6. For unfamiliar components, run `pnpm dlx shadcn@latest docs <component>` and read the returned docs or examples before coding.
|
|
31
37
|
|
|
38
|
+
## MCP Registry Workflow
|
|
39
|
+
|
|
40
|
+
Each first-party app keeps the official shadcn MCP configuration in `.mcp.json`
|
|
41
|
+
next to its `components.json`. Start the agent from that app root so the MCP
|
|
42
|
+
server resolves the correct aliases, local UI directory, and Tailwind theme.
|
|
43
|
+
Do not add a single repository-root server: the root is a workspace, not a
|
|
44
|
+
shadcn project, and would make installs target the wrong project.
|
|
45
|
+
|
|
46
|
+
- Use the shadcn MCP to search, inspect, and install registry items when it is
|
|
47
|
+
connected. Prefer the app's configured registries over copied source.
|
|
48
|
+
- Use `pnpm dlx shadcn@latest info --json` for project context; the MCP has no
|
|
49
|
+
equivalent project-info tool.
|
|
50
|
+
- If the MCP is unavailable, use the equivalent `pnpm dlx shadcn@latest`
|
|
51
|
+
command from the same app root and continue following this skill.
|
|
52
|
+
- Keep registry URLs and aliases in that app's `components.json`. Never put
|
|
53
|
+
registry credentials in MCP config or checked-in source.
|
|
54
|
+
|
|
55
|
+
## Design-System Lint Feedback
|
|
56
|
+
|
|
57
|
+
In the framework repository, `pnpm lint` runs Oxlint with `@shadcn/lint` for the
|
|
58
|
+
scoped template UI paths. Run it after UI changes and fix every `shadcn/*`
|
|
59
|
+
finding before handing off. Template packages use the workspace lint
|
|
60
|
+
configuration; do not create a second local lint configuration just for one
|
|
61
|
+
app.
|
|
62
|
+
|
|
63
|
+
Before claiming that shadcn lint ran in another workspace, inspect its root
|
|
64
|
+
`package.json` and `.oxlintrc.json`. The generic generated workspace currently
|
|
65
|
+
exposes `pnpm lint` as formatting-only and does not ship `@shadcn/lint` or the
|
|
66
|
+
framework repository's Oxlint config. In that scaffold, use this skill plus the
|
|
67
|
+
connected shadcn MCP (or the CLI fallback) for design-system guidance, and do
|
|
68
|
+
not report `shadcn/*` checks as having run. If the workspace owner adopts the
|
|
69
|
+
linter, add the dependency, scoped config, and lint script together.
|
|
70
|
+
|
|
71
|
+
The Plan template is intentionally excluded from this rollout. Its files remain
|
|
72
|
+
under `templates/plan/**`, but the root Oxlint ignore list keeps them out of the
|
|
73
|
+
shadcn checks until that template has a separate lint baseline.
|
|
74
|
+
|
|
75
|
+
- `no-restyle`: use the component's `variant`, `size`, and semantic props; put
|
|
76
|
+
layout on a parent and add a component variant only when the design system
|
|
77
|
+
genuinely needs a new treatment.
|
|
78
|
+
- `no-raw-colors`: use the theme tokens in the app's `global.css`, not raw
|
|
79
|
+
Tailwind palette classes or hard-coded color attributes.
|
|
80
|
+
- `no-arbitrary-values`: use the theme scale or a declared token instead of
|
|
81
|
+
one-off bracket values.
|
|
82
|
+
- `no-inline-styles`: use classes or CSS custom properties for dynamic layout;
|
|
83
|
+
keep intentional editor/export exceptions scoped to their owning subsystem.
|
|
84
|
+
- `no-unknown-classes` and `require-static-classes`: use classes Tailwind can
|
|
85
|
+
generate and keep class strings statically discoverable.
|
|
86
|
+
|
|
87
|
+
The local primitive source is the contract boundary. Product code should consume
|
|
88
|
+
its props and variants; update `packages/toolkit/src/ui/` or an app's
|
|
89
|
+
`components/ui/` only when the design-system contract itself changes.
|
|
90
|
+
|
|
32
91
|
## Agent-Native Adapter Rule
|
|
33
92
|
|
|
34
93
|
Pages, routes, and domain components import controls through the app's local UI
|
|
@@ -1,10 +1,9 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: shadcn-ui
|
|
3
3
|
description: >-
|
|
4
|
-
|
|
5
|
-
when adding
|
|
6
|
-
|
|
7
|
-
file that happens to import a shadcn component.
|
|
4
|
+
Project-aware shadcn/ui components, registry MCP, theming, and design-system
|
|
5
|
+
lint feedback. Use when adding or changing React/Tailwind UI, a primitive,
|
|
6
|
+
theme, registry, or component contract in an Agent-Native app.
|
|
8
7
|
scope: dev
|
|
9
8
|
source: https://ui.shadcn.com/docs/skills
|
|
10
9
|
local-changes: >-
|
|
@@ -16,11 +15,18 @@ metadata:
|
|
|
16
15
|
|
|
17
16
|
# shadcn/ui
|
|
18
17
|
|
|
19
|
-
This skill keeps shadcn/ui work project-aware. Components are source files in the
|
|
18
|
+
This skill keeps shadcn/ui work project-aware. Components are source files in the
|
|
19
|
+
app, so always inspect the local project before adding, importing, or rewriting
|
|
20
|
+
them. When `@shadcn/lint` is configured, treat its feedback as implementation
|
|
21
|
+
guidance, not cosmetic noise. The framework repository runs it through the root
|
|
22
|
+
Oxlint configuration; generated workspaces carry this skill and the MCP
|
|
23
|
+
workflow, but do not automatically inherit that repository-only lint setup.
|
|
20
24
|
|
|
21
25
|
## First Steps
|
|
22
26
|
|
|
23
|
-
1. Work from the app root that owns `components.json`.
|
|
27
|
+
1. Work from the app root that owns `components.json`. In this monorepo, that is
|
|
28
|
+
the selected app/template directory (usually under `templates/`), not the
|
|
29
|
+
repository root.
|
|
24
30
|
2. In an Agent-Native app, inspect `app/design-system.ts` and
|
|
25
31
|
`ToolkitProvider` before choosing a primitive. A registered company design
|
|
26
32
|
system takes precedence over the default shadcn adapter.
|
|
@@ -29,6 +35,59 @@ This skill keeps shadcn/ui work project-aware. Components are source files in th
|
|
|
29
35
|
5. Check `app/components/ui/` or the resolved `ui` path before importing a component.
|
|
30
36
|
6. For unfamiliar components, run `pnpm dlx shadcn@latest docs <component>` and read the returned docs or examples before coding.
|
|
31
37
|
|
|
38
|
+
## MCP Registry Workflow
|
|
39
|
+
|
|
40
|
+
Each first-party app keeps the official shadcn MCP configuration in `.mcp.json`
|
|
41
|
+
next to its `components.json`. Start the agent from that app root so the MCP
|
|
42
|
+
server resolves the correct aliases, local UI directory, and Tailwind theme.
|
|
43
|
+
Do not add a single repository-root server: the root is a workspace, not a
|
|
44
|
+
shadcn project, and would make installs target the wrong project.
|
|
45
|
+
|
|
46
|
+
- Use the shadcn MCP to search, inspect, and install registry items when it is
|
|
47
|
+
connected. Prefer the app's configured registries over copied source.
|
|
48
|
+
- Use `pnpm dlx shadcn@latest info --json` for project context; the MCP has no
|
|
49
|
+
equivalent project-info tool.
|
|
50
|
+
- If the MCP is unavailable, use the equivalent `pnpm dlx shadcn@latest`
|
|
51
|
+
command from the same app root and continue following this skill.
|
|
52
|
+
- Keep registry URLs and aliases in that app's `components.json`. Never put
|
|
53
|
+
registry credentials in MCP config or checked-in source.
|
|
54
|
+
|
|
55
|
+
## Design-System Lint Feedback
|
|
56
|
+
|
|
57
|
+
In the framework repository, `pnpm lint` runs Oxlint with `@shadcn/lint` for the
|
|
58
|
+
scoped template UI paths. Run it after UI changes and fix every `shadcn/*`
|
|
59
|
+
finding before handing off. Template packages use the workspace lint
|
|
60
|
+
configuration; do not create a second local lint configuration just for one
|
|
61
|
+
app.
|
|
62
|
+
|
|
63
|
+
Before claiming that shadcn lint ran in another workspace, inspect its root
|
|
64
|
+
`package.json` and `.oxlintrc.json`. The generic generated workspace currently
|
|
65
|
+
exposes `pnpm lint` as formatting-only and does not ship `@shadcn/lint` or the
|
|
66
|
+
framework repository's Oxlint config. In that scaffold, use this skill plus the
|
|
67
|
+
connected shadcn MCP (or the CLI fallback) for design-system guidance, and do
|
|
68
|
+
not report `shadcn/*` checks as having run. If the workspace owner adopts the
|
|
69
|
+
linter, add the dependency, scoped config, and lint script together.
|
|
70
|
+
|
|
71
|
+
The Plan template is intentionally excluded from this rollout. Its files remain
|
|
72
|
+
under `templates/plan/**`, but the root Oxlint ignore list keeps them out of the
|
|
73
|
+
shadcn checks until that template has a separate lint baseline.
|
|
74
|
+
|
|
75
|
+
- `no-restyle`: use the component's `variant`, `size`, and semantic props; put
|
|
76
|
+
layout on a parent and add a component variant only when the design system
|
|
77
|
+
genuinely needs a new treatment.
|
|
78
|
+
- `no-raw-colors`: use the theme tokens in the app's `global.css`, not raw
|
|
79
|
+
Tailwind palette classes or hard-coded color attributes.
|
|
80
|
+
- `no-arbitrary-values`: use the theme scale or a declared token instead of
|
|
81
|
+
one-off bracket values.
|
|
82
|
+
- `no-inline-styles`: use classes or CSS custom properties for dynamic layout;
|
|
83
|
+
keep intentional editor/export exceptions scoped to their owning subsystem.
|
|
84
|
+
- `no-unknown-classes` and `require-static-classes`: use classes Tailwind can
|
|
85
|
+
generate and keep class strings statically discoverable.
|
|
86
|
+
|
|
87
|
+
The local primitive source is the contract boundary. Product code should consume
|
|
88
|
+
its props and variants; update `packages/toolkit/src/ui/` or an app's
|
|
89
|
+
`components/ui/` only when the design-system contract itself changes.
|
|
90
|
+
|
|
32
91
|
## Agent-Native Adapter Rule
|
|
33
92
|
|
|
34
93
|
Pages, routes, and domain components import controls through the app's local UI
|
|
@@ -1,10 +1,9 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: shadcn-ui
|
|
3
3
|
description: >-
|
|
4
|
-
|
|
5
|
-
when adding
|
|
6
|
-
|
|
7
|
-
file that happens to import a shadcn component.
|
|
4
|
+
Project-aware shadcn/ui components, registry MCP, theming, and design-system
|
|
5
|
+
lint feedback. Use when adding or changing React/Tailwind UI, a primitive,
|
|
6
|
+
theme, registry, or component contract in an Agent-Native app.
|
|
8
7
|
scope: dev
|
|
9
8
|
source: https://ui.shadcn.com/docs/skills
|
|
10
9
|
local-changes: >-
|
|
@@ -16,11 +15,18 @@ metadata:
|
|
|
16
15
|
|
|
17
16
|
# shadcn/ui
|
|
18
17
|
|
|
19
|
-
This skill keeps shadcn/ui work project-aware. Components are source files in the
|
|
18
|
+
This skill keeps shadcn/ui work project-aware. Components are source files in the
|
|
19
|
+
app, so always inspect the local project before adding, importing, or rewriting
|
|
20
|
+
them. When `@shadcn/lint` is configured, treat its feedback as implementation
|
|
21
|
+
guidance, not cosmetic noise. The framework repository runs it through the root
|
|
22
|
+
Oxlint configuration; generated workspaces carry this skill and the MCP
|
|
23
|
+
workflow, but do not automatically inherit that repository-only lint setup.
|
|
20
24
|
|
|
21
25
|
## First Steps
|
|
22
26
|
|
|
23
|
-
1. Work from the app root that owns `components.json`.
|
|
27
|
+
1. Work from the app root that owns `components.json`. In this monorepo, that is
|
|
28
|
+
the selected app/template directory (usually under `templates/`), not the
|
|
29
|
+
repository root.
|
|
24
30
|
2. In an Agent-Native app, inspect `app/design-system.ts` and
|
|
25
31
|
`ToolkitProvider` before choosing a primitive. A registered company design
|
|
26
32
|
system takes precedence over the default shadcn adapter.
|
|
@@ -29,6 +35,59 @@ This skill keeps shadcn/ui work project-aware. Components are source files in th
|
|
|
29
35
|
5. Check `app/components/ui/` or the resolved `ui` path before importing a component.
|
|
30
36
|
6. For unfamiliar components, run `pnpm dlx shadcn@latest docs <component>` and read the returned docs or examples before coding.
|
|
31
37
|
|
|
38
|
+
## MCP Registry Workflow
|
|
39
|
+
|
|
40
|
+
Each first-party app keeps the official shadcn MCP configuration in `.mcp.json`
|
|
41
|
+
next to its `components.json`. Start the agent from that app root so the MCP
|
|
42
|
+
server resolves the correct aliases, local UI directory, and Tailwind theme.
|
|
43
|
+
Do not add a single repository-root server: the root is a workspace, not a
|
|
44
|
+
shadcn project, and would make installs target the wrong project.
|
|
45
|
+
|
|
46
|
+
- Use the shadcn MCP to search, inspect, and install registry items when it is
|
|
47
|
+
connected. Prefer the app's configured registries over copied source.
|
|
48
|
+
- Use `pnpm dlx shadcn@latest info --json` for project context; the MCP has no
|
|
49
|
+
equivalent project-info tool.
|
|
50
|
+
- If the MCP is unavailable, use the equivalent `pnpm dlx shadcn@latest`
|
|
51
|
+
command from the same app root and continue following this skill.
|
|
52
|
+
- Keep registry URLs and aliases in that app's `components.json`. Never put
|
|
53
|
+
registry credentials in MCP config or checked-in source.
|
|
54
|
+
|
|
55
|
+
## Design-System Lint Feedback
|
|
56
|
+
|
|
57
|
+
In the framework repository, `pnpm lint` runs Oxlint with `@shadcn/lint` for the
|
|
58
|
+
scoped template UI paths. Run it after UI changes and fix every `shadcn/*`
|
|
59
|
+
finding before handing off. Template packages use the workspace lint
|
|
60
|
+
configuration; do not create a second local lint configuration just for one
|
|
61
|
+
app.
|
|
62
|
+
|
|
63
|
+
Before claiming that shadcn lint ran in another workspace, inspect its root
|
|
64
|
+
`package.json` and `.oxlintrc.json`. The generic generated workspace currently
|
|
65
|
+
exposes `pnpm lint` as formatting-only and does not ship `@shadcn/lint` or the
|
|
66
|
+
framework repository's Oxlint config. In that scaffold, use this skill plus the
|
|
67
|
+
connected shadcn MCP (or the CLI fallback) for design-system guidance, and do
|
|
68
|
+
not report `shadcn/*` checks as having run. If the workspace owner adopts the
|
|
69
|
+
linter, add the dependency, scoped config, and lint script together.
|
|
70
|
+
|
|
71
|
+
The Plan template is intentionally excluded from this rollout. Its files remain
|
|
72
|
+
under `templates/plan/**`, but the root Oxlint ignore list keeps them out of the
|
|
73
|
+
shadcn checks until that template has a separate lint baseline.
|
|
74
|
+
|
|
75
|
+
- `no-restyle`: use the component's `variant`, `size`, and semantic props; put
|
|
76
|
+
layout on a parent and add a component variant only when the design system
|
|
77
|
+
genuinely needs a new treatment.
|
|
78
|
+
- `no-raw-colors`: use the theme tokens in the app's `global.css`, not raw
|
|
79
|
+
Tailwind palette classes or hard-coded color attributes.
|
|
80
|
+
- `no-arbitrary-values`: use the theme scale or a declared token instead of
|
|
81
|
+
one-off bracket values.
|
|
82
|
+
- `no-inline-styles`: use classes or CSS custom properties for dynamic layout;
|
|
83
|
+
keep intentional editor/export exceptions scoped to their owning subsystem.
|
|
84
|
+
- `no-unknown-classes` and `require-static-classes`: use classes Tailwind can
|
|
85
|
+
generate and keep class strings statically discoverable.
|
|
86
|
+
|
|
87
|
+
The local primitive source is the contract boundary. Product code should consume
|
|
88
|
+
its props and variants; update `packages/toolkit/src/ui/` or an app's
|
|
89
|
+
`components/ui/` only when the design-system contract itself changes.
|
|
90
|
+
|
|
32
91
|
## Agent-Native Adapter Rule
|
|
33
92
|
|
|
34
93
|
Pages, routes, and domain components import controls through the app's local UI
|
|
@@ -1,10 +1,9 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: shadcn-ui
|
|
3
3
|
description: >-
|
|
4
|
-
|
|
5
|
-
when adding
|
|
6
|
-
|
|
7
|
-
file that happens to import a shadcn component.
|
|
4
|
+
Project-aware shadcn/ui components, registry MCP, theming, and design-system
|
|
5
|
+
lint feedback. Use when adding or changing React/Tailwind UI, a primitive,
|
|
6
|
+
theme, registry, or component contract in an Agent-Native app.
|
|
8
7
|
scope: dev
|
|
9
8
|
source: https://ui.shadcn.com/docs/skills
|
|
10
9
|
local-changes: >-
|
|
@@ -16,11 +15,18 @@ metadata:
|
|
|
16
15
|
|
|
17
16
|
# shadcn/ui
|
|
18
17
|
|
|
19
|
-
This skill keeps shadcn/ui work project-aware. Components are source files in the
|
|
18
|
+
This skill keeps shadcn/ui work project-aware. Components are source files in the
|
|
19
|
+
app, so always inspect the local project before adding, importing, or rewriting
|
|
20
|
+
them. When `@shadcn/lint` is configured, treat its feedback as implementation
|
|
21
|
+
guidance, not cosmetic noise. The framework repository runs it through the root
|
|
22
|
+
Oxlint configuration; generated workspaces carry this skill and the MCP
|
|
23
|
+
workflow, but do not automatically inherit that repository-only lint setup.
|
|
20
24
|
|
|
21
25
|
## First Steps
|
|
22
26
|
|
|
23
|
-
1. Work from the app root that owns `components.json`.
|
|
27
|
+
1. Work from the app root that owns `components.json`. In this monorepo, that is
|
|
28
|
+
the selected app/template directory (usually under `templates/`), not the
|
|
29
|
+
repository root.
|
|
24
30
|
2. In an Agent-Native app, inspect `app/design-system.ts` and
|
|
25
31
|
`ToolkitProvider` before choosing a primitive. A registered company design
|
|
26
32
|
system takes precedence over the default shadcn adapter.
|
|
@@ -29,6 +35,59 @@ This skill keeps shadcn/ui work project-aware. Components are source files in th
|
|
|
29
35
|
5. Check `app/components/ui/` or the resolved `ui` path before importing a component.
|
|
30
36
|
6. For unfamiliar components, run `pnpm dlx shadcn@latest docs <component>` and read the returned docs or examples before coding.
|
|
31
37
|
|
|
38
|
+
## MCP Registry Workflow
|
|
39
|
+
|
|
40
|
+
Each first-party app keeps the official shadcn MCP configuration in `.mcp.json`
|
|
41
|
+
next to its `components.json`. Start the agent from that app root so the MCP
|
|
42
|
+
server resolves the correct aliases, local UI directory, and Tailwind theme.
|
|
43
|
+
Do not add a single repository-root server: the root is a workspace, not a
|
|
44
|
+
shadcn project, and would make installs target the wrong project.
|
|
45
|
+
|
|
46
|
+
- Use the shadcn MCP to search, inspect, and install registry items when it is
|
|
47
|
+
connected. Prefer the app's configured registries over copied source.
|
|
48
|
+
- Use `pnpm dlx shadcn@latest info --json` for project context; the MCP has no
|
|
49
|
+
equivalent project-info tool.
|
|
50
|
+
- If the MCP is unavailable, use the equivalent `pnpm dlx shadcn@latest`
|
|
51
|
+
command from the same app root and continue following this skill.
|
|
52
|
+
- Keep registry URLs and aliases in that app's `components.json`. Never put
|
|
53
|
+
registry credentials in MCP config or checked-in source.
|
|
54
|
+
|
|
55
|
+
## Design-System Lint Feedback
|
|
56
|
+
|
|
57
|
+
In the framework repository, `pnpm lint` runs Oxlint with `@shadcn/lint` for the
|
|
58
|
+
scoped template UI paths. Run it after UI changes and fix every `shadcn/*`
|
|
59
|
+
finding before handing off. Template packages use the workspace lint
|
|
60
|
+
configuration; do not create a second local lint configuration just for one
|
|
61
|
+
app.
|
|
62
|
+
|
|
63
|
+
Before claiming that shadcn lint ran in another workspace, inspect its root
|
|
64
|
+
`package.json` and `.oxlintrc.json`. The generic generated workspace currently
|
|
65
|
+
exposes `pnpm lint` as formatting-only and does not ship `@shadcn/lint` or the
|
|
66
|
+
framework repository's Oxlint config. In that scaffold, use this skill plus the
|
|
67
|
+
connected shadcn MCP (or the CLI fallback) for design-system guidance, and do
|
|
68
|
+
not report `shadcn/*` checks as having run. If the workspace owner adopts the
|
|
69
|
+
linter, add the dependency, scoped config, and lint script together.
|
|
70
|
+
|
|
71
|
+
The Plan template is intentionally excluded from this rollout. Its files remain
|
|
72
|
+
under `templates/plan/**`, but the root Oxlint ignore list keeps them out of the
|
|
73
|
+
shadcn checks until that template has a separate lint baseline.
|
|
74
|
+
|
|
75
|
+
- `no-restyle`: use the component's `variant`, `size`, and semantic props; put
|
|
76
|
+
layout on a parent and add a component variant only when the design system
|
|
77
|
+
genuinely needs a new treatment.
|
|
78
|
+
- `no-raw-colors`: use the theme tokens in the app's `global.css`, not raw
|
|
79
|
+
Tailwind palette classes or hard-coded color attributes.
|
|
80
|
+
- `no-arbitrary-values`: use the theme scale or a declared token instead of
|
|
81
|
+
one-off bracket values.
|
|
82
|
+
- `no-inline-styles`: use classes or CSS custom properties for dynamic layout;
|
|
83
|
+
keep intentional editor/export exceptions scoped to their owning subsystem.
|
|
84
|
+
- `no-unknown-classes` and `require-static-classes`: use classes Tailwind can
|
|
85
|
+
generate and keep class strings statically discoverable.
|
|
86
|
+
|
|
87
|
+
The local primitive source is the contract boundary. Product code should consume
|
|
88
|
+
its props and variants; update `packages/toolkit/src/ui/` or an app's
|
|
89
|
+
`components/ui/` only when the design-system contract itself changes.
|
|
90
|
+
|
|
32
91
|
## Agent-Native Adapter Rule
|
|
33
92
|
|
|
34
93
|
Pages, routes, and domain components import controls through the app's local UI
|
package/dist/collab/routes.d.ts
CHANGED
|
@@ -26,8 +26,8 @@ export declare const getCollabState: import("h3").EventHandlerWithFetch<import("
|
|
|
26
26
|
* Body: { update: string (base64), requestSource?: string }
|
|
27
27
|
*/
|
|
28
28
|
export declare const postCollabUpdate: import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<{
|
|
29
|
-
error: string;
|
|
30
29
|
ok?: undefined;
|
|
30
|
+
error: string;
|
|
31
31
|
} | {
|
|
32
32
|
error?: undefined;
|
|
33
33
|
ok: boolean;
|
|
@@ -13,8 +13,8 @@
|
|
|
13
13
|
* Body: { json: any, fieldName?: string, type?: "map"|"array", requestSource?: string }
|
|
14
14
|
*/
|
|
15
15
|
export declare const postCollabJson: import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<{
|
|
16
|
-
ok?: undefined;
|
|
17
16
|
error: string;
|
|
17
|
+
ok?: undefined;
|
|
18
18
|
} | {
|
|
19
19
|
error?: undefined;
|
|
20
20
|
ok: boolean;
|
|
@@ -137,13 +137,13 @@ export declare function screenMemoryMcpToolDefinitions(): ({
|
|
|
137
137
|
inputSchema: {
|
|
138
138
|
type: string;
|
|
139
139
|
properties: {
|
|
140
|
-
count?: undefined;
|
|
141
140
|
query?: undefined;
|
|
142
141
|
minutes?: undefined;
|
|
143
142
|
limit?: undefined;
|
|
144
143
|
clientHint?: undefined;
|
|
145
144
|
timestamp?: undefined;
|
|
146
145
|
chapterId?: undefined;
|
|
146
|
+
count?: undefined;
|
|
147
147
|
startAt?: undefined;
|
|
148
148
|
endAt?: undefined;
|
|
149
149
|
reason?: undefined;
|
|
@@ -159,7 +159,6 @@ export declare function screenMemoryMcpToolDefinitions(): ({
|
|
|
159
159
|
inputSchema: {
|
|
160
160
|
type: string;
|
|
161
161
|
properties: {
|
|
162
|
-
count?: undefined;
|
|
163
162
|
query: {
|
|
164
163
|
type: string;
|
|
165
164
|
description: string;
|
|
@@ -175,6 +174,7 @@ export declare function screenMemoryMcpToolDefinitions(): ({
|
|
|
175
174
|
clientHint?: undefined;
|
|
176
175
|
timestamp?: undefined;
|
|
177
176
|
chapterId?: undefined;
|
|
177
|
+
count?: undefined;
|
|
178
178
|
startAt?: undefined;
|
|
179
179
|
endAt?: undefined;
|
|
180
180
|
reason?: undefined;
|
|
@@ -190,7 +190,6 @@ export declare function screenMemoryMcpToolDefinitions(): ({
|
|
|
190
190
|
inputSchema: {
|
|
191
191
|
type: string;
|
|
192
192
|
properties: {
|
|
193
|
-
count?: undefined;
|
|
194
193
|
minutes: {
|
|
195
194
|
type: string;
|
|
196
195
|
description: string;
|
|
@@ -200,6 +199,7 @@ export declare function screenMemoryMcpToolDefinitions(): ({
|
|
|
200
199
|
clientHint?: undefined;
|
|
201
200
|
timestamp?: undefined;
|
|
202
201
|
chapterId?: undefined;
|
|
202
|
+
count?: undefined;
|
|
203
203
|
startAt?: undefined;
|
|
204
204
|
endAt?: undefined;
|
|
205
205
|
reason?: undefined;
|
|
@@ -216,7 +216,6 @@ export declare function screenMemoryMcpToolDefinitions(): ({
|
|
|
216
216
|
type: string;
|
|
217
217
|
required: string[];
|
|
218
218
|
properties: {
|
|
219
|
-
count?: undefined;
|
|
220
219
|
query: {
|
|
221
220
|
type: string;
|
|
222
221
|
description: string;
|
|
@@ -235,6 +234,7 @@ export declare function screenMemoryMcpToolDefinitions(): ({
|
|
|
235
234
|
};
|
|
236
235
|
timestamp?: undefined;
|
|
237
236
|
chapterId?: undefined;
|
|
237
|
+
count?: undefined;
|
|
238
238
|
startAt?: undefined;
|
|
239
239
|
endAt?: undefined;
|
|
240
240
|
reason?: undefined;
|
|
@@ -250,7 +250,6 @@ export declare function screenMemoryMcpToolDefinitions(): ({
|
|
|
250
250
|
type: string;
|
|
251
251
|
required: string[];
|
|
252
252
|
properties: {
|
|
253
|
-
count?: undefined;
|
|
254
253
|
query?: undefined;
|
|
255
254
|
minutes?: undefined;
|
|
256
255
|
limit?: undefined;
|
|
@@ -264,6 +263,7 @@ export declare function screenMemoryMcpToolDefinitions(): ({
|
|
|
264
263
|
description: string;
|
|
265
264
|
};
|
|
266
265
|
chapterId?: undefined;
|
|
266
|
+
count?: undefined;
|
|
267
267
|
startAt?: undefined;
|
|
268
268
|
endAt?: undefined;
|
|
269
269
|
includeMicrophone?: undefined;
|
|
@@ -314,13 +314,13 @@ export declare function screenMemoryMcpToolDefinitions(): ({
|
|
|
314
314
|
type: string;
|
|
315
315
|
required: string[];
|
|
316
316
|
properties: {
|
|
317
|
-
count?: undefined;
|
|
318
317
|
query?: undefined;
|
|
319
318
|
minutes?: undefined;
|
|
320
319
|
limit?: undefined;
|
|
321
320
|
clientHint?: undefined;
|
|
322
321
|
timestamp?: undefined;
|
|
323
322
|
chapterId?: undefined;
|
|
323
|
+
count?: undefined;
|
|
324
324
|
startAt: {
|
|
325
325
|
type: string;
|
|
326
326
|
description: string;
|
|
@@ -349,13 +349,13 @@ export declare function screenMemoryMcpToolDefinitions(): ({
|
|
|
349
349
|
type: string;
|
|
350
350
|
required: string[];
|
|
351
351
|
properties: {
|
|
352
|
-
count?: undefined;
|
|
353
352
|
query?: undefined;
|
|
354
353
|
minutes?: undefined;
|
|
355
354
|
limit?: undefined;
|
|
356
355
|
clientHint?: undefined;
|
|
357
356
|
timestamp?: undefined;
|
|
358
357
|
chapterId?: undefined;
|
|
358
|
+
count?: undefined;
|
|
359
359
|
startAt?: undefined;
|
|
360
360
|
endAt?: undefined;
|
|
361
361
|
reason?: undefined;
|
|
@@ -16,18 +16,18 @@ export declare function createNotificationsHandler(): import("h3").EventHandlerW
|
|
|
16
16
|
error?: undefined;
|
|
17
17
|
ok?: undefined;
|
|
18
18
|
} | {
|
|
19
|
-
count?: undefined;
|
|
20
19
|
updated: number;
|
|
21
20
|
error?: undefined;
|
|
22
21
|
ok?: undefined;
|
|
23
|
-
} | {
|
|
24
22
|
count?: undefined;
|
|
23
|
+
} | {
|
|
25
24
|
updated?: undefined;
|
|
26
25
|
error: string;
|
|
27
26
|
ok?: undefined;
|
|
28
|
-
} | {
|
|
29
27
|
count?: undefined;
|
|
28
|
+
} | {
|
|
30
29
|
updated?: undefined;
|
|
31
|
-
ok: boolean;
|
|
32
30
|
error?: undefined;
|
|
31
|
+
ok: boolean;
|
|
32
|
+
count?: undefined;
|
|
33
33
|
}>>;
|
|
@@ -41,27 +41,27 @@ export declare function createObservabilityHandler(): import("h3").EventHandlerW
|
|
|
41
41
|
thumbsUpRate: number;
|
|
42
42
|
avgEvalScore: number;
|
|
43
43
|
} | {
|
|
44
|
-
|
|
44
|
+
error?: undefined;
|
|
45
|
+
ok?: undefined;
|
|
45
46
|
summary: import("./types.js").TraceSummary;
|
|
46
47
|
spans: import("./types.js").TraceSpan[];
|
|
48
|
+
id?: undefined;
|
|
49
|
+
} | {
|
|
47
50
|
error?: undefined;
|
|
48
51
|
ok?: undefined;
|
|
49
|
-
} | {
|
|
50
52
|
summary?: undefined;
|
|
51
53
|
spans?: undefined;
|
|
52
54
|
id: string;
|
|
53
|
-
error?: undefined;
|
|
54
|
-
ok?: undefined;
|
|
55
55
|
} | {
|
|
56
|
-
|
|
56
|
+
ok?: undefined;
|
|
57
57
|
summary?: undefined;
|
|
58
58
|
spans?: undefined;
|
|
59
|
+
id?: undefined;
|
|
59
60
|
error: any;
|
|
60
|
-
ok?: undefined;
|
|
61
61
|
} | {
|
|
62
|
-
|
|
62
|
+
error?: undefined;
|
|
63
63
|
summary?: undefined;
|
|
64
64
|
spans?: undefined;
|
|
65
|
+
id?: undefined;
|
|
65
66
|
ok: boolean;
|
|
66
|
-
error?: undefined;
|
|
67
67
|
}>>;
|
package/dist/org/handlers.d.ts
CHANGED
|
@@ -52,9 +52,9 @@ export declare const setWorkspaceAppDefaultVisibilityHandler: import("h3").Event
|
|
|
52
52
|
}>>;
|
|
53
53
|
/** POST /_agent-native/org — create a new organization */
|
|
54
54
|
export declare const createOrgHandler: import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<{
|
|
55
|
+
name?: undefined;
|
|
55
56
|
success: boolean;
|
|
56
57
|
id?: undefined;
|
|
57
|
-
name?: undefined;
|
|
58
58
|
role?: undefined;
|
|
59
59
|
} | {
|
|
60
60
|
success?: undefined;
|