메뉴
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