multi-agents-cli 1.0.51 → 1.0.53

package/core/templates/.frameworks/backend/fastify.md

@@ -0,0 +1,74 @@
+# Fastify — Scaffold Instructions
+
+## Scaffold Location
+
+Fastify has no official scaffold CLI. Create the structure manually inside `backend/`:
+
+```bash
+mkdir -p backend/src/routes
+mkdir -p backend/src/plugins
+mkdir -p backend/src/schemas
+mkdir -p backend/src/services
+mkdir -p backend/src/types
+touch backend/src/app.ts
+touch backend/src/index.ts
+```
+
+## package.json
+
+```json
+{
+  "name": "backend",
+  "version": "1.0.0",
+  "scripts": {
+    "dev": "tsx watch src/index.ts",
+    "build": "tsc",
+    "start": "node dist/index.js"
+  },
+  "dependencies": {
+    "fastify": "^4.0.0",
+    "@fastify/cors": "^8.0.0",
+    "dotenv": "^16.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.0.0",
+    "tsx": "^4.0.0"
+  }
+}
+```
+
+## app.ts Template
+
+```typescript
+import Fastify from 'fastify';
+import cors from '@fastify/cors';
+
+export const app = Fastify({ logger: true });
+
+await app.register(cors, {
+  origin: process.env.CLIENT_URL || 'http://localhost:3000',
+});
+
+app.get('/health', async () => ({ status: 'ok' }));
+```
+
+## Post-Scaffold
+
+```bash
+cd backend && npm install
+```
+
+## Update .scaffold/.paths.json
+
+```json
+{
+  "backend": {
+    "typesDir": {
+      "expected": "backend/src/types",
+      "current": "backend/src/types",
+      "status": "verified"
+    }
+  }
+}
+```

package/core/templates/.frameworks/backend/nestjs.md

@@ -0,0 +1,75 @@
+# NestJS — Scaffold Instructions
+
+## Critical: Scaffold Location
+
+You are working inside a git worktree. Your root is the **repo root**, not `backend/`.
+All NestJS files MUST live under `backend/`. Do NOT scaffold at the repo root.
+
+NestJS's `nest new` creates a subfolder by default. To scaffold in place:
+
+```bash
+# From the REPO ROOT — scaffold directly into backend/
+nest new . --directory backend --skip-git --package-manager npm
+```
+
+OR scaffold with period to use current directory:
+```bash
+cd backend
+nest new . --skip-git --package-manager npm
+```
+
+## Expected Structure After Scaffold
+
+```
+backend/
+  src/
+    app.controller.ts
+    app.controller.spec.ts
+    app.module.ts
+    app.service.ts
+    main.ts
+  test/
+  nest-cli.json
+  package.json
+  tsconfig.json
+  tsconfig.build.json
+```
+
+## Verify Location
+
+After scaffolding, confirm:
+```bash
+ls backend/src/main.ts     # should exist
+ls backend/nest-cli.json   # should exist
+```
+
+If files landed at `backend/my-app/` instead of `backend/` — move them up:
+```bash
+mv backend/my-app/* backend/
+mv backend/my-app/.* backend/ 2>/dev/null || true
+rmdir backend/my-app
+```
+
+## Post-Scaffold
+
+```bash
+cd backend
+npm install
+```
+
+## Update .scaffold/.paths.json
+
+After scaffolding, update `current` paths and set `status: verified`:
+```json
+{
+  "backend": {
+    "dtoDir": {
+      "expected": "backend/src/dto",
+      "current": "backend/src/dto",
+      "status": "verified"
+    }
+  }
+}
+```
+
+Create `backend/src/dto/` if it doesn't exist.

package/core/templates/.frameworks/client/angular.md

@@ -0,0 +1,80 @@
+# Angular — Scaffold Instructions
+
+## Critical: Scaffold Location
+
+You are working inside a git worktree. Your root is the **repo root**, not `client/`.
+All Angular files MUST live under `client/`. Do NOT scaffold at the repo root.
+
+Angular's `ng new` creates a subfolder by default. To scaffold correctly:
+
+```bash
+# From the REPO ROOT — create a temp app, then move files into client/
+ng new temp-app --directory client --skip-git --routing --style=scss
+```
+
+OR using the `--directory` flag directly:
+
+```bash
+ng new my-app --directory client --skip-git --routing --style=scss
+```
+
+This places all Angular files inside `client/` at the correct level.
+
+## Expected Structure After Scaffold
+
+```
+client/
+  src/
+    app/
+      app.component.ts
+      app.component.html
+      app.config.ts
+      app.routes.ts
+    assets/
+    index.html
+    main.ts
+    styles.scss
+  angular.json
+  package.json
+  tsconfig.json
+  tsconfig.app.json
+```
+
+## Verify Location
+
+After scaffolding, confirm:
+```bash
+ls client/src/app/   # should show app.component.ts
+ls client/angular.json  # should exist
+```
+
+If files landed at `client/my-app/` instead of `client/` — move them up:
+```bash
+mv client/my-app/* client/
+mv client/my-app/.* client/ 2>/dev/null || true
+rmdir client/my-app
+```
+
+## Post-Scaffold
+
+```bash
+cd client
+npm install
+```
+
+## Update .scaffold/.paths.json
+
+After scaffolding, update `current` paths and set `status: verified`:
+```json
+{
+  "client": {
+    "typesDir": {
+      "expected": "client/src/app/core/types",
+      "current": "client/src/app/core/types",
+      "status": "verified"
+    }
+  }
+}
+```
+
+Create `client/src/app/core/types/` if it doesn't exist — this is where shared types live.

package/core/templates/.frameworks/client/nextjs.md

@@ -0,0 +1,47 @@
+# Next.js — Scaffold Instructions
+
+## Scaffold Location
+
+Scaffold directly into `client/` from the repo root:
+
+```bash
+npx create-next-app@latest client --typescript --tailwind --eslint --app --src-dir --import-alias "@/*" --no-git
+```
+
+## Expected Structure After Scaffold
+
+```
+client/
+  src/
+    app/
+      layout.tsx
+      page.tsx
+      globals.css
+    lib/
+  public/
+  next.config.ts
+  package.json
+  tsconfig.json
+  tailwind.config.ts
+  postcss.config.mjs
+```
+
+## Post-Scaffold
+
+Dependencies are installed automatically by create-next-app.
+
+## Update .scaffold/.paths.json
+
+```json
+{
+  "client": {
+    "typesDir": {
+      "expected": "client/src/types",
+      "current": "client/src/types",
+      "status": "verified"
+    }
+  }
+}
+```
+
+Create `client/src/types/` — this is where shared types live.

package/core/templates/.frameworks/client/nuxt.md

@@ -0,0 +1,45 @@
+# Nuxt — Scaffold Instructions
+
+## Scaffold Location
+
+Scaffold directly into `client/` from the repo root:
+
+```bash
+npx nuxi@latest init client --no-install --no-gitInit
+cd client && npm install
+```
+
+## Expected Structure After Scaffold
+
+```
+client/
+  assets/
+  components/
+  composables/
+  layouts/
+  pages/
+    index.vue
+  plugins/
+  public/
+  server/
+  app.vue
+  nuxt.config.ts
+  package.json
+  tsconfig.json
+```
+
+## Update .scaffold/.paths.json
+
+```json
+{
+  "client": {
+    "typesDir": {
+      "expected": "client/types",
+      "current": "client/types",
+      "status": "verified"
+    }
+  }
+}
+```
+
+Create `client/types/` — this is where shared types live.

package/core/templates/.frameworks/client/remix.md

@@ -0,0 +1,44 @@
+# Remix — Scaffold Instructions
+
+## Scaffold Location
+
+Scaffold directly into `client/` from the repo root:
+
+```bash
+npx create-remix@latest client --no-install --no-git-init --template remix
+cd client && npm install
+```
+
+## Expected Structure After Scaffold
+
+```
+client/
+  app/
+    routes/
+      _index.tsx
+    root.tsx
+    entry.client.tsx
+    entry.server.tsx
+    tailwind.css
+  public/
+  package.json
+  tsconfig.json
+  vite.config.ts
+  remix.config.js
+```
+
+## Update .scaffold/.paths.json
+
+```json
+{
+  "client": {
+    "typesDir": {
+      "expected": "client/app/types",
+      "current": "client/app/types",
+      "status": "verified"
+    }
+  }
+}
+```
+
+Create `client/app/types/` — this is where shared types live.

package/core/templates/.frameworks/client/sveltekit.md

@@ -0,0 +1,44 @@
+# SvelteKit — Scaffold Instructions
+
+## Scaffold Location
+
+Scaffold directly into `client/` from the repo root:
+
+```bash
+npx sv create client --template minimal --types ts --no-add-ons --no-install
+cd client && npm install
+```
+
+## Expected Structure After Scaffold
+
+```
+client/
+  src/
+    lib/
+      index.ts
+    routes/
+      +page.svelte
+    app.html
+    app.d.ts
+  static/
+  svelte.config.js
+  vite.config.ts
+  package.json
+  tsconfig.json
+```
+
+## Update .scaffold/.paths.json
+
+```json
+{
+  "client": {
+    "typesDir": {
+      "expected": "client/src/lib/types",
+      "current": "client/src/lib/types",
+      "status": "verified"
+    }
+  }
+}
+```
+
+Create `client/src/lib/types/` — this is where shared types live.

package/core/templates/.frameworks/client/vite-react.md

@@ -0,0 +1,45 @@
+# Vite + React — Scaffold Instructions
+
+## Scaffold Location
+
+Scaffold directly into `client/` from the repo root:
+
+```bash
+npm create vite@latest client -- --template react-ts
+cd client && npm install
+```
+
+## Expected Structure After Scaffold
+
+```
+client/
+  src/
+    assets/
+    App.tsx
+    App.css
+    main.tsx
+    index.css
+    vite-env.d.ts
+  public/
+  index.html
+  package.json
+  tsconfig.json
+  tsconfig.node.json
+  vite.config.ts
+```
+
+## Update .scaffold/.paths.json
+
+```json
+{
+  "client": {
+    "typesDir": {
+      "expected": "client/src/types",
+      "current": "client/src/types",
+      "status": "verified"
+    }
+  }
+}
+```
+
+Create `client/src/types/` — this is where shared types live.