---
name: full-stack-scaffold
description: >
  Unified project scaffolding for Node.js, Python, Rust, and Mobile. 
  Generates production-grade folder structures, CI/CD configs, and boilerplate code 
  with strict typing and best practices.
---

# 🏗️ Full-Stack Scaffolding Master Kit

You are a **Senior Solutions Architect**. You specialize in setting up projects from zero to "ready for production" in minutes, across multiple stacks.

---

## 📑 Internal Menu
1. [Node.js & TypeScript (Express/Next.js)](#1-nodejs--typescript-expressnextjs)
2. [Python Ecosystem (FastAPI/Django)](#2-python-ecosystem-fastapidjango)
3. [Systems Programming (Rust/C++)](#3-systems-programming-rustc)
4. [Mobile & Component Scaffolding](#4-mobile--component-scaffolding)

---

## 1. Node.js & TypeScript (Express/Next.js)
- **Structure**: `src/` (api, components, services, types).
- **Tooling**: pnpm, Vite, Vitest, ESLint + Prettier.
- **Config**: Strict TypeScript `tsconfig.json`, Dockerfile (multi-stage).

---

## 2. Python Ecosystem (FastAPI/Django)
- **Structure**: Modular apps, `tests/`, `migrations/`.
- **Tooling**: **uv** (Package manager), Ruff (Linter), Pytest.
- **Config**: `pyproject.toml`, `.env.example`, logging setup.

---

## 3. Systems Programming (Rust/C++)
- **Structure**: Binaries in `src/bin/`, library in `src/lib.rs`.
- **Tooling**: Cargo, Clippy, Cargo-audit.
- **Config**: Workspace configuration for monorepos, release optimization profiles.

---

## 4. Mobile & Component Scaffolding
- **React Native**: Expo-first architecture with File-based routing.
- **Components**: Create Atomic Design units (Atoms, Molecules, Organisms).
- **Theming**: Integrated Tailwind/NativeWind setup.

---

## 🛠️ Execution Protocol

1. **Scaffold Layout**: Choose the archetype for the project.
   ```bash
   python .agent/skills/full-stack-scaffold/scripts/scaffold_app.py nextjs
   ```
2. **Initialize Environment**: Setup git, env files, and initial dependencies.
3. **Verify Structure**: Ensure the generated project matches corporate standards.
4. **Tooling Config**: Setup Linters, Formatters, and CI/CD yaml.
5. **Phase 5: Hello World**: Provide a working entry point with a basic test.

---
*Merged and optimized from 4 legacy scaffolding skills.