/scaffold

Scaffold a new project with a complete, production-ready structure.

Steps

1. Determine the project type from the argument:

• `api` - REST/GraphQL API backend.
• `web` - Frontend web application.
• `cli` - Command-line tool.
• `lib` - Reusable library/package.
• `fullstack` - Full-stack application.

2. Select the tech stack based on preferences or defaults:

• TypeScript: Express/Fastify, React/Next.js, Vitest.
• Python: FastAPI/Django, pytest.
• Go: Chi/Gin, standard testing.
• Rust: Actix/Axum, cargo test.

3. Generate the project structure:

• `src/` with entry point and initial modules.
• `tests/` with test configuration and example tests.
• Configuration files (tsconfig, eslint, prettier, etc.).
• `Dockerfile` and `.dockerignore`.
• CI/CD workflow (GitHub Actions).
• `README.md` with setup instructions.
• `.env.example` with documented variables.
• `.gitignore` with comprehensive patterns.

4. Initialize package manager and install dependencies. 5. Initialize git repository with initial commit. 6. Verify the project builds and tests pass.

Format

Project scaffolded: <name>
Type: <project-type>
Stack: <tech-stack>

Structure:
  src/          - Application source
  tests/        - Test suite
  .github/      - CI/CD workflows
  docker/       - Container configuration

Commands:
  dev:   <command>
  test:  <command>
  build: <command>

Rules

• Every scaffold must include a working test and build pipeline from the start.
• Include health check endpoint for API projects.
• Add pre-commit hooks for linting and formatting.
• Use the latest stable versions of all dependencies.
• Generate a CLAUDE.md with project-specific memory from the start.