You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: src/blog/from-docs-to-agents.md
+19-19Lines changed: 19 additions & 19 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -52,22 +52,22 @@ That `metadata.sources` field is load-bearing. When those docs change, the CLI f
52
52
53
53
## Generating and validating skills
54
54
55
-
You don't author skills from scratch. `@tanstack/intentscaffold` walks you through a guided workflow to generate skills for your library:
55
+
You don't author skills from scratch. `@tanstack/intent scaffold` walks you through a guided workflow to generate skills for your library:
56
56
57
57
```bash
58
-
npx @tanstack/intentscaffold
58
+
npx @tanstack/intent scaffold
59
59
```
60
60
61
-
The scaffold produces drafts you review, refine, and commit alongside your source code. Once you have skills, `@tanstack/intentvalidate` checks that your skill files are well-formed:
61
+
The scaffold produces drafts you review, refine, and commit alongside your source code. Once you have skills, `@tanstack/intent validate` checks that your skill files are well-formed:
62
62
63
63
```bash
64
-
npx @tanstack/intentvalidate
64
+
npx @tanstack/intent validate
65
65
```
66
66
67
-
And `@tanstack/intentsetup` copies CI workflow templates into your repo so validation runs automatically on every push:
67
+
And `@tanstack/intent setup-github-actions` copies CI workflow templates into your repo so validation runs automatically on every push:
68
68
69
69
```bash
70
-
npx @tanstack/intentsetup
70
+
npx @tanstack/intent setup-github-actions
71
71
```
72
72
73
73
This matters because the alternative is hoping model providers eventually re-train on your latest docs. That's not a strategy. Training data has a permanent version-mixing problem: once a breaking change ships, models contain _both_ versions forever with no mechanism to disambiguate. Skills bypass this entirely. They're versioned with your package, and `npm update` brings the latest knowledge with the latest code.
@@ -76,27 +76,27 @@ This matters because the alternative is hoping model providers eventually re-tra
76
76
77
77
## The dependency graph does the discovery
78
78
79
-
When a developer runs `@tanstack/intentinit`, the CLI discovers every intent-enabled package in their project and wires the relevant skills into their agent configuration — CLAUDE.md, .cursorrules, whatever their tooling expects.
79
+
When a developer runs `@tanstack/intent install`, the CLI discovers every intent-enabled package in their project and wires the relevant skills into their agent configuration — CLAUDE.md, .cursorrules, whatever their tooling expects.
80
80
81
81
```bash
82
-
npx @tanstack/intentinit
82
+
npx @tanstack/intent install
83
83
```
84
84
85
85

86
86
87
-
No manual setup per-library. No hunting for rules files. Install the package, run `@tanstack/intentinit`, and the agent understands the tool. Update the package, and the skills update with it. Knowledge travels through the same channel as code.
87
+
No manual setup per-library. No hunting for rules files. Install the package, run `@tanstack/intent install`, and the agent understands the tool. Update the package, and the skills update with it. Knowledge travels through the same channel as code.
88
88
89
-
`@tanstack/intentlist` shows you what's available:
89
+
`@tanstack/intent list` shows you what's available:
90
90
91
91
```bash
92
-
npx @tanstack/intentlist# See what's intent-enabled in your deps
npx @tanstack/intent list# See what's intent-enabled in your deps
93
+
npx @tanstack/intent list --json # Machine-readable output
94
94
```
95
95
96
-
For library maintainers, `@tanstack/intentmeta` surfaces meta-skills — higher-level guidance for how to author and maintain skills for your library:
96
+
For library maintainers, `@tanstack/intent meta` surfaces meta-skills — higher-level guidance for how to author and maintain skills for your library:
97
97
98
98
```bash
99
-
npx @tanstack/intentmeta
99
+
npx @tanstack/intent meta
100
100
```
101
101
102
102
## From skills to playbooks
@@ -111,21 +111,21 @@ The more libraries in your stack that ship skills, the richer the composition st
111
111
112
112
The real risk with any derived artifact is staleness. You update your docs, ship a new API, and the skills silently drift. `@tanstack/intent` treats this as a first-class problem.
113
113
114
-
`@tanstack/intentstale` checks your skills for version drift — flagging any that may have fallen behind their source material:
114
+
`@tanstack/intent stale` checks your skills for version drift — flagging any that may have fallen behind their source material:
115
115
116
116
```bash
117
-
npx @tanstack/intentstale# Human-readable report
118
-
npx @tanstack/intentstale --json # Machine-readable for CI
117
+
npx @tanstack/intent stale# Human-readable report
118
+
npx @tanstack/intent stale --json # Machine-readable for CI
119
119
```
120
120
121
121
Run it in CI and you get a failing check when source material has changed. The skill becomes part of your release checklist — not something you remember to update, something your pipeline catches.
122
122
123
123

124
124
125
-
The feedback loop runs both directions. `@tanstack/intentfeedback` lets users submit structured reports when a skill produces incorrect output — which skill was active, which version, what went wrong. That context flows back to you as a maintainer, and the fix ships to everyone on the next `npm update`.
125
+
The feedback loop runs both directions. `@tanstack/intent feedback` lets users submit structured reports when a skill produces incorrect output — which skill was active, which version, what went wrong. That context flows back to you as a maintainer, and the fix ships to everyone on the next `npm update`.
126
126
127
127
```bash
128
-
npx @tanstack/intentfeedback
128
+
npx @tanstack/intent feedback
129
129
```
130
130
131
131
Skills that keep needing the same workaround are a signal. Sometimes the fix is a better skill. Sometimes it's a better API. A skill that dissolves because the tool absorbed its lesson is the system working as intended.
0 commit comments