Project Scaffold

Purpose

• .agents/

  folder structure for AI-first development
• Backend (NestJS) with MongoDB, Swagger, and best practices
• Frontend (NextJS) with Tailwind and @agenticindiedev/ui
• Mobile (Expo) with React Native and Expo Router
• Browser Extension (Plasmo) with React and Tailwind

When to Use

• Starting a new project from scratch
• Adding components to an existing project
• Setting up a monorepo or separate repositories
• Need a unified scaffolding experience across Claude, Codex, and Cursor

Usage

Interactive Mode (Recommended)

python3 ~/.claude/skills/project-scaffold/scripts/scaffold.py

1. Project name
2. Project root path
3. Repository structure (monorepo vs separate)
4. Components to scaffold (all optional):
   • .agent folder
   • Backend (NestJS)
   • Frontend (NextJS)
   • Mobile (Expo)
   • Extension (Plasmo)
5. Organization name (for monorepo packages)

From Claude

python3 ~/.claude/skills/project-scaffold/scripts/scaffold.py

Features

Flexible Structure

• Monorepo: All components in one repository with workspace configuration
• Separate repos: Each component in its own directory/repository
• Existing projects: Can add components to existing projects

Component Options

• .agents/

  folder with full AI documentation structure
• Backend with NestJS, MongoDB, Swagger
• Frontend with NextJS 15, Tailwind, @agenticindiedev/ui
• Mobile with Expo Router, React Native
• Extension with Plasmo, React, Tailwind

Cross-Platform

• Claude Code
• Codex
• Cursor

Generated Structure

Monorepo Example

myproject/
├── .agents/                  # AI documentation
├── package.json             # Workspace root
├── api/                     # NestJS backend
│   ├── .agents/
│   ├── apps/api/src/
│   └── package.json
├── frontend/                # NextJS apps
│   ├── .agents/
│   ├── apps/dashboard/
│   └── package.json
├── mobile/                  # Expo app
│   ├── .agents/
│   ├── app/
│   └── package.json
└── extension/               # Plasmo extension
    ├── .agents/
    ├── src/
    └── package.json

Separate Repos Example

myproject-api/               # Backend only
├── .agents/
├── apps/api/src/
└── package.json

myproject-frontend/          # Frontend only
├── .agents/
├── apps/dashboard/
└── package.json

Key Patterns Included

Backend (NestJS)

• Soft deletes:

  isDeleted: boolean

• Multi-tenancy: Always filter by

  organization

• Collection pattern: controllers → services → schemas
• Swagger documentation
• Dockerfile included

Frontend (NextJS)

• Path aliases:

  @components/

  ,

  @services/

  ,

  @hooks/

• Tailwind CSS with @agenticindiedev/ui
• TypeScript strict mode
• App Router structure

Mobile (Expo)

• Expo Router for navigation
• TypeScript configuration
• Platform-specific configurations

Extension (Plasmo)

• React + TypeScript
• Tailwind CSS with @agenticindiedev/ui
• Manifest configuration
• Popup component

Next Steps After Scaffolding

1. Install dependencies:
   bash

   cd [project-root]
   bun install

2. Start development:
   bash

   # Monorepo
   bun run dev:api
   bun run dev:frontend
   
   # Separate repos
   cd api && bun run start:dev
   cd frontend && bun run dev

3. Customize:
   • Update

     .agents/SYSTEM/RULES.md

     with your coding standards
   • Configure environment variables
   • Add your first features

Integration with Existing Skills

• agent-folder-init

  : Uses its script for .agent folder scaffolding

• fullstack-workspace-init

  : Reuses component templates and patterns

Troubleshooting

~/.claude/skills/project-scaffold/

chmod +x ~/.claude/skills/project-scaffold/scripts/scaffold.py

agent-folder-init