scaffold

Scaffold

Generate incremental code inside an existing repository, following local codebase patterns.

Contract

Inputs:

• Scaffold target type and name
• Repository root
• Existing examples to follow

Outputs:

• Files created or modified
• Patterns copied from existing code
• Manual follow-up steps and tests to run

Creates/Modifies:

• Local source, test, and export files for the requested module/component/package
• Does not create a full product repo

External Side Effects:

• None

Confirmation Required:

• Before overwriting existing files
• Before introducing a new pattern when fewer than 3 matching examples exist

Delegates To:

• project-init-orchestrator when the user needs a whole new project
• fullstack-workspace-init / npx @shipshitdev/v0 when the user needs a new Shipshit.dev product repo
• Framework-specific skills such as nestjs-expert, react-patterns, shadcn, or typescript-expert

Steps

1. Determine what to scaffold from arguments:

   • endpoint [name] — New API endpoint (controller + service + module)
   • module [name] — New backend module with full structure
   • component [name] — New UI component with proper typing
   • package [name] — New shared package
   • collection [name] — New database collection with schema + service

2. Find 3+ existing examples:

   • Search for similar implementations in the codebase
   • Identify the exact patterns used (imports, naming, file structure)
   • Note any module-specific conventions

3. Scaffold based on type:

   API Endpoint

   • Controller, Service, Module in appropriate directory
   • Follow: auth guards, tenant filtering, serializer response

   UI Component

   • Component file with proper typing
   • Props interface in dedicated props file
   • Export from barrel

   Shared Package

   • Directory with package.json
   • Barrel export: src/index.ts
   • TypeScript config

   Database Collection

   • Schema/model file
   • Interface in shared interfaces package
   • Serializer in shared serializers package (if applicable)

4. Apply critical rules:

   • Interfaces in dedicated files, not inline
   • Path aliases, not relative imports
   • Tenant/organization filter in all queries (if applicable)

5. Report: List all files created and any manual steps needed

Arguments

• Required: what to scaffold (e.g., "endpoint tasks", "component ImageGrid", "collection workflows")