@skillshub-labs/cli 0.1.17 → 0.1.19

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.
Files changed (28) hide show
  1. package/README.md +28 -12
  2. package/bin/skills-hub +193 -15
  3. package/data/official-presets/catalog.json +436 -0
  4. package/data/official-presets/policies/policy-azure-cloud.md +18 -0
  5. package/data/official-presets/policies/policy-cloudflare-edge.md +18 -0
  6. package/data/official-presets/policies/policy-fastapi-py.md +31 -0
  7. package/data/official-presets/policies/policy-fullstack-web.md +24 -0
  8. package/data/official-presets/policies/policy-go-service.md +31 -0
  9. package/data/official-presets/policies/policy-hf-ml.md +18 -0
  10. package/data/official-presets/policies/policy-langchain-apps.md +18 -0
  11. package/data/official-presets/policies/policy-literature-review.md +18 -0
  12. package/data/official-presets/policies/policy-monorepo-turbo.md +31 -0
  13. package/data/official-presets/policies/policy-nextjs-ts-strict.md +31 -0
  14. package/data/official-presets/policies/policy-node-api-ts.md +31 -0
  15. package/data/official-presets/policies/policy-python-api.md +18 -0
  16. package/data/official-presets/policies/policy-release-ci.md +18 -0
  17. package/data/official-presets/policies/policy-release-maintainer.md +31 -0
  18. package/data/official-presets/policies/policy-scientific-discovery.md +18 -0
  19. package/data/official-presets/policies/policy-scientific-python.md +31 -0
  20. package/data/official-presets/policies/policy-security-audit.md +18 -0
  21. package/data/official-presets/policies/policy-web-frontend.md +18 -0
  22. package/lib/core/kit-core.d.ts +14 -3
  23. package/lib/core/kit-core.mjs +327 -20
  24. package/lib/core/kit-types.ts +128 -3
  25. package/lib/services/kit-loadout-import.mjs +599 -0
  26. package/lib/services/kit-service.d.ts +90 -2
  27. package/lib/services/kit-service.mjs +665 -38
  28. package/package.json +9 -1
@@ -0,0 +1,436 @@
1
+ {
2
+ "version": 2,
3
+ "presets": [
4
+ {
5
+ "id": "fullstack-product-engineering",
6
+ "name": "Fullstack Product Engineering",
7
+ "description": "面向现代 Web 产品交付的全栈 Kit,覆盖 React/Next.js、质量、协作和工程流程。",
8
+ "policy": {
9
+ "name": "Fullstack Product Engineering",
10
+ "description": "适用于现代 Web 产品交付的通用全栈 AGENTS.md 模板。",
11
+ "template": "policies/policy-fullstack-web.md"
12
+ },
13
+ "sources": [
14
+ {
15
+ "id": "superpowers-core",
16
+ "name": "Superpowers Core",
17
+ "url": "https://github.com/obra/superpowers/tree/main/skills",
18
+ "description": "提供完整开发流程、TDD、并行子 agent 协作与调试工作流。",
19
+ "selectedSkills": [
20
+ "subagent-driven-development",
21
+ "test-driven-development",
22
+ "systematic-debugging"
23
+ ]
24
+ },
25
+ {
26
+ "id": "vercel-react",
27
+ "name": "Vercel Agent Skills",
28
+ "url": "https://github.com/vercel-labs/agent-skills/tree/main/skills",
29
+ "description": "覆盖 React/Next.js 代码模式与性能实践。",
30
+ "selectedSkills": [
31
+ "react-best-practices",
32
+ "composition-patterns"
33
+ ]
34
+ },
35
+ {
36
+ "id": "anthropic-web",
37
+ "name": "Anthropic Skills",
38
+ "url": "https://github.com/anthropics/skills/tree/main/skills",
39
+ "description": "补充端到端测试、前端设计和 MCP 构建能力。",
40
+ "selectedSkills": [
41
+ "webapp-testing",
42
+ "frontend-design",
43
+ "mcp-builder"
44
+ ]
45
+ },
46
+ {
47
+ "id": "web-quality",
48
+ "name": "Web Quality Skills",
49
+ "url": "https://github.com/addyosmani/web-quality-skills/tree/main/skills",
50
+ "description": "覆盖性能、可访问性与 SEO 质量检查。",
51
+ "selectedSkills": [
52
+ "performance",
53
+ "accessibility",
54
+ "seo"
55
+ ]
56
+ },
57
+ {
58
+ "id": "openai-gh-review",
59
+ "name": "OpenAI Curated Skills",
60
+ "url": "https://github.com/openai/skills/tree/main/skills/.curated",
61
+ "description": "补充 PR review comment 处理工作流。",
62
+ "selectedSkills": [
63
+ "gh-address-comments"
64
+ ]
65
+ }
66
+ ]
67
+ },
68
+ {
69
+ "id": "web-frontend-excellence",
70
+ "name": "Web Frontend Excellence",
71
+ "description": "面向 React / Next.js 前端工程、设计、性能与体验质量的 Kit。",
72
+ "policy": {
73
+ "name": "Web Frontend Excellence",
74
+ "description": "适用于 React / Next.js 前端工程的 AGENTS.md 模板。",
75
+ "template": "policies/policy-web-frontend.md"
76
+ },
77
+ "sources": [
78
+ {
79
+ "id": "vercel-frontend",
80
+ "name": "Vercel Agent Skills",
81
+ "url": "https://github.com/vercel-labs/agent-skills/tree/main/skills",
82
+ "description": "覆盖 React 最佳实践、设计和组件模式。",
83
+ "selectedSkills": [
84
+ "react-best-practices",
85
+ "web-design-guidelines",
86
+ "composition-patterns"
87
+ ]
88
+ },
89
+ {
90
+ "id": "web-quality-frontend",
91
+ "name": "Web Quality Skills",
92
+ "url": "https://github.com/addyosmani/web-quality-skills/tree/main/skills",
93
+ "description": "覆盖 Core Web Vitals、性能、无障碍和 SEO。",
94
+ "selectedSkills": [
95
+ "core-web-vitals",
96
+ "performance",
97
+ "accessibility",
98
+ "seo"
99
+ ]
100
+ },
101
+ {
102
+ "id": "anthropic-frontend",
103
+ "name": "Anthropic Skills",
104
+ "url": "https://github.com/anthropics/skills/tree/main/skills",
105
+ "description": "补充前端设计与 Web 应用测试能力。",
106
+ "selectedSkills": [
107
+ "frontend-design",
108
+ "webapp-testing"
109
+ ]
110
+ }
111
+ ]
112
+ },
113
+ {
114
+ "id": "python-service-api",
115
+ "name": "Python Service API",
116
+ "description": "面向 Python 服务、API、调试和安全检查的 Kit。",
117
+ "policy": {
118
+ "name": "Python Service API",
119
+ "description": "适用于 Python 服务 / API 开发的 AGENTS.md 模板。",
120
+ "template": "policies/policy-python-api.md"
121
+ },
122
+ "sources": [
123
+ {
124
+ "id": "trailofbits-python",
125
+ "name": "Trail of Bits Skills",
126
+ "url": "https://github.com/trailofbits/skills/tree/main/plugins/modern-python/skills",
127
+ "description": "提供现代 Python 代码质量与工程实践。",
128
+ "selectedSkills": [
129
+ "modern-python"
130
+ ]
131
+ },
132
+ {
133
+ "id": "openai-security",
134
+ "name": "OpenAI Curated Skills",
135
+ "url": "https://github.com/openai/skills/tree/main/skills/.curated",
136
+ "description": "补充安全最佳实践。",
137
+ "selectedSkills": [
138
+ "security-best-practices"
139
+ ]
140
+ },
141
+ {
142
+ "id": "anthropic-python-mcp",
143
+ "name": "Anthropic Skills",
144
+ "url": "https://github.com/anthropics/skills/tree/main/skills",
145
+ "description": "补充工具集成和 MCP 构建能力。",
146
+ "selectedSkills": [
147
+ "mcp-builder"
148
+ ]
149
+ },
150
+ {
151
+ "id": "superpowers-python-flow",
152
+ "name": "Superpowers Core",
153
+ "url": "https://github.com/obra/superpowers/tree/main/skills",
154
+ "description": "补充测试驱动与调试工作流。",
155
+ "selectedSkills": [
156
+ "test-driven-development",
157
+ "systematic-debugging"
158
+ ]
159
+ }
160
+ ]
161
+ },
162
+ {
163
+ "id": "langchain-langgraph-apps",
164
+ "name": "LangChain LangGraph Apps",
165
+ "description": "面向 LangChain / LangGraph 应用开发、RAG、持久化与 agent orchestration 的 Kit。",
166
+ "policy": {
167
+ "name": "LangChain LangGraph Apps",
168
+ "description": "适用于 LangChain / LangGraph 应用开发的 AGENTS.md 模板。",
169
+ "template": "policies/policy-langchain-apps.md"
170
+ },
171
+ "sources": [
172
+ {
173
+ "id": "langchain-core-skills",
174
+ "name": "LangChain Skills",
175
+ "url": "https://github.com/langchain-ai/langchain-skills/tree/main/config/skills",
176
+ "description": "LangChain 官方技能集合。",
177
+ "selectedSkills": [
178
+ "langchain-fundamentals",
179
+ "langchain-dependencies",
180
+ "langchain-rag",
181
+ "langgraph-fundamentals",
182
+ "langgraph-persistence",
183
+ "deep-agents-orchestration"
184
+ ]
185
+ },
186
+ {
187
+ "id": "anthropic-langchain-tools",
188
+ "name": "Anthropic Skills",
189
+ "url": "https://github.com/anthropics/skills/tree/main/skills",
190
+ "description": "补充 MCP 构建与工具扩展能力。",
191
+ "selectedSkills": [
192
+ "mcp-builder"
193
+ ]
194
+ }
195
+ ]
196
+ },
197
+ {
198
+ "id": "hf-ml-training-evaluation",
199
+ "name": "HF ML Training Evaluation",
200
+ "description": "面向 Hugging Face 训练、评测、数据集与 demo 的 Kit。",
201
+ "policy": {
202
+ "name": "HF ML Training Evaluation",
203
+ "description": "适用于 Hugging Face / ML 训练评测工作流的 AGENTS.md 模板。",
204
+ "template": "policies/policy-hf-ml.md"
205
+ },
206
+ "sources": [
207
+ {
208
+ "id": "huggingface-ml",
209
+ "name": "Hugging Face Skills",
210
+ "url": "https://github.com/huggingface/skills/tree/main/skills",
211
+ "description": "覆盖数据集、训练、评测、实验追踪和 Gradio demo。",
212
+ "selectedSkills": [
213
+ "hugging-face-datasets",
214
+ "hugging-face-model-trainer",
215
+ "hugging-face-evaluation",
216
+ "hugging-face-trackio",
217
+ "huggingface-gradio"
218
+ ]
219
+ }
220
+ ]
221
+ },
222
+ {
223
+ "id": "literature-review-scientific-writing",
224
+ "name": "Literature Review Scientific Writing",
225
+ "description": "面向文献综述、科研写作、引用管理和同行评审的 Kit。",
226
+ "policy": {
227
+ "name": "Literature Review Scientific Writing",
228
+ "description": "适用于文献综述与科研写作的 AGENTS.md 模板。",
229
+ "template": "policies/policy-literature-review.md"
230
+ },
231
+ "sources": [
232
+ {
233
+ "id": "k-dense-literature",
234
+ "name": "K-Dense Scientific Skills",
235
+ "url": "https://github.com/K-Dense-AI/claude-scientific-skills/tree/main/scientific-skills",
236
+ "description": "覆盖文献检索、引用管理和同行评审。",
237
+ "selectedSkills": [
238
+ "literature-review",
239
+ "pubmed-database",
240
+ "arxiv-database",
241
+ "citation-management",
242
+ "peer-review"
243
+ ]
244
+ },
245
+ {
246
+ "id": "anthropic-writing",
247
+ "name": "Anthropic Skills",
248
+ "url": "https://github.com/anthropics/skills/tree/main/skills",
249
+ "description": "补充文档协作能力。",
250
+ "selectedSkills": [
251
+ "doc-coauthoring"
252
+ ]
253
+ }
254
+ ]
255
+ },
256
+ {
257
+ "id": "scientific-discovery-bioinformatics",
258
+ "name": "Scientific Discovery Bioinformatics",
259
+ "description": "面向科研、生信、单细胞、药物发现与计算化学的 Kit。",
260
+ "policy": {
261
+ "name": "Scientific Discovery Bioinformatics",
262
+ "description": "适用于科研、生信与药物发现工作流的 AGENTS.md 模板。",
263
+ "template": "policies/policy-scientific-discovery.md"
264
+ },
265
+ "sources": [
266
+ {
267
+ "id": "k-dense-discovery",
268
+ "name": "K-Dense Scientific Skills",
269
+ "url": "https://github.com/K-Dense-AI/claude-scientific-skills/tree/main/scientific-skills",
270
+ "description": "覆盖单细胞分析、生信数据库和药化工具。",
271
+ "selectedSkills": [
272
+ "anndata",
273
+ "scanpy",
274
+ "cellxgene-census",
275
+ "chembl-database",
276
+ "bindingdb-database",
277
+ "rdkit",
278
+ "uniprot-database"
279
+ ]
280
+ }
281
+ ]
282
+ },
283
+ {
284
+ "id": "security-audit-vulnerability-detection",
285
+ "name": "Security Audit Vulnerability Detection",
286
+ "description": "面向安全审计、静态分析、供应链风险与威胁建模的 Kit。",
287
+ "policy": {
288
+ "name": "Security Audit Vulnerability Detection",
289
+ "description": "适用于安全审计与漏洞检测的 AGENTS.md 模板。",
290
+ "template": "policies/policy-security-audit.md"
291
+ },
292
+ "sources": [
293
+ {
294
+ "id": "trailofbits-static-analysis",
295
+ "name": "Trail of Bits Static Analysis",
296
+ "url": "https://github.com/trailofbits/skills/tree/main/plugins/static-analysis/skills",
297
+ "description": "覆盖 CodeQL 和 Semgrep 等静态分析能力。",
298
+ "selectedSkills": [
299
+ "codeql",
300
+ "semgrep"
301
+ ]
302
+ },
303
+ {
304
+ "id": "trailofbits-supply-chain",
305
+ "name": "Trail of Bits Supply Chain",
306
+ "url": "https://github.com/trailofbits/skills/tree/main/plugins/supply-chain-risk-auditor/skills",
307
+ "description": "覆盖供应链风险分析。",
308
+ "selectedSkills": [
309
+ "supply-chain-risk-auditor"
310
+ ]
311
+ },
312
+ {
313
+ "id": "trailofbits-defaults",
314
+ "name": "Trail of Bits Defaults",
315
+ "url": "https://github.com/trailofbits/skills/tree/main/plugins/insecure-defaults/skills",
316
+ "description": "检查不安全默认配置。",
317
+ "selectedSkills": [
318
+ "insecure-defaults"
319
+ ]
320
+ },
321
+ {
322
+ "id": "openai-security-curated",
323
+ "name": "OpenAI Curated Security Skills",
324
+ "url": "https://github.com/openai/skills/tree/main/skills/.curated",
325
+ "description": "补充威胁建模与安全最佳实践。",
326
+ "selectedSkills": [
327
+ "security-best-practices",
328
+ "security-threat-model"
329
+ ]
330
+ }
331
+ ]
332
+ },
333
+ {
334
+ "id": "release-ci-automation",
335
+ "name": "Release CI Automation",
336
+ "description": "面向发布、CI、代码评审反馈处理与交付收尾的 Kit。",
337
+ "policy": {
338
+ "name": "Release CI Automation",
339
+ "description": "适用于发布、CI 与自动化维护工作的 AGENTS.md 模板。",
340
+ "template": "policies/policy-release-ci.md"
341
+ },
342
+ "sources": [
343
+ {
344
+ "id": "openai-ci-curated",
345
+ "name": "OpenAI Curated CI Skills",
346
+ "url": "https://github.com/openai/skills/tree/main/skills/.curated",
347
+ "description": "覆盖 GitHub review comment 和 CI 故障修复。",
348
+ "selectedSkills": [
349
+ "gh-address-comments",
350
+ "gh-fix-ci"
351
+ ]
352
+ },
353
+ {
354
+ "id": "superpowers-release-flow",
355
+ "name": "Superpowers Core",
356
+ "url": "https://github.com/obra/superpowers/tree/main/skills",
357
+ "description": "补充发布收尾、验证与代码评审工作流。",
358
+ "selectedSkills": [
359
+ "finishing-a-development-branch",
360
+ "verification-before-completion",
361
+ "requesting-code-review"
362
+ ]
363
+ }
364
+ ]
365
+ },
366
+ {
367
+ "id": "cloudflare-serverless-edge",
368
+ "name": "Cloudflare Serverless Edge",
369
+ "description": "面向 Cloudflare、Workers、Durable Objects 和边缘 AI agent 的 Kit。",
370
+ "policy": {
371
+ "name": "Cloudflare Serverless Edge",
372
+ "description": "适用于 Cloudflare / Serverless / Edge 工作流的 AGENTS.md 模板。",
373
+ "template": "policies/policy-cloudflare-edge.md"
374
+ },
375
+ "sources": [
376
+ {
377
+ "id": "cloudflare-skills",
378
+ "name": "Cloudflare Skills",
379
+ "url": "https://github.com/cloudflare/skills/tree/main/skills",
380
+ "description": "覆盖 Workers、Wrangler、Durable Objects、AI agents 与 MCP。",
381
+ "selectedSkills": [
382
+ "cloudflare",
383
+ "workers-best-practices",
384
+ "wrangler",
385
+ "durable-objects",
386
+ "building-ai-agent-on-cloudflare",
387
+ "building-mcp-server-on-cloudflare"
388
+ ]
389
+ },
390
+ {
391
+ "id": "openai-cloudflare-deploy",
392
+ "name": "OpenAI Cloudflare Deploy",
393
+ "url": "https://github.com/openai/skills/tree/main/skills/.curated",
394
+ "description": "补充 Cloudflare 部署能力。",
395
+ "selectedSkills": [
396
+ "cloudflare-deploy"
397
+ ]
398
+ }
399
+ ]
400
+ },
401
+ {
402
+ "id": "azure-cloud-development",
403
+ "name": "Azure Cloud Development",
404
+ "description": "面向 Azure Python 云应用、身份、搜索、消息和项目编排的 Kit。",
405
+ "policy": {
406
+ "name": "Azure Cloud Development",
407
+ "description": "适用于 Azure 云开发工作流的 AGENTS.md 模板。",
408
+ "template": "policies/policy-azure-cloud.md"
409
+ },
410
+ "sources": [
411
+ {
412
+ "id": "microsoft-azure-python",
413
+ "name": "Microsoft Skills Azure Python",
414
+ "url": "https://github.com/microsoft/skills/tree/main/.github/plugins/azure-sdk-python/skills",
415
+ "description": "覆盖 Azure 项目、身份、搜索、消息和 Python API 入口。",
416
+ "selectedSkills": [
417
+ "azure-ai-projects-py",
418
+ "azure-identity-py",
419
+ "azure-search-documents-py",
420
+ "azure-servicebus-py",
421
+ "fastapi-router-py"
422
+ ]
423
+ },
424
+ {
425
+ "id": "anthropic-azure-mcp",
426
+ "name": "Anthropic Skills",
427
+ "url": "https://github.com/anthropics/skills/tree/main/skills",
428
+ "description": "补充 MCP 和工具集成能力。",
429
+ "selectedSkills": [
430
+ "mcp-builder"
431
+ ]
432
+ }
433
+ ]
434
+ }
435
+ ]
436
+ }
@@ -0,0 +1,18 @@
1
+ # AGENTS.md
2
+
3
+ ## Project Overview
4
+
5
+ - This project targets Azure cloud application development.
6
+ - Prefer explicit service boundaries, identity handling, and environment-aware deployment choices.
7
+
8
+ ## Engineering Rules
9
+
10
+ - Keep SDK usage, infra assumptions, and app logic separated.
11
+ - Treat identity, secrets, queues, and search indexes as explicit dependencies.
12
+ - Prefer maintainable service composition over implicit framework magic.
13
+
14
+ ## Quality Bar
15
+
16
+ - Call out resource, auth, and provisioning assumptions directly.
17
+ - Document local-vs-cloud behavior differences.
18
+ - Avoid partial infra changes without noting the required follow-up steps.
@@ -0,0 +1,18 @@
1
+ # AGENTS.md
2
+
3
+ ## Project Overview
4
+
5
+ - This project targets Cloudflare, Workers, or edge-runtime deployments.
6
+ - Prefer small, deployable changes that respect edge limits and runtime constraints.
7
+
8
+ ## Engineering Rules
9
+
10
+ - Keep environment, bindings, and deployment configuration explicit.
11
+ - Design with edge latency, stateless execution, and runtime limits in mind.
12
+ - Separate local development assumptions from deployed behavior.
13
+
14
+ ## Quality Bar
15
+
16
+ - Note compatibility constraints for Workers, Durable Objects, and AI integrations.
17
+ - Highlight deployment, routing, and observability impact.
18
+ - Avoid hidden coupling between local-only tooling and edge runtime code.
@@ -0,0 +1,31 @@
1
+ # AGENTS.md
2
+
3
+ ## Project Overview
4
+
5
+ - This project uses Python for service or API development.
6
+ - Prefer explicit validation, clear contracts, and small changes with obvious rollback paths.
7
+
8
+ ## Repository Layout
9
+
10
+ - Keep route handlers, schemas, domain logic, and persistence concerns separate.
11
+ - Reuse existing package and module boundaries before adding new abstractions.
12
+
13
+ ## Dev Commands
14
+
15
+ - Run the relevant lint, typecheck, and test commands before finalizing changes.
16
+ - Re-run API- or schema-related checks if request or response shapes change.
17
+
18
+ ## Testing Instructions
19
+
20
+ - Add or update regression tests for changed service behavior.
21
+ - Cover error paths when validation, dependencies, or integrations are touched.
22
+
23
+ ## Architecture Boundaries
24
+
25
+ - Keep transport code thin and push reusable logic into shared modules.
26
+ - Make dependency, schema, and migration changes explicit.
27
+
28
+ ## PR / Change Rules
29
+
30
+ - Explain API-facing behavior changes directly.
31
+ - Note migration, validation, or compatibility risks when present.
@@ -0,0 +1,24 @@
1
+ # AGENTS.md
2
+
3
+ ## Project Overview
4
+
5
+ - This project ships product features across frontend and backend boundaries.
6
+ - Prefer small, reviewable changes with clear contracts and rollback paths.
7
+
8
+ ## Frontend Rules
9
+
10
+ - Default to React Server Components when possible.
11
+ - Keep UI state minimal and colocated.
12
+ - Avoid waterfalls, oversized client bundles, and duplicate data fetching.
13
+
14
+ ## Backend Rules
15
+
16
+ - Validate inputs at the boundary.
17
+ - Keep transport handlers thin and move business logic into services.
18
+ - Make schema, auth, and migration changes explicit.
19
+
20
+ ## Delivery Workflow
21
+
22
+ - Break work into a short plan before implementation.
23
+ - Add or update regression tests for changed behavior.
24
+ - Call out UX, API, and data-model risk clearly in the final summary.
@@ -0,0 +1,31 @@
1
+ # AGENTS.md
2
+
3
+ ## Project Overview
4
+
5
+ - This project uses Go for backend or service development.
6
+ - Prefer explicit control flow, predictable errors, and reviewable changes.
7
+
8
+ ## Repository Layout
9
+
10
+ - Keep transport, service, storage, and shared utility layers separated.
11
+ - Reuse established package boundaries before adding new ones.
12
+
13
+ ## Dev Commands
14
+
15
+ - Run the relevant Go formatting, lint, test, and build checks before finalizing changes.
16
+ - If concurrency or interfaces change, validate the directly impacted package and callers.
17
+
18
+ ## Testing Instructions
19
+
20
+ - Add regression coverage for behavior changes or bug fixes.
21
+ - Exercise timeout, cancellation, and failure paths when they are part of the change.
22
+
23
+ ## Architecture Boundaries
24
+
25
+ - Keep goroutine usage, context propagation, and error ownership explicit.
26
+ - Avoid hidden shared state or cross-package shortcuts.
27
+
28
+ ## PR / Change Rules
29
+
30
+ - Summarize affected packages and service boundaries.
31
+ - Call out concurrency, performance, or operational risk explicitly.
@@ -0,0 +1,18 @@
1
+ # AGENTS.md
2
+
3
+ ## Project Overview
4
+
5
+ - This project focuses on Hugging Face based ML workflows.
6
+ - Prefer reproducible datasets, explicit evaluation criteria, and traceable experiment changes.
7
+
8
+ ## Engineering Rules
9
+
10
+ - Separate data preparation, training, evaluation, and publishing steps.
11
+ - Record dataset and model assumptions explicitly.
12
+ - Keep training configuration and infrastructure choices reviewable.
13
+
14
+ ## Quality Bar
15
+
16
+ - Note compute, hardware, and runtime tradeoffs.
17
+ - Make metrics, checkpoints, and experiment tracking outputs explicit.
18
+ - Avoid undocumented changes to evaluation methodology.
@@ -0,0 +1,18 @@
1
+ # AGENTS.md
2
+
3
+ ## Project Overview
4
+
5
+ - This project builds LangChain or LangGraph applications.
6
+ - Optimize for explicit orchestration, reproducible agent behavior, and durable state handling.
7
+
8
+ ## Engineering Rules
9
+
10
+ - Keep prompt, tool, graph, and persistence concerns separated.
11
+ - Prefer observable, testable chains and graphs over hidden control flow.
12
+ - Make memory, checkpointing, and human-in-the-loop boundaries explicit.
13
+
14
+ ## Quality Bar
15
+
16
+ - Document graph transitions and failure paths.
17
+ - Validate retrieval, tool calling, and persistence behavior with deterministic checks when practical.
18
+ - Call out provider-specific assumptions and token-cost implications.
@@ -0,0 +1,18 @@
1
+ # AGENTS.md
2
+
3
+ ## Project Overview
4
+
5
+ - This project supports literature review and scientific writing workflows.
6
+ - Prefer evidence-first reasoning, careful citation handling, and reproducible summaries.
7
+
8
+ ## Writing Rules
9
+
10
+ - Distinguish facts from interpretation.
11
+ - Preserve source traceability for claims and conclusions.
12
+ - Keep review structure explicit: question, evidence, gaps, and synthesis.
13
+
14
+ ## Quality Bar
15
+
16
+ - Note missing evidence and uncertain claims directly.
17
+ - Keep citation and bibliography updates consistent with the text.
18
+ - Avoid overstating conclusions beyond the gathered sources.
@@ -0,0 +1,31 @@
1
+ # AGENTS.md
2
+
3
+ ## Project Overview
4
+
5
+ - This project uses a workspace or monorepo layout.
6
+ - Prefer scoped, reviewable changes with a clear impact boundary.
7
+
8
+ ## Repository Layout
9
+
10
+ - Respect package, app, and shared library boundaries.
11
+ - Reuse the existing workspace structure instead of introducing parallel module trees.
12
+
13
+ ## Dev Commands
14
+
15
+ - Run the narrowest workspace build, lint, typecheck, and test commands that validate the change.
16
+ - Note any packages or apps intentionally not rechecked.
17
+
18
+ ## Testing Instructions
19
+
20
+ - Validate the directly changed package first, then any affected downstream package if the boundary moved.
21
+ - Call out cross-package risk when shared contracts or utilities change.
22
+
23
+ ## Architecture Boundaries
24
+
25
+ - Avoid cross-package shortcuts and hidden imports.
26
+ - Keep ownership and dependency direction explicit.
27
+
28
+ ## PR / Change Rules
29
+
30
+ - Summarize which packages or apps were touched.
31
+ - State the likely blast radius and what was verified.