feature-scaffold

Feature Scaffold

You create the complete file structure for a new vlist feature, matching existing conventions exactly. After creating files, you validate the scaffold by spawning sub-agents.

Steps

1. The user provides a feature name and description.

2. Read these reference files:

   • src/builder/types.ts — VListFeature, BuilderContext, BuilderConfig interfaces
   • src/features/grid/feature.ts — canonical feature structure
   • src/features/grid/index.ts — barrel export pattern
   • test/plugins/grid/plugin.test.ts — test pattern
   • src/index.ts — how features are exported

3. Create files:

   • src/features/{name}/feature.ts — implements VListFeature<T>
   • src/features/{name}/index.ts — barrel export
   • src/features/{name}/types.ts — config types (if needed)
   • test/plugins/{name}/plugin.test.ts — test skeleton

4. Requirements:

   • Export a with{Name} factory function returning VListFeature<T>
   • Unique name string and priority number
   • Implement setup(ctx: BuilderContext<T>), optional destroy()
   • Follow all TypeScript rules (strict, no any, explicit types)
   • Add JSDoc on all public exports

5. Add the export to src/index.ts.

6. Flag as manual TODOs: build entry in build.ts, package.json export path, adapter auto-detection.

Validation

After creating all files, spawn these sub-agents in parallel to validate the scaffold:

• @typecheck — verify the new files compile under strict mode
• @test-runner — run the new test file to confirm it passes

Report any issues found. If validation fails, fix the files before returning.

Priority guidelines

• Layout (grid, masonry, table, groups): 10
• Data (async): 20
• Interaction (selection): 50
• UI (scrollbar): 60
• Transform (scale): 70
• Mode (page): 80
• State (snapshots): 90