القائمة
Add a new package to the agentick monorepo. Use when creating a new @agentick/* package.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Create a new agentick tool using createTool. Use when asked to add a tool, create a tool, or implement tool functionality.
Create a new agentick lifecycle hook or custom hook. Use when asked to add a hook, create reactive behavior, or implement lifecycle logic.
Build, typecheck, and test the agentick monorepo. Use when asked to verify changes, run checks, or ensure nothing is broken.
Test an agentick agent with mock model responses. Use when asked to write tests, test an agent, or verify agent behavior.
Create a new model adapter for agentick. Use when asked to add support for a new model provider (Anthropic, Mistral, Cohere, etc).
Create a new agentick JSX component. Use when asked to add a component, create a UI primitive, or build a reusable agent building block.
| name | add-package |
| description | Add a new package to the agentick monorepo. Use when creating a new @agentick/* package. |
Agentick is a pnpm workspace monorepo. New packages go in packages/.
mkdir -p packages/my-package/src
packages/my-package/package.json:{
"name": "@agentick/my-package",
"version": "0.1.0",
"description": "Description of the package",
"keywords": ["agent", "ai"],
"license": "MIT",
"author": "Ryan Lindgren",
"repository": {
"type": "git",
"url": "git+https://github.com/agenticklabs/agentick.git",
"directory": "packages/my-package"
},
"files": ["dist"],
"type": "module",
"main": "src/index.ts",
"exports": {
".": "./src/index.ts"
},
"publishConfig": {
"access": "public",
"exports": {
".": {
"types": "./dist/index.d.ts",
"import": "./dist/index.js"
}
},
"main": "./dist/index.js",
"types": "./dist/index.d.ts"
},
"scripts": {
"build": "tsc -p tsconfig.build.json",
"test": "echo \"Tests run from workspace root\"",
"typecheck": "tsc -p tsconfig.build.json --noEmit",
"clean": "rm -rf dist tsconfig.build.tsbuildinfo",
"prepublishOnly": "pnpm build",
"dev": "tsc --watch"
},
"dependencies": {
"@agentick/kernel": "workspace:*",
"@agentick/shared": "workspace:*"
}
}
packages/my-package/tsconfig.json:{
"extends": "../../tsconfig.json",
"compilerOptions": {
"rootDir": "src",
"outDir": "dist",
"tsBuildInfoFile": "dist/.tsbuildinfo",
"composite": true
},
"include": [],
"references": [{ "path": "./tsconfig.build.json" }]
}
packages/my-package/tsconfig.build.json:{
"extends": "./tsconfig.json",
"compilerOptions": {
"tsBuildInfoFile": "dist/.tsbuildinfo.build"
},
"include": ["src"],
"exclude": ["src/**/*.spec.ts", "src/**/__tests__"]
}
packages/my-package/src/index.ts:export { myFunction } from "./my-module.js";
export type { MyType } from "./types.js";
.changeset/config.json:Add "@agentick/my-package" to the linked[0] array so it's version-coordinated with other packages.
website/typedoc.json:Add "../packages/my-package" to the entryPoints array for API docs generation.
website/.vitepress/config.mts:Add "@agentick/my-package" to the appropriate group in the PACKAGE_GROUPS array.
packages/my-package/README.md:Write a README following the style of existing packages. Include: Purpose, Quick Start, API reference, Patterns.
pnpm install
pnpm --filter @agentick/my-package typecheck
pnpm typecheck # verify no cross-package issues
Respect the package hierarchy:
kernel, shared): No agentick dependenciescore): Depends on kernel, sharedgateway, client, server, express, devtools, sandbox): Depends on core/kernel/sharedopenai, google, ai-sdk): Depends on core, shared@agentick/my-packagesrc/, tests as *.spec.ts siblings or in __tests__/index.ts barrel export per packageworkspace:* for internal dependencies"type": "module")tsc (not tsup)tsconfig.json (references) + tsconfig.build.json (includes src, excludes tests)pnpm-workspace.yamltsconfig.json.changeset/config.jsonwebsite/typedoc.jsonwebsite/.vitepress/config.mtspackages/*/package.json