Skill: file-organization

Scope

• Applies to: grouping related implementation files in apps and packages, index.ts public APIs, import paths, folder naming
• Does NOT cover: Next.js lucide-style package import optimization, Fastify route structure, or Drizzle schema design

Assumptions

• TypeScript ESM with .js extensions in import specifiers
• Kebab-case directory names
• App-local group indexes use named re-exports; package subpaths may use export * when the folder is a published module boundary

Principles