@agentskit/doc-bridge 1.2.1 → 1.2.4
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/CHANGELOG.md +19 -1
- package/CONTRIBUTING.md +1 -1
- package/README.md +3 -3
- package/action.yml +9 -2
- package/dist/cli/program.js +18 -5
- package/dist/cli/program.js.map +1 -1
- package/dist/index.d.ts +39 -2
- package/dist/index.js +46 -5
- package/dist/index.js.map +1 -1
- package/docs/MARKETPLACE.md +6 -0
- package/docs/POSITIONING.md +12 -1
- package/docs/chat-and-rag.md +1 -1
- package/docs/examples.md +9 -1
- package/docs/for-agents.md +12 -4
- package/docs/getting-started.md +10 -0
- package/docs/guides/cli-map.md +153 -0
- package/docs/guides/gate-ci.md +64 -0
- package/docs/guides/index-and-query.md +75 -0
- package/docs/guides/install-and-run.md +84 -0
- package/docs/guides/mcp-agents.md +63 -0
- package/docs/guides/memory-pipeline.md +105 -0
- package/docs/guides/meta.json +11 -0
- package/docs/index.md +48 -13
- package/docs/mcp.md +9 -0
- package/docs/meta.json +8 -2
- package/docs/playbook/doc-bridge-pattern.md +1 -1
- package/docs/query.md +47 -23
- package/ecosystem-claims.json +4 -4
- package/ecosystem-upstream.json +2 -2
- package/ecosystem.json +253 -36
- package/package.json +8 -5
- package/src/conformance/ecosystem-contract.ts +22 -3
- package/src/federation/ecosystem-llms.ts +67 -0
- package/src/index.ts +6 -0
- package/src/playbook/doc-bridge-pattern.ts +1 -1
- package/src/version.ts +1 -1
package/docs/index.md
CHANGED
|
@@ -1,23 +1,58 @@
|
|
|
1
1
|
---
|
|
2
2
|
title: Documentation
|
|
3
|
-
description:
|
|
3
|
+
description: Practical Doc Bridge paths for humans, agents, PR gates, and MCP — one repository, two audiences.
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# Documentation
|
|
7
7
|
|
|
8
|
-
Doc Bridge keeps one repository useful to
|
|
8
|
+
Doc Bridge keeps **one repository** useful to people and coding agents. Pick the shortest path:
|
|
9
9
|
|
|
10
|
-
|
|
11
|
-
- **Route an agent:** [For agents](./for-agents.md)
|
|
12
|
-
- **Block stale context in PRs:** [GitHub Marketplace](./MARKETPLACE.md)
|
|
13
|
-
- **Connect an MCP client:** [MCP](./mcp.md)
|
|
10
|
+
## Start
|
|
14
11
|
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
12
|
+
| Goal | Page |
|
|
13
|
+
| --- | --- |
|
|
14
|
+
| Install + 60s proof | [Getting started](./getting-started.md) |
|
|
15
|
+
| Guided install | [Install and run](./guides/install-and-run.md) |
|
|
16
|
+
| Machine-first entry | [For agents](./for-agents.md) · site route `/for-agents` |
|
|
17
|
+
| PR freshness gate | [Gate and CI](./guides/gate-ci.md) · [Marketplace](./MARKETPLACE.md) |
|
|
18
|
+
|
|
19
|
+
## Build workflows
|
|
20
|
+
|
|
21
|
+
| Goal | Page |
|
|
22
|
+
| --- | --- |
|
|
23
|
+
| Index + resolve ownership | [Index and query](./guides/index-and-query.md) · [Query](./query.md) |
|
|
24
|
+
| MCP for Cursor / Claude | [MCP for agents](./guides/mcp-agents.md) · [MCP](./mcp.md) |
|
|
25
|
+
| Memory digest → draft docs | [Memory pipeline](./guides/memory-pipeline.md) |
|
|
26
|
+
| Every CLI command | [CLI map](./guides/cli-map.md) · [CLI reference](./spec/cli.md) |
|
|
27
|
+
| Config sketches | [Examples](./examples.md) |
|
|
28
|
+
| Optional chat / RAG | [Chat and RAG](./chat-and-rag.md) · [Ollama demo](./ollama-demo.md) |
|
|
29
|
+
|
|
30
|
+
## How it works
|
|
31
|
+
|
|
32
|
+
```text
|
|
33
|
+
Repository docs
|
|
34
|
+
│
|
|
35
|
+
▼
|
|
36
|
+
ak-docs index ──► .doc-bridge/index.json + llms.txt
|
|
37
|
+
│
|
|
38
|
+
├─► Human guides (Fumadocs / Docusaurus / md)
|
|
39
|
+
├─► Agent handoff (CLI / MCP)
|
|
40
|
+
└─► PR gate (Marketplace Action)
|
|
21
41
|
```
|
|
22
42
|
|
|
23
|
-
|
|
43
|
+
1. **Index** — map ownership from corpus + config
|
|
44
|
+
2. **Resolve** — deterministic handoffs (`startHere`, `editRoots`, `checks`)
|
|
45
|
+
3. **Gate** — fail stale context before agents run
|
|
46
|
+
4. **Promote** — optional memory → draft docs loop
|
|
47
|
+
|
|
48
|
+
## Product vs reference
|
|
49
|
+
|
|
50
|
+
- **Start / Guides** — get value in minutes
|
|
51
|
+
- **Product** — [Positioning](./POSITIONING.md), [Playbook pattern](./playbook/doc-bridge-pattern.md), [Recipes](./recipes/index-pipeline.md)
|
|
52
|
+
- **Reference** — [CLI](./spec/cli.md), [Config](./spec/config-v1.md), [Schemas](./schemas/agent-handoff-v1.md)
|
|
53
|
+
|
|
54
|
+
Machine surfaces: [llms.txt](/llms.txt) · [llms-full.txt](/llms-full.txt) · [raw Markdown](/raw/getting-started.md)
|
|
55
|
+
|
|
56
|
+
## Ecosystem
|
|
57
|
+
|
|
58
|
+
Part of AgentsKit — next to [AgentsKit](https://www.agentskit.io), [Registry](https://registry.agentskit.io), [Chat](https://chat.agentskit.io), [Playbook](https://playbook.agentskit.io), and [AKOS](https://akos.agentskit.io).
|
package/docs/mcp.md
CHANGED
|
@@ -62,3 +62,12 @@ Before editing a package:
|
|
|
62
62
|
2. Open `startHere`
|
|
63
63
|
3. Stay inside `editRoots`
|
|
64
64
|
4. Run `checks` before claiming done
|
|
65
|
+
|
|
66
|
+
## Related
|
|
67
|
+
|
|
68
|
+
- [MCP for agents guide](./guides/mcp-agents.md)
|
|
69
|
+
- [CLI map](./guides/cli-map.md)
|
|
70
|
+
- [Memory pipeline](./guides/memory-pipeline.md)
|
|
71
|
+
- [For agents](./for-agents.md)
|
|
72
|
+
- [Index and query](./guides/index-and-query.md)
|
|
73
|
+
- [Skill](./skills/doc-bridge.md)
|
package/docs/meta.json
CHANGED
|
@@ -2,19 +2,25 @@
|
|
|
2
2
|
"title": "Doc Bridge",
|
|
3
3
|
"pages": [
|
|
4
4
|
"index",
|
|
5
|
+
"---Start---",
|
|
5
6
|
"getting-started",
|
|
7
|
+
"guides",
|
|
6
8
|
"for-agents",
|
|
7
9
|
"MARKETPLACE",
|
|
8
|
-
"
|
|
10
|
+
"---Build---",
|
|
9
11
|
"mcp",
|
|
10
12
|
"query",
|
|
11
13
|
"examples",
|
|
12
14
|
"chat-and-rag",
|
|
13
15
|
"ollama-demo",
|
|
16
|
+
"---Product---",
|
|
17
|
+
"POSITIONING",
|
|
14
18
|
"playbook",
|
|
15
19
|
"recipes",
|
|
20
|
+
"---Reference---",
|
|
16
21
|
"schemas",
|
|
17
22
|
"skills",
|
|
18
|
-
"spec"
|
|
23
|
+
"spec",
|
|
24
|
+
"RELEASE"
|
|
19
25
|
]
|
|
20
26
|
}
|
|
@@ -113,4 +113,4 @@ Teams track handoff % and human-bridge % daily.
|
|
|
113
113
|
- npm: https://www.npmjs.com/package/@agentskit/doc-bridge
|
|
114
114
|
- repo: https://github.com/AgentsKit-io/doc-bridge
|
|
115
115
|
- skill: [doc-bridge skill](../skills/doc-bridge.md)
|
|
116
|
-
- landing: https://
|
|
116
|
+
- landing: https://doc-bridge.agentskit.io/
|
package/docs/query.md
CHANGED
|
@@ -1,34 +1,58 @@
|
|
|
1
1
|
---
|
|
2
|
-
title:
|
|
3
|
-
description:
|
|
2
|
+
title: Query
|
|
3
|
+
description: Deterministic ownership and documentation lookup — no model, no re-scan of the repo.
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
-
#
|
|
6
|
+
# Query
|
|
7
7
|
|
|
8
|
-
The query layer reads
|
|
9
|
-
the repository again and does not call a model. Keep exact ownership resolution,
|
|
10
|
-
ranked document search, and handoff output deterministic.
|
|
8
|
+
The query layer reads `.doc-bridge/index.json` only. It does **not** re-scan the repository and does **not** call a model.
|
|
11
9
|
|
|
12
|
-
##
|
|
10
|
+
## Commands
|
|
13
11
|
|
|
14
|
-
|
|
15
|
-
-
|
|
16
|
-
-
|
|
17
|
-
-
|
|
18
|
-
- MCP consumers: `src/mcp/server.ts`
|
|
12
|
+
```bash
|
|
13
|
+
# Machine-readable handoff (for agents / MCP)
|
|
14
|
+
ak-docs query package auth --agent
|
|
15
|
+
ak-docs query ownership auth --agent
|
|
19
16
|
|
|
20
|
-
|
|
17
|
+
# Human-readable
|
|
18
|
+
ak-docs query package auth --text
|
|
21
19
|
|
|
22
|
-
|
|
20
|
+
# Discovery
|
|
21
|
+
ak-docs list packages --text
|
|
22
|
+
ak-docs ask "where do I change billing?"
|
|
23
|
+
```
|
|
23
24
|
|
|
24
|
-
##
|
|
25
|
+
## What you get
|
|
25
26
|
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
27
|
+
An **AgentHandoff** (v1) with stable fields:
|
|
28
|
+
|
|
29
|
+
| Field | Use |
|
|
30
|
+
| --- | --- |
|
|
31
|
+
| `startHere` | First file the agent should open |
|
|
32
|
+
| `editRoots` | Allowed write paths |
|
|
33
|
+
| `checks` | Verification commands |
|
|
34
|
+
| `humanDoc` | Parallel human documentation |
|
|
35
|
+
|
|
36
|
+
Schema: [AgentHandoff v1](./schemas/agent-handoff-v1.md) · Index: [DocBridgeIndex v1](./schemas/doc-bridge-index-v1.md)
|
|
37
|
+
|
|
38
|
+
## When to use which surface
|
|
39
|
+
|
|
40
|
+
| Need | Surface |
|
|
41
|
+
| --- | --- |
|
|
42
|
+
| Agent about to edit a module | `query … --agent` or MCP `handoff.resolve` |
|
|
43
|
+
| Human browsing ownership | `query … --text` / `list packages` |
|
|
44
|
+
| Free-form question with known docs | `ask "…"` (local first) |
|
|
45
|
+
| Unresolved semantic question | Optional [Chat and RAG](./chat-and-rag.md) backend |
|
|
46
|
+
|
|
47
|
+
## Guarantees
|
|
48
|
+
|
|
49
|
+
- Same inputs → same handoff JSON (deterministic)
|
|
50
|
+
- Breaking field meaning requires a **new schema version**, not silent reinterpretation of v1
|
|
51
|
+
- Gate/CI can require a fresh index so agents never see stale ownership
|
|
52
|
+
|
|
53
|
+
## Related
|
|
32
54
|
|
|
33
|
-
|
|
34
|
-
|
|
55
|
+
- [Guide: Index and query](./guides/index-and-query.md)
|
|
56
|
+
- [For agents](./for-agents.md)
|
|
57
|
+
- [CLI reference](./spec/cli.md)
|
|
58
|
+
- [MCP](./mcp.md)
|
package/ecosystem-claims.json
CHANGED
|
@@ -83,9 +83,9 @@
|
|
|
83
83
|
},
|
|
84
84
|
{
|
|
85
85
|
"id": "skills",
|
|
86
|
-
"value":
|
|
86
|
+
"value": 22,
|
|
87
87
|
"noun": "ready-made skills",
|
|
88
|
-
"conservativeFloor":
|
|
88
|
+
"conservativeFloor": 22,
|
|
89
89
|
"evidence": {
|
|
90
90
|
"type": "repository-derivation",
|
|
91
91
|
"repo": "AgentsKit-io/agentskit",
|
|
@@ -177,8 +177,8 @@
|
|
|
177
177
|
{
|
|
178
178
|
"productId": "akos",
|
|
179
179
|
"source": {
|
|
180
|
-
"type": "
|
|
181
|
-
"
|
|
180
|
+
"type": "repository",
|
|
181
|
+
"repo": "AgentsKit-io/agentskit-os"
|
|
182
182
|
},
|
|
183
183
|
"verification": "declared",
|
|
184
184
|
"claims": []
|
package/ecosystem-upstream.json
CHANGED
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
"repository": "AgentsKit-io/agentskit",
|
|
4
4
|
"ref": "main",
|
|
5
5
|
"files": {
|
|
6
|
-
"ecosystem.json": "
|
|
7
|
-
"ecosystem-claims.json": "
|
|
6
|
+
"ecosystem.json": "8cc227f6838b9927fcaab5fe019e0f869f8a82bcbb1f2488b8b6b94e41779e9e",
|
|
7
|
+
"ecosystem-claims.json": "ab8f83b3fa56d525986485dfeb4f12cd89ce1e76b3c90b2b1c6df51dfe8919bd"
|
|
8
8
|
}
|
|
9
9
|
}
|
package/ecosystem.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"schemaVersion": 2,
|
|
3
|
-
"$comment": "Canonical registry of AgentsKit ecosystem products. Stable identity lives
|
|
3
|
+
"$comment": "Canonical registry of AgentsKit ecosystem products. Stable identity lives in products[] (seven). Numeric values live in the generated ecosystem-claims ledger. The properties array is the full seven-product v1 projection of products[] (same order) for sibling consumers.",
|
|
4
4
|
"parentBrand": {
|
|
5
5
|
"id": "agentskit",
|
|
6
6
|
"name": "AgentsKit"
|
|
@@ -16,6 +16,35 @@
|
|
|
16
16
|
"maturity": "beta",
|
|
17
17
|
"repo": "AgentsKit-io/agentskit",
|
|
18
18
|
"accent": "#2EA043",
|
|
19
|
+
"showcase": {
|
|
20
|
+
"claimSource": {
|
|
21
|
+
"url": "https://www.agentskit.io/api/stats.json",
|
|
22
|
+
"claims": {
|
|
23
|
+
"packages": { "path": "counts.packages" },
|
|
24
|
+
"core-size-kb-gzip": { "path": "coreSizeKbGzip" },
|
|
25
|
+
"catalog-providers": { "path": "counts.catalogProviders" },
|
|
26
|
+
"native-adapters": { "path": "counts.nativeAdapters" },
|
|
27
|
+
"integrations": { "path": "counts.integrations" }
|
|
28
|
+
}
|
|
29
|
+
},
|
|
30
|
+
"stage": "Build",
|
|
31
|
+
"headline": "One foundation. Every layer stays yours.",
|
|
32
|
+
"detail": "Compose runtime, adapters, tools, memory, RAG, and UI without glue code or lock-in.",
|
|
33
|
+
"proof": "{{packages}} packages · <{{core-size-kb-gzip}} KB core",
|
|
34
|
+
"sales": {
|
|
35
|
+
"kind": "integration-stack",
|
|
36
|
+
"headline": "Swap the stack. Keep the agent.",
|
|
37
|
+
"metrics": [
|
|
38
|
+
{ "value": "{{catalog-providers}}", "label": "providers" },
|
|
39
|
+
{ "value": "{{native-adapters}}", "label": "adapters" },
|
|
40
|
+
{ "value": "{{integrations}}", "label": "integrations" }
|
|
41
|
+
],
|
|
42
|
+
"capabilities": ["Tools", "RAG", "Memory", "MCP"],
|
|
43
|
+
"steps": ["Choose any adapter", "Add tools and memory", "Ship without rewrites"]
|
|
44
|
+
},
|
|
45
|
+
"cta": "Build with AgentsKit",
|
|
46
|
+
"ctaSurface": "docs"
|
|
47
|
+
},
|
|
19
48
|
"surfaces": {
|
|
20
49
|
"home": "https://www.agentskit.io",
|
|
21
50
|
"docs": "https://www.agentskit.io/docs",
|
|
@@ -27,7 +56,14 @@
|
|
|
27
56
|
"navigation": {
|
|
28
57
|
"showInBar": true,
|
|
29
58
|
"order": 0,
|
|
30
|
-
"next": [
|
|
59
|
+
"next": [
|
|
60
|
+
"registry",
|
|
61
|
+
"agentskit-chat",
|
|
62
|
+
"playbook",
|
|
63
|
+
"doc-bridge",
|
|
64
|
+
"code-review",
|
|
65
|
+
"akos"
|
|
66
|
+
]
|
|
31
67
|
}
|
|
32
68
|
},
|
|
33
69
|
{
|
|
@@ -40,6 +76,30 @@
|
|
|
40
76
|
"maturity": "beta",
|
|
41
77
|
"repo": "AgentsKit-io/agentskit-registry",
|
|
42
78
|
"accent": "#58A6FF",
|
|
79
|
+
"showcase": {
|
|
80
|
+
"claimSource": {
|
|
81
|
+
"url": "https://registry.agentskit.io/r/index.json",
|
|
82
|
+
"claims": {
|
|
83
|
+
"agents": { "path": "agents", "aggregate": "length" },
|
|
84
|
+
"remaining-categories": { "path": "agents", "aggregate": "distinct", "field": "category", "subtract": 5 }
|
|
85
|
+
}
|
|
86
|
+
},
|
|
87
|
+
"stage": "Discover",
|
|
88
|
+
"headline": "Shadcn-like agents. Installed as source.",
|
|
89
|
+
"detail": "Find a working agent, copy its source into your project, and change every line.",
|
|
90
|
+
"proof": "Ready-made · source-owned",
|
|
91
|
+
"sales": {
|
|
92
|
+
"kind": "registry-install",
|
|
93
|
+
"headline": "Ready-to-use agents from the live Registry.",
|
|
94
|
+
"metric": "{{agents}}",
|
|
95
|
+
"metricLabel": "shadcn-like agents",
|
|
96
|
+
"capabilities": ["Research", "Support", "Coding", "Data", "Marketing", "{{remaining-categories}} additional categories"],
|
|
97
|
+
"steps": ["Find the right agent", "Run npx agentskit add", "Own every line"],
|
|
98
|
+
"command": "npx agentskit add research"
|
|
99
|
+
},
|
|
100
|
+
"cta": "Explore the Registry",
|
|
101
|
+
"ctaSurface": "home"
|
|
102
|
+
},
|
|
43
103
|
"surfaces": {
|
|
44
104
|
"home": "https://registry.agentskit.io",
|
|
45
105
|
"docs": "https://registry.agentskit.io/docs",
|
|
@@ -51,7 +111,14 @@
|
|
|
51
111
|
"navigation": {
|
|
52
112
|
"showInBar": true,
|
|
53
113
|
"order": 1,
|
|
54
|
-
"next": [
|
|
114
|
+
"next": [
|
|
115
|
+
"agentskit",
|
|
116
|
+
"agentskit-chat",
|
|
117
|
+
"playbook",
|
|
118
|
+
"doc-bridge",
|
|
119
|
+
"code-review",
|
|
120
|
+
"akos"
|
|
121
|
+
]
|
|
55
122
|
}
|
|
56
123
|
},
|
|
57
124
|
{
|
|
@@ -64,6 +131,28 @@
|
|
|
64
131
|
"maturity": "alpha",
|
|
65
132
|
"repo": "AgentsKit-io/agentskit-chat",
|
|
66
133
|
"accent": "#F59E0B",
|
|
134
|
+
"showcase": {
|
|
135
|
+
"stage": "Deliver",
|
|
136
|
+
"headline": "One agent. Every conversation surface.",
|
|
137
|
+
"detail": "Define the experience once and deliver it across web, desktop, CLI, and mobile.",
|
|
138
|
+
"proof": "Web · Desktop · CLI · Mobile",
|
|
139
|
+
"sales": {
|
|
140
|
+
"kind": "human-agent",
|
|
141
|
+
"headline": "Human ↔ agent. Without losing control.",
|
|
142
|
+
"metric": "4",
|
|
143
|
+
"metricLabel": "surfaces · one conversation",
|
|
144
|
+
"logos": [
|
|
145
|
+
{ "id": "web", "label": "Web" },
|
|
146
|
+
{ "id": "desktop", "label": "Desktop" },
|
|
147
|
+
{ "id": "cli", "label": "CLI" },
|
|
148
|
+
{ "id": "mobile", "label": "Mobile" }
|
|
149
|
+
],
|
|
150
|
+
"capabilities": ["Streaming", "Approvals", "Tool results", "Shared state"],
|
|
151
|
+
"steps": ["Agent requests a protected action", "Human approves", "The conversation continues everywhere"]
|
|
152
|
+
},
|
|
153
|
+
"cta": "Explore AgentsKit Chat",
|
|
154
|
+
"ctaSurface": "home"
|
|
155
|
+
},
|
|
67
156
|
"surfaces": {
|
|
68
157
|
"home": "https://chat.agentskit.io",
|
|
69
158
|
"docs": "https://chat.agentskit.io/docs",
|
|
@@ -74,7 +163,14 @@
|
|
|
74
163
|
"navigation": {
|
|
75
164
|
"showInBar": true,
|
|
76
165
|
"order": 2,
|
|
77
|
-
"next": [
|
|
166
|
+
"next": [
|
|
167
|
+
"agentskit",
|
|
168
|
+
"registry",
|
|
169
|
+
"playbook",
|
|
170
|
+
"doc-bridge",
|
|
171
|
+
"code-review",
|
|
172
|
+
"akos"
|
|
173
|
+
]
|
|
78
174
|
}
|
|
79
175
|
},
|
|
80
176
|
{
|
|
@@ -83,10 +179,32 @@
|
|
|
83
179
|
"shortName": "Playbook",
|
|
84
180
|
"kind": "methodology",
|
|
85
181
|
"role": "discipline",
|
|
86
|
-
"promise": "
|
|
182
|
+
"promise": "Train coding agents to ship code your team would merge.",
|
|
87
183
|
"maturity": "stable",
|
|
88
184
|
"repo": "AgentsKit-io/agents-playbook",
|
|
89
185
|
"accent": "#8B5CF6",
|
|
186
|
+
"showcase": {
|
|
187
|
+
"stage": "Standardize",
|
|
188
|
+
"headline": "The open engineering harness for coding agents.",
|
|
189
|
+
"detail": "Open rules, prompts, memory, evals, and executable gates turn every correction into behavior coding agents can repeat.",
|
|
190
|
+
"proof": "Train the behavior · not the model",
|
|
191
|
+
"sales": {
|
|
192
|
+
"kind": "standards-flow",
|
|
193
|
+
"headline": "Your standards. Every agent. Every repository.",
|
|
194
|
+
"metric": "1×",
|
|
195
|
+
"metricLabel": "define · reuse everywhere",
|
|
196
|
+
"logos": [
|
|
197
|
+
{ "id": "architecture", "label": "Architecture" },
|
|
198
|
+
{ "id": "tests", "label": "Tests" },
|
|
199
|
+
{ "id": "security", "label": "Security" },
|
|
200
|
+
{ "id": "style", "label": "Style" }
|
|
201
|
+
],
|
|
202
|
+
"capabilities": ["Repository rules", "Review criteria", "Agent guidance", "Team conventions"],
|
|
203
|
+
"steps": ["Define the standard once", "Agents receive executable guidance", "Review consistent output"]
|
|
204
|
+
},
|
|
205
|
+
"cta": "Explore the harness",
|
|
206
|
+
"ctaSurface": "home"
|
|
207
|
+
},
|
|
90
208
|
"surfaces": {
|
|
91
209
|
"home": "https://playbook.agentskit.io",
|
|
92
210
|
"docs": "https://playbook.agentskit.io/docs",
|
|
@@ -98,7 +216,14 @@
|
|
|
98
216
|
"navigation": {
|
|
99
217
|
"showInBar": true,
|
|
100
218
|
"order": 3,
|
|
101
|
-
"next": [
|
|
219
|
+
"next": [
|
|
220
|
+
"agentskit",
|
|
221
|
+
"registry",
|
|
222
|
+
"agentskit-chat",
|
|
223
|
+
"doc-bridge",
|
|
224
|
+
"code-review",
|
|
225
|
+
"akos"
|
|
226
|
+
]
|
|
102
227
|
}
|
|
103
228
|
},
|
|
104
229
|
{
|
|
@@ -111,17 +236,46 @@
|
|
|
111
236
|
"maturity": "stable",
|
|
112
237
|
"repo": "AgentsKit-io/doc-bridge",
|
|
113
238
|
"accent": "#06B6D4",
|
|
239
|
+
"showcase": {
|
|
240
|
+
"stage": "Understand",
|
|
241
|
+
"headline": "Documentation that hands work off precisely.",
|
|
242
|
+
"detail": "Connect repository knowledge to agents with structured, executable context.",
|
|
243
|
+
"proof": "Code → precise handoff",
|
|
244
|
+
"sales": {
|
|
245
|
+
"kind": "knowledge-bridge",
|
|
246
|
+
"headline": "Knowledge flows both ways.",
|
|
247
|
+
"metric": "↔",
|
|
248
|
+
"metricLabel": "humans and agents",
|
|
249
|
+
"logos": [
|
|
250
|
+
{ "id": "human", "label": "Humans" },
|
|
251
|
+
{ "id": "markdown", "label": "Docs" },
|
|
252
|
+
{ "id": "code", "label": "Code" },
|
|
253
|
+
{ "id": "agent", "label": "Agents" }
|
|
254
|
+
],
|
|
255
|
+
"capabilities": ["ADRs", "Handoffs", "Agent findings", "Human-readable docs"],
|
|
256
|
+
"steps": ["Humans document decisions", "Agents receive precise context", "Agent findings return to humans"]
|
|
257
|
+
},
|
|
258
|
+
"cta": "Generate your first handoff",
|
|
259
|
+
"ctaSurface": "home"
|
|
260
|
+
},
|
|
114
261
|
"surfaces": {
|
|
115
|
-
"home": "https://
|
|
116
|
-
"docs": "https://
|
|
117
|
-
"llms": "https://
|
|
262
|
+
"home": "https://doc-bridge.agentskit.io/",
|
|
263
|
+
"docs": "https://doc-bridge.agentskit.io/",
|
|
264
|
+
"llms": "https://doc-bridge.agentskit.io/llms.txt",
|
|
118
265
|
"documentation": "fumadocs",
|
|
119
266
|
"chat": "none"
|
|
120
267
|
},
|
|
121
268
|
"navigation": {
|
|
122
269
|
"showInBar": true,
|
|
123
270
|
"order": 4,
|
|
124
|
-
"next": [
|
|
271
|
+
"next": [
|
|
272
|
+
"agentskit",
|
|
273
|
+
"registry",
|
|
274
|
+
"agentskit-chat",
|
|
275
|
+
"playbook",
|
|
276
|
+
"code-review",
|
|
277
|
+
"akos"
|
|
278
|
+
]
|
|
125
279
|
}
|
|
126
280
|
},
|
|
127
281
|
{
|
|
@@ -142,9 +296,16 @@
|
|
|
142
296
|
"chat": "none"
|
|
143
297
|
},
|
|
144
298
|
"navigation": {
|
|
145
|
-
"showInBar":
|
|
299
|
+
"showInBar": false,
|
|
146
300
|
"order": 5,
|
|
147
|
-
"next": [
|
|
301
|
+
"next": [
|
|
302
|
+
"agentskit",
|
|
303
|
+
"registry",
|
|
304
|
+
"agentskit-chat",
|
|
305
|
+
"playbook",
|
|
306
|
+
"doc-bridge",
|
|
307
|
+
"akos"
|
|
308
|
+
]
|
|
148
309
|
}
|
|
149
310
|
},
|
|
150
311
|
{
|
|
@@ -157,11 +318,32 @@
|
|
|
157
318
|
"maturity": "stable",
|
|
158
319
|
"repo": "AgentsKit-io/agentskit-os",
|
|
159
320
|
"accent": "#34D399",
|
|
321
|
+
"showcase": {
|
|
322
|
+
"stage": "Operate",
|
|
323
|
+
"headline": "Run and govern agents in production.",
|
|
324
|
+
"detail": "Add orchestration, governance, and operational control when your system needs it.",
|
|
325
|
+
"proof": "Orchestration · governance · control",
|
|
326
|
+
"sales": {
|
|
327
|
+
"kind": "enterprise-control",
|
|
328
|
+
"headline": "The enterprise control plane for agents.",
|
|
329
|
+
"metric": "Enterprise",
|
|
330
|
+
"metricLabel": "operations and governance",
|
|
331
|
+
"logos": [
|
|
332
|
+
{ "id": "logs", "label": "Logs" },
|
|
333
|
+
{ "id": "approvals", "label": "Approvals" },
|
|
334
|
+
{ "id": "rbac", "label": "RBAC" },
|
|
335
|
+
{ "id": "policies", "label": "Policies" }
|
|
336
|
+
],
|
|
337
|
+
"capabilities": ["Logs", "Approvals", "RBAC", "Policies", "Tracing", "Costs"],
|
|
338
|
+
"steps": ["Agent requests a protected action", "RBAC and policy gates evaluate", "Human approves; logs and trace persist"]
|
|
339
|
+
},
|
|
340
|
+
"cta": "Explore AgentsKit OS",
|
|
341
|
+
"ctaSurface": "home"
|
|
342
|
+
},
|
|
160
343
|
"surfaces": {
|
|
161
344
|
"home": "https://akos.agentskit.io",
|
|
162
345
|
"docs": "https://akos.agentskit.io/docs",
|
|
163
346
|
"llms": "https://akos.agentskit.io/llms.txt",
|
|
164
|
-
"stats": "https://akos.agentskit.io/api/stats.json",
|
|
165
347
|
"documentation": "fumadocs",
|
|
166
348
|
"chat": "none"
|
|
167
349
|
},
|
|
@@ -187,17 +369,29 @@
|
|
|
187
369
|
"stats": "https://www.agentskit.io/api/stats.json"
|
|
188
370
|
},
|
|
189
371
|
{
|
|
190
|
-
"id": "
|
|
191
|
-
"name": "AgentsKit
|
|
192
|
-
"barLabel": "
|
|
193
|
-
"domain": "
|
|
194
|
-
"url": "https://
|
|
195
|
-
"repo": "AgentsKit-io/agentskit-
|
|
196
|
-
"tagline": "
|
|
197
|
-
"kind": "
|
|
198
|
-
"accent": "#
|
|
199
|
-
"llms": "https://
|
|
200
|
-
"stats": "https://
|
|
372
|
+
"id": "registry",
|
|
373
|
+
"name": "AgentsKit Registry",
|
|
374
|
+
"barLabel": "Registry",
|
|
375
|
+
"domain": "registry.agentskit.io",
|
|
376
|
+
"url": "https://registry.agentskit.io",
|
|
377
|
+
"repo": "AgentsKit-io/agentskit-registry",
|
|
378
|
+
"tagline": "Copy ready-made agents and own the source.",
|
|
379
|
+
"kind": "registry",
|
|
380
|
+
"accent": "#58A6FF",
|
|
381
|
+
"llms": "https://registry.agentskit.io/llms.txt",
|
|
382
|
+
"stats": "https://registry.agentskit.io/r/index.json"
|
|
383
|
+
},
|
|
384
|
+
{
|
|
385
|
+
"id": "agentskit-chat",
|
|
386
|
+
"name": "AgentsKit Chat",
|
|
387
|
+
"barLabel": "Chat",
|
|
388
|
+
"domain": "chat.agentskit.io",
|
|
389
|
+
"url": "https://chat.agentskit.io",
|
|
390
|
+
"repo": "AgentsKit-io/agentskit-chat",
|
|
391
|
+
"tagline": "Define one agent experience and deliver it across interfaces.",
|
|
392
|
+
"kind": "framework",
|
|
393
|
+
"accent": "#F59E0B",
|
|
394
|
+
"llms": "https://chat.agentskit.io/llms.txt"
|
|
201
395
|
},
|
|
202
396
|
{
|
|
203
397
|
"id": "playbook",
|
|
@@ -206,24 +400,47 @@
|
|
|
206
400
|
"domain": "playbook.agentskit.io",
|
|
207
401
|
"url": "https://playbook.agentskit.io",
|
|
208
402
|
"repo": "AgentsKit-io/agents-playbook",
|
|
209
|
-
"tagline": "
|
|
403
|
+
"tagline": "Train coding agents to ship code your team would merge.",
|
|
210
404
|
"kind": "methodology",
|
|
211
405
|
"accent": "#8B5CF6",
|
|
212
406
|
"llms": "https://playbook.agentskit.io/llms.txt",
|
|
213
407
|
"stats": "https://playbook.agentskit.io/api/stats.json"
|
|
214
408
|
},
|
|
215
409
|
{
|
|
216
|
-
"id": "
|
|
217
|
-
"name": "
|
|
218
|
-
"barLabel": "
|
|
219
|
-
"domain": "
|
|
220
|
-
"url": "https://
|
|
221
|
-
"repo": "AgentsKit-io/
|
|
222
|
-
"tagline": "
|
|
223
|
-
"kind": "
|
|
224
|
-
"accent": "#
|
|
225
|
-
"llms": "https://
|
|
226
|
-
|
|
410
|
+
"id": "doc-bridge",
|
|
411
|
+
"name": "Doc Bridge",
|
|
412
|
+
"barLabel": "Doc Bridge",
|
|
413
|
+
"domain": "doc-bridge.agentskit.io",
|
|
414
|
+
"url": "https://doc-bridge.agentskit.io/",
|
|
415
|
+
"repo": "AgentsKit-io/doc-bridge",
|
|
416
|
+
"tagline": "Turn repository documentation into executable agent handoffs.",
|
|
417
|
+
"kind": "developer-tool",
|
|
418
|
+
"accent": "#06B6D4",
|
|
419
|
+
"llms": "https://doc-bridge.agentskit.io/llms.txt"
|
|
420
|
+
},
|
|
421
|
+
{
|
|
422
|
+
"id": "code-review",
|
|
423
|
+
"name": "AgentsKit Code Review",
|
|
424
|
+
"barLabel": "Code Review",
|
|
425
|
+
"domain": "github.com",
|
|
426
|
+
"url": "https://github.com/AgentsKit-io/code-review-cli",
|
|
427
|
+
"repo": "AgentsKit-io/code-review-cli",
|
|
428
|
+
"tagline": "Run deep, low-noise review with the model already in use.",
|
|
429
|
+
"kind": "developer-tool",
|
|
430
|
+
"accent": "#F97316",
|
|
431
|
+
"llms": "https://raw.githubusercontent.com/AgentsKit-io/code-review-cli/main/llms.txt"
|
|
432
|
+
},
|
|
433
|
+
{
|
|
434
|
+
"id": "akos",
|
|
435
|
+
"name": "AgentsKit OS",
|
|
436
|
+
"barLabel": "AKOS",
|
|
437
|
+
"domain": "akos.agentskit.io",
|
|
438
|
+
"url": "https://akos.agentskit.io",
|
|
439
|
+
"repo": "AgentsKit-io/agentskit-os",
|
|
440
|
+
"tagline": "Run and govern agents in production.",
|
|
441
|
+
"kind": "product",
|
|
442
|
+
"accent": "#34D399",
|
|
443
|
+
"llms": "https://akos.agentskit.io/llms.txt"
|
|
227
444
|
}
|
|
228
445
|
],
|
|
229
446
|
"builder": {
|