|
1 | 1 | --- |
2 | | -title: "From Docs to Agents: Shipping Knowledge That Travels With Your Package" |
| 2 | +title: 'From Docs to Agents: Shipping Knowledge That Travels With Your Package' |
3 | 3 | published: 2026-03-04 |
4 | 4 | authors: |
5 | 5 | - Sarah Gerrard |
|
8 | 8 |
|
9 | 9 | Your docs are good. Your types are solid. Your agent still gets it wrong. |
10 | 10 |
|
11 | | -Not because it's dumb — because nothing connects what you know about your tool to what agents know. Docs target humans who browse. Types check individual API calls but can't encode intent. Training data snapshots the ecosystem as it *was*, mixing versions without flagging which applies. The gap isn't content. It's lifecycle. |
| 11 | +Not because it's dumb — because nothing connects what you know about your tool to what agents know. Docs target humans who browse. Types check individual API calls but can't encode intent. Training data snapshots the ecosystem as it _was_, mixing versions without flagging which applies. The gap isn't content. It's lifecycle. |
12 | 12 |
|
13 | 13 | ## Skills as side quests |
14 | 14 |
|
@@ -72,7 +72,7 @@ npx intent validate |
72 | 72 | npx intent setup |
73 | 73 | ``` |
74 | 74 |
|
75 | | -The alternative — hoping model providers re-train on your latest docs — is not a strategy. Training data has a permanent version-mixing problem: once a breaking change ships, models contain *both* versions forever with no way to disambiguate. Skills bypass this. They're versioned with your package, and `npm update` brings the latest knowledge with the latest code. |
| 75 | +The alternative — hoping model providers re-train on your latest docs — is not a strategy. Training data has a permanent version-mixing problem: once a breaking change ships, models contain _both_ versions forever with no way to disambiguate. Skills bypass this. They're versioned with your package, and `npm update` brings the latest knowledge with the latest code. |
76 | 76 |
|
77 | 77 |  |
78 | 78 |
|
@@ -103,7 +103,7 @@ npx intent meta |
103 | 103 |
|
104 | 104 | ## From skills to playbooks |
105 | 105 |
|
106 | | -A single skill helps an agent use one tool correctly. Real development demands composition — routing *with* server state *with* a data grid *with* client-side storage. No single skill covers how they fit together. |
| 106 | +A single skill helps an agent use one tool correctly. Real development demands composition — routing _with_ server state _with_ a data grid _with_ client-side storage. No single skill covers how they fit together. |
107 | 107 |
|
108 | 108 | Playbooks orchestrate. A developer says "build a paginated data table with URL-synced filters" and the playbook loads the right skills in the right order — search params, loader/query integration, table columnDefs. Goals map to skill combinations. |
109 | 109 |
|
@@ -138,4 +138,4 @@ Devtool makers have a new surface to maintain. You shipped code, docs, and types |
138 | 138 |
|
139 | 139 | Tools that invest here produce developers who build confidently from day one — not through tutorials or toy projects, but through correct patterns absorbed in real work. |
140 | 140 |
|
141 | | -The lifecycle is: write your docs, generate skills, ship them with your package, validate and keep them current, learn from how they're used, make your tool better. Repeat. |
| 141 | +The lifecycle is: write your docs, generate skills, ship them with your package, validate and keep them current, learn from how they're used, make your tool better. Repeat. |
0 commit comments