skillstore-cli 1.0.0

package/data/free-skills/devflow-bootstrap/plugin/skills/project-scaffold/assets/sample-output.md

@@ -0,0 +1,216 @@
+# Sample Output: NestJS Microservice
+
+## Project: `order-service`
+
+### Generated Directory Tree
+
+```
+order-service/
+├── src/
+│   ├── main.ts
+│   ├── app.module.ts
+│   ├── app.controller.ts
+│   ├── app.service.ts
+│   ├── common/
+│   │   ├── decorators/
+│   │   │   └── current-user.decorator.ts
+│   │   ├── filters/
+│   │   │   └── http-exception.filter.ts
+│   │   ├── guards/
+│   │   │   └── jwt-auth.guard.ts
+│   │   ├── interceptors/
+│   │   │   ├── logging.interceptor.ts
+│   │   │   └── transform.interceptor.ts
+│   │   ├── middleware/
+│   │   │   └── correlation-id.middleware.ts
+│   │   ├── pipes/
+│   │   │   └── validation.pipe.ts
+│   │   └── interfaces/
+│   │       └── paginated-response.interface.ts
+│   ├── config/
+│   │   ├── configuration.ts
+│   │   ├── validation.ts
+│   │   └── database.config.ts
+│   ├── modules/
+│   │   ├── orders/
+│   │   │   ├── orders.module.ts
+│   │   │   ├── orders.controller.ts
+│   │   │   ├── orders.service.ts
+│   │   │   ├── orders.repository.ts
+│   │   │   ├── dto/
+│   │   │   │   ├── create-order.dto.ts
+│   │   │   │   ├── update-order.dto.ts
+│   │   │   │   └── order-query.dto.ts
+│   │   │   ├── entities/
+│   │   │   │   ├── order.entity.ts
+│   │   │   │   └── order-item.entity.ts
+│   │   │   └── events/
+│   │   │       ├── order-created.event.ts
+│   │   │       └── order-updated.event.ts
+│   │   ├── products/
+│   │   │   ├── products.module.ts
+│   │   │   ├── products.controller.ts
+│   │   │   ├── products.service.ts
+│   │   │   ├── dto/
+│   │   │   │   └── product.dto.ts
+│   │   │   └── entities/
+│   │   │       └── product.entity.ts
+│   │   └── health/
+│   │       ├── health.module.ts
+│   │       └── health.controller.ts
+│   ├── database/
+│   │   ├── database.module.ts
+│   │   ├── migrations/
+│   │   │   └── .gitkeep
+│   │   └── seeds/
+│   │       └── .gitkeep
+│   └── messaging/
+│       ├── messaging.module.ts
+│       ├── producers/
+│       │   └── order-event.producer.ts
+│       └── consumers/
+│           └── payment-event.consumer.ts
+├── test/
+│   ├── app.e2e-spec.ts
+│   ├── jest-e2e.json
+│   └── factories/
+│       └── order.factory.ts
+├── nest-cli.json
+├── tsconfig.json
+├── tsconfig.build.json
+├── package.json
+├── .env.example
+├── .gitignore
+├── docker-compose.yml
+├── Dockerfile
+└── README.md
+```
+
+### Key Config Files
+
+**nest-cli.json**
+```json
+{
+  "$schema": "https://json.schemastore.org/nest-cli",
+  "collection": "@nestjs/schematics",
+  "sourceRoot": "src",
+  "compilerOptions": {
+    "deleteOutDir": true,
+    "assets": ["**/*.graphql"],
+    "watchAssets": true
+  }
+}
+```
+
+**tsconfig.json**
+```json
+{
+  "compilerOptions": {
+    "module": "commonjs",
+    "declaration": true,
+    "removeComments": true,
+    "emitDecoratorMetadata": true,
+    "experimentalDecorators": true,
+    "allowSyntheticDefaultImports": true,
+    "target": "ES2021",
+    "sourceMap": true,
+    "outDir": "./dist",
+    "baseUrl": "./",
+    "incremental": true,
+    "skipLibCheck": true,
+    "strictNullChecks": true,
+    "noImplicitAny": true,
+    "strictBindCallApply": true,
+    "forceConsistentCasingInFileNames": true,
+    "noFallthroughCasesInSwitch": true,
+    "paths": {
+      "@common/*": ["src/common/*"],
+      "@modules/*": ["src/modules/*"],
+      "@config/*": ["src/config/*"]
+    }
+  }
+}
+```
+
+**.env.example**
+```bash
+# Application
+APP_NAME=order-service
+APP_PORT=3000
+APP_ENV=development
+LOG_LEVEL=debug
+
+# Database
+DB_HOST=localhost
+DB_PORT=5432
+DB_USERNAME=postgres
+DB_PASSWORD=postgres
+DB_DATABASE=order_service
+
+# Redis
+REDIS_HOST=localhost
+REDIS_PORT=6379
+
+# Message Queue
+RABBITMQ_URL=amqp://guest:guest@localhost:5672
+
+# Auth
+JWT_SECRET=your-jwt-secret-change-in-production
+JWT_EXPIRATION=3600
+```
+
+**docker-compose.yml**
+```yaml
+version: '3.8'
+
+services:
+  app:
+    build:
+      context: .
+      dockerfile: Dockerfile
+    ports:
+      - "${APP_PORT:-3000}:3000"
+    env_file:
+      - .env
+    depends_on:
+      - postgres
+      - redis
+      - rabbitmq
+    volumes:
+      - .:/app
+      - /app/node_modules
+
+  postgres:
+    image: postgres:16-alpine
+    environment:
+      POSTGRES_USER: ${DB_USERNAME:-postgres}
+      POSTGRES_PASSWORD: ${DB_PASSWORD:-postgres}
+      POSTGRES_DB: ${DB_DATABASE:-order_service}
+    ports:
+      - "${DB_PORT:-5432}:5432"
+    volumes:
+      - postgres_data:/var/lib/postgresql/data
+
+  redis:
+    image: redis:7-alpine
+    ports:
+      - "${REDIS_PORT:-6379}:6379"
+
+  rabbitmq:
+    image: rabbitmq:3-management-alpine
+    ports:
+      - "5672:5672"
+      - "15672:15672"
+
+volumes:
+  postgres_data:
+```
+
+### Summary
+
+```
+Generated: 15 directories, 38 files
+Tech stack: NestJS + TypeScript + PostgreSQL + Redis + RabbitMQ
+Architecture: Modular with domain-driven structure
+Includes: Health check, CRUD scaffold, messaging, auth guards, validation
+```

package/data/free-skills/devflow-bootstrap/plugin/skills/project-scaffold/references/architecture-decisions.md

@@ -0,0 +1,254 @@
+# Architecture Decisions Reference
+
+## Monorepo vs Polyrepo Decision Matrix
+
+### Monorepo (recommended when)
+- Shared code between services exceeds 30% of codebase
+- Team size < 50 engineers working on related services
+- Unified versioning and release cycle is desired
+- Strong tooling support available (Nx, Turborepo, Bazel, Pants)
+
+### Polyrepo (recommended when)
+- Teams are fully autonomous with separate deployment cycles
+- Services have fundamentally different tech stacks
+- Organizational boundaries align with repository boundaries
+- Compliance requires separate access controls per service
+
+### Trade-off Summary
+
+| Factor              | Monorepo                        | Polyrepo                        |
+|---------------------|----------------------------------|----------------------------------|
+| Code sharing        | Easy, direct imports             | Requires published packages      |
+| CI/CD complexity    | Higher (needs affected detection)| Lower per repo, higher overall   |
+| Dependency mgmt     | Single lockfile, unified         | Independent, potential drift     |
+| Onboarding          | One clone, full context          | Multiple repos to discover       |
+| Build times         | Needs caching (Nx, Turbo)       | Naturally isolated               |
+| Access control      | Coarser (CODEOWNERS helps)      | Fine-grained per repo            |
+| Atomic changes      | Single PR across services        | Coordinated PRs across repos     |
+
+## File Naming Conventions by Ecosystem
+
+### JavaScript / TypeScript
+- Files: `kebab-case.ts` (e.g., `user-service.ts`, `auth-middleware.ts`)
+- React components: `PascalCase.tsx` (e.g., `UserProfile.tsx`, `NavBar.tsx`)
+- Test files: `*.test.ts` or `*.spec.ts` colocated with source
+- Barrel exports: `index.ts` in each module directory
+- Constants: `SCREAMING_SNAKE_CASE` for values, `kebab-case` for files
+
+### Python
+- Files: `snake_case.py` (e.g., `user_service.py`, `auth_middleware.py`)
+- Classes: `PascalCase` in `snake_case.py` files
+- Test files: `test_*.py` or `*_test.py` (pytest convention)
+- Packages: `snake_case` directory with `__init__.py`
+
+### Go
+- Files: `snake_case.go` (e.g., `user_handler.go`)
+- Packages: short, lowercase, single word preferred (`auth`, `user`, `db`)
+- Test files: `*_test.go` colocated with source
+- Internal packages: `internal/` directory for non-exported code
+
+### Java / Kotlin
+- Files: `PascalCase.java` matching class name (e.g., `UserService.java`)
+- Packages: reverse domain `com.company.project.module`
+- Test files: `*Test.java` in mirrored `src/test/` directory
+
+### Rust
+- Files: `snake_case.rs` (e.g., `user_service.rs`)
+- Modules: `snake_case` directories with `mod.rs`
+- Crate names: `kebab-case` in Cargo.toml, `snake_case` in code
+
+## Config-as-Code Patterns
+
+### Single Source of Truth Principle
+Each config tool should have exactly ONE config file that all environments reference.
+
+### TypeScript Projects
+```
+tsconfig.json              # Base config (strict mode, paths)
+tsconfig.build.json        # Extends base, excludes tests
+tsconfig.test.json         # Extends base, includes test paths
+```
+
+### ESLint + Prettier
+```
+eslint.config.mjs          # Flat config (ESLint 9+)
+.prettierrc                # Formatting rules
+.prettierignore            # Skip generated files
+```
+
+Key rule: Prettier handles formatting, ESLint handles logic. Never let them conflict.
+
+### Shared Configs in Monorepo
+```
+packages/
+  eslint-config/           # @company/eslint-config
+    index.mjs
+  tsconfig/                # @company/tsconfig
+    base.json
+    react.json
+    node.json
+```
+
+## Docker Development Setup Templates
+
+### Dockerfile.dev
+```dockerfile
+FROM node:20-alpine
+WORKDIR /app
+COPY package*.json ./
+RUN npm ci
+COPY . .
+EXPOSE 3000
+CMD ["npm", "run", "dev"]
+```
+
+### docker-compose.dev.yml
+```yaml
+version: '3.8'
+services:
+  app:
+    build:
+      context: .
+      dockerfile: Dockerfile.dev
+    volumes:
+      - .:/app
+      - /app/node_modules    # Prevent host node_modules override
+    ports:
+      - "3000:3000"
+    environment:
+      - NODE_ENV=development
+    depends_on:
+      - db
+      - redis
+  db:
+    image: postgres:16-alpine
+    environment:
+      POSTGRES_DB: app_dev
+      POSTGRES_USER: dev
+      POSTGRES_PASSWORD: dev
+    ports:
+      - "5432:5432"
+    volumes:
+      - pgdata:/var/lib/postgresql/data
+  redis:
+    image: redis:7-alpine
+    ports:
+      - "6379:6379"
+volumes:
+  pgdata:
+```
+
+### Key Patterns
+- Mount source code as volume for hot reload
+- Use named volumes for database persistence
+- Separate `node_modules` volume to avoid OS mismatch
+- Use `depends_on` with health checks for startup order
+
+## Project Structure by Framework
+
+### Next.js (App Router)
+```
+src/
+  app/
+    (auth)/                # Route group
+      login/page.tsx
+      register/page.tsx
+    (dashboard)/
+      layout.tsx
+      page.tsx
+    api/                   # API routes
+      users/route.ts
+    layout.tsx             # Root layout
+    page.tsx               # Home page
+  components/
+    ui/                    # Reusable primitives
+    features/              # Feature-specific
+  lib/                     # Utilities, clients
+  hooks/                   # Custom React hooks
+  types/                   # TypeScript types
+```
+
+### NestJS
+```
+src/
+  modules/
+    users/
+      users.controller.ts
+      users.service.ts
+      users.module.ts
+      dto/
+      entities/
+    auth/
+      auth.guard.ts
+      auth.module.ts
+      strategies/
+  common/
+    decorators/
+    filters/
+    interceptors/
+    pipes/
+  config/
+  app.module.ts
+  main.ts
+```
+
+### Django
+```
+project/
+  settings/
+    base.py
+    development.py
+    production.py
+  urls.py
+  wsgi.py
+apps/
+  users/
+    models.py
+    views.py
+    serializers.py
+    urls.py
+    tests/
+  core/
+    management/commands/
+    middleware.py
+templates/
+static/
+manage.py
+```
+
+### Spring Boot
+```
+src/main/java/com/company/app/
+  config/
+  controller/
+  service/
+  repository/
+  model/
+    entity/
+    dto/
+  exception/
+  security/
+  Application.java
+src/main/resources/
+  application.yml
+  application-dev.yml
+  application-prod.yml
+src/test/
+```
+
+### Go (Clean Architecture)
+```
+cmd/
+  server/main.go
+internal/
+  handler/               # HTTP handlers
+  service/               # Business logic
+  repository/            # Data access
+  model/                 # Domain models
+  middleware/
+pkg/                     # Shared libraries
+config/
+  config.go
+migrations/
+Makefile
+```