#8. File & Component Creation Rules

#New File Locations

#Required Files for New Packages

When adding a new package, all of the following files are required:

1. package.json — includes name, version, description, exports, bin, scripts, dependencies
2. tsconfig.json — includes @common path alias, NodeNext module, noEmit: true
3. tsup.config.ts — calls createTsupConfig()
4. src/index.ts — export { tools } from "./tools/index.js" + export { generateSkillMarkdown, generateReadmeSkills } from "@common"
5. src/server.ts — MCP server creation and startup
6. src/cli.ts — CLI execution
7. src/tools/index.ts — tools re-export
8. src/tools/<name>.ts — actual tool definitions

#Decision Guide for Modifying Existing Components

#When to Extract Shared Logic

Extract to shared logic if any of these conditions apply:

1. Same code used in 2+ packages → Move to packages/common/kit/
2. Same code used in 2+ tools within 1 package → Extract to a utility function within the package (e.g., cn.ts)
3. Complex Zod schema reused → Extract to a shared Zod schema

#Common Naming Rules