create-claude-workspace 1.1.62 → 1.1.63

package/dist/template/.claude/agents/orchestrator.md

@@ -91,11 +91,19 @@ At the beginning of EVERY session (including every Ralph Loop iteration):
 - Store these in MEMORY.md under a `## Session Config` section if not already present
 - **If Session Config has "TBD" values** (new project before Phase 0): scan `apps/` directory. If apps now exist (Phase 0 completed), update the values. If still empty, keep "TBD" — Phase 0 scaffolding will create them.
 
-### 3. Validate agents are available
+### 3. Ensure git identity for commits
+- Check `git config user.name` and `git config user.email`. If either is empty, set them:
+  ```bash
+  git config user.name "Claude Code" 2>/dev/null || git config --global user.name "Claude Code"
+  git config user.email "claude@localhost" 2>/dev/null || git config --global user.email "claude@localhost"
+  ```
+- This prevents commits from inheriting the host user's identity. Must be set BEFORE any commit step.
+
+### 4. Validate agents are available
 - Check that `.claude/agents/` contains required agent files: `orchestrator.md`, `project-initializer.md`, `ui-engineer.md`, `backend-ts-architect.md`, `senior-code-reviewer.md`, `test-engineer.md`, `devops-integrator.md`, `deployment-engineer.md`, `product-owner.md`, `technical-planner.md`
 - If any critical agent file is missing (architect, reviewer, test-engineer), log to MEMORY.md and STOP — autonomous development requires all agents
 
-### 4. Reconcile working state
+### 5. Reconcile working state
 Before doing anything, check for unexpected state from user intervention or previous session:
 - **Worktree recovery**: Read MEMORY.md `Current Worktree`. If set, check if the worktree directory exists:
   - Worktree exists + `Current Step` is set → resume from that step (continue working in the worktree)
@@ -124,25 +132,25 @@ Before doing anything, check for unexpected state from user intervention or prev
   - If not merged: create a worktree from this branch (`git worktree add .worktrees/{branch} {branch}`), switch project root back to main (`git checkout main 2>/dev/null || git checkout master`), and resume from the worktree
 - Check if TODO.md or MEMORY.md were manually edited (compare git diff) → accept changes, adjust plan
 
-### 5. Check required files exist
+### 6. Check required files exist
 Resolve in THIS order (each depends on the previous):
 1. `CLAUDE.md` missing -> STOP. Run `project-initializer` agent.
 2. `PRODUCT.md` missing -> Delegate to `product-owner` agent. Needs CLAUDE.md.
 3. `TODO.md` missing -> Delegate to `technical-planner` agent. Needs PRODUCT.md + CLAUDE.md.
 4. `MEMORY.md` missing -> Create it (see MEMORY.md template below).
 
-### 6. Sync with main branch
+### 7. Sync with main branch
 Project root should be on `main`/`master`. If remote exists (`git remote -v | grep origin`):
 ```bash
 git pull --rebase origin HEAD
 ```
 If no remote, skip this step.
 
-### 7. Check git log and structure
+### 8. Check git log and structure
 - `git log --oneline -10`
 - Scan current file structure
 
-### 8. Detect PLAN.md changes
+### 9. Detect PLAN.md changes
 If `PLAN.md` exists in the project root, check whether it changed since the last session. This runs AFTER git sync (step 6) to avoid commit conflicts with remote changes.
 
 1. Read PLAN.md content
@@ -174,7 +182,7 @@ If `PLAN.md` exists in the project root, check whether it changed since the last
   - `Constraints` → compare coverage threshold against CLAUDE.md code quality section
 - If a PLAN.md value differs from the corresponding project file value, that section "changed"
 
-### 9. Retroactive git integration sync
+### 10. Retroactive git integration sync
 - **Trigger condition**: remote exists (`git remote -v | grep origin`) AND TODO.md exists with tasks BUT no `<!-- #N -->` markers found in TODO.md AND CLI is available (`gh --version` or `glab --version`) AND auth is valid (`gh auth status` or `glab auth status`)
 - This means work was done locally without git integration (token was missing or platform wasn't set up), and now it's available
 - Delegate to `devops-integrator` agent:
@@ -190,7 +198,7 @@ If `PLAN.md` exists in the project root, check whether it changed since the last
 - Log in MEMORY.md Notes: "Retroactive git sync completed — [N] issues created, [M] marked as done"
 - Skip if any trigger condition is not met (no remote, no TODO.md, markers already present, CLI missing, auth invalid)
 
-### 10. Kit version check (CLAUDE.md refresh on upgrade)
+### 11. Kit version check (CLAUDE.md refresh on upgrade)
 - Read `.claude/.kit-version` — if it exists and differs from MEMORY.md `Kit_Version` (or `Kit_Version` is absent):
   - The `create-claude-workspace` kit was updated. Agent instructions and templates may have changed.
   - Run `/revise-claude-md` to reconcile the project's CLAUDE.md with any new conventions from the updated kit template (`.claude/templates/claude-md.md`).
@@ -199,13 +207,13 @@ If `PLAN.md` exists in the project root, check whether it changed since the last
   - Commit if changes were made: `git add CLAUDE.md MEMORY.md && git commit -m "chore: update CLAUDE.md for kit version [version]"`. Push if remote exists.
 - Skip if `.claude/.kit-version` does not exist.
 
-### 11. Ingest external issues (if git integration active)
+### 12. Ingest external issues (if git integration active)
 - **Only run at phase transitions** — not every invocation
 - Delegate to `devops-integrator` agent: "Run external issue intake — check for new issues on GitHub/GitLab that are not yet in TODO.md. Ingest bugs and feature requests."
 - If new bugs are found with `critical` or `priority::high` label, they become the next task
 - Skip if no git integration or platform is unreachable
 
-### 12. One task per invocation
+### 13. One task per invocation
 - Complete exactly ONE task per invocation, then end the session cleanly.
 - The external loop (`autonomous.mjs` or ralph-loop) handles iteration control — you do NOT need to manage capacity, iteration counters, or session bounds.
 - After committing the task (STEP 11) and post-merge (STEP 12), EXIT. Do NOT update MEMORY.md after merge — it was already committed in STEP 11 and arrived on main via merge. Do NOT ask whether to continue, do NOT wait for confirmation, do NOT start another task. Do NOT create any commits after merge.

package/dist/template/.claude/templates/.lefthook.yml

@@ -0,0 +1,12 @@
+pre-commit:
+  parallel: true
+  commands:
+    prettier:
+      glob: "*.{ts,html,scss,json,md}"
+      run: npx prettier --check {staged_files}
+    eslint:
+      glob: "*.ts"
+      run: npx eslint {staged_files}
+    stylelint:
+      glob: "*.scss"
+      run: npx stylelint {staged_files}

package/dist/template/.claude/templates/.prettierrc

@@ -0,0 +1,12 @@
+{
+  "printWidth": 100,
+  "tabWidth": 2,
+  "useTabs": false,
+  "semi": true,
+  "singleQuote": true,
+  "trailingComma": "all",
+  "bracketSpacing": true,
+  "arrowParens": "avoid",
+  "bracketSameLine": true,
+  "singleAttributePerLine": true
+}

package/dist/template/.claude/templates/.stylelintrc.json

@@ -0,0 +1,15 @@
+{
+  "extends": ["stylelint-config-standard-scss", "stylelint-config-recess-order"],
+  "plugins": ["stylelint-order"],
+  "rules": {
+    "color-no-hex": true,
+    "color-named": "never",
+    "declaration-no-important": true,
+    "max-nesting-depth": [3, { "ignore": ["at-rules", "pseudo-classes"] }],
+    "selector-class-pattern": "^(lib-)?[a-z0-9]+(-[a-z0-9]+)*$",
+    "scss/selector-no-redundant-nesting-selector": true,
+    "scss/at-function-pattern": "^[a-z]([a-z0-9-]*[a-z0-9])?$",
+    "scss/at-mixin-pattern": "^[a-z]([a-z0-9-]*[a-z0-9])?$",
+    "scss/dollar-variable-pattern": "^[a-z]([a-z0-9-]*[a-z0-9])?$"
+  }
+}

package/dist/template/.claude/templates/claude-md.md

@@ -292,182 +292,23 @@ nx affected --target=test -- --coverage  # all affected
 
 ### Code Quality & Linting
 
-**ESLint** (flat config `eslint.config.js`, strict):
-
-Preset: `@typescript-eslint/strict-type-checked` + `@nx/eslint-plugin` + framework-specific plugins (see `.claude/profiles/frontend.md`)
-
-```javascript
-// eslint.config.js — root (framework-agnostic base)
-import js from '@eslint/js';
-import tseslint from 'typescript-eslint';
-import nx from '@nx/eslint-plugin';
-import simpleImportSort from 'eslint-plugin-simple-import-sort';
-import preferArrowFunctions from 'eslint-plugin-prefer-arrow-functions';
-
-export default [
-  { ignores: ['**/dist', '**/node_modules', '**/.nx'] },
-
-  // TypeScript files
-  {
-    files: ['**/*.ts'],
-    extends: [
-      js.configs.recommended,
-      ...tseslint.configs.strictTypeChecked,
-      ...nx.configs['flat/base'],
-      ...nx.configs['flat/typescript'],
-    ],
-    languageOptions: {
-      parserOptions: { projectService: true },
-    },
-    plugins: {
-      'simple-import-sort': simpleImportSort,
-      'prefer-arrow-functions': preferArrowFunctions,
-    },
-    rules: {
-      // Modern JS syntax (STRICT)
-      'prefer-const': 'error',
-      'no-var': 'error',
-      'prefer-arrow-callback': 'error',
-      'prefer-template': 'error',
-      'object-shorthand': 'error',
-      'prefer-destructuring': ['error', { object: true, array: false }],
-      'prefer-arrow-functions/prefer-arrow-functions': ['error', {
-        returnStyle: 'implicit',
-      }],
-      'max-classes-per-file': ['error', 1],
-      'max-depth': ['error', 4],
-      'no-restricted-syntax': [
-        'error',
-        {
-          selector: 'CallExpression[callee.property.name="forEach"]',
-          message: 'Use for...of instead of .forEach()',
-        },
-        {
-          selector: 'TSAsExpression > TSUnknownKeyword',
-          message: 'Do not use `as unknown as T` double-casting. Fix types or use type guards.',
-        },
-      ],
-
-      // TypeScript strict
-      '@typescript-eslint/no-non-null-assertion': 'error',
-      '@typescript-eslint/consistent-type-assertions': ['error', {
-        assertionStyle: 'as',
-        objectLiteralTypeAssertions: 'never',
-      }],
-      '@typescript-eslint/no-explicit-any': 'error',
-      '@typescript-eslint/no-unused-vars': ['error', { argsIgnorePattern: '^_' }],
-      '@typescript-eslint/consistent-type-imports': ['error', { prefer: 'type-imports' }],
-      '@typescript-eslint/explicit-function-return-type': ['error', {
-        allowExpressions: true,
-        allowTypedFunctionExpressions: true,
-      }],
-      '@typescript-eslint/explicit-member-accessibility': ['error', {
-        accessibility: 'explicit',
-        overrides: { constructors: 'no-public' },
-      }],
-      '@typescript-eslint/prefer-readonly': 'error',
-      '@typescript-eslint/no-floating-promises': 'error',
-      '@typescript-eslint/no-misused-promises': 'error',
-      '@typescript-eslint/prefer-for-of': 'error',
-      '@typescript-eslint/prefer-nullish-coalescing': 'error',
-      '@typescript-eslint/prefer-optional-chain': 'error',
-      '@typescript-eslint/strict-boolean-expressions': 'error',
-
-      // No eslint-disable comments — fix code, don't suppress rules
-      'no-warning-comments': ['error', { terms: ['eslint-disable'] }],
-
-      // Import sorting
-      'simple-import-sort/imports': 'error',
-      'simple-import-sort/exports': 'error',
-
-      // Nx module boundaries
-      '@nx/enforce-module-boundaries': ['error', {
-        enforceBuildableLibDependencies: true,
-        allow: [],
-        depConstraints: [
-          { sourceTag: 'type:domain', onlyDependOnLibsWithTags: ['type:domain'] },
-          { sourceTag: 'type:business', onlyDependOnLibsWithTags: ['type:domain', 'type:business', 'type:shared'] },
-          { sourceTag: 'type:infrastructure', onlyDependOnLibsWithTags: ['type:domain', 'type:shared'] },
-          { sourceTag: 'type:data-access', onlyDependOnLibsWithTags: ['type:domain', 'type:shared'] },
-          { sourceTag: 'type:ui', onlyDependOnLibsWithTags: ['type:domain', 'type:ui', 'type:shared'] },
-          { sourceTag: 'type:feature', onlyDependOnLibsWithTags: ['type:ui', 'type:data-access', 'type:domain', 'type:shared'] },
-          { sourceTag: 'type:api', onlyDependOnLibsWithTags: ['type:business', 'type:domain', 'type:shared'] },
-          { sourceTag: 'type:app', onlyDependOnLibsWithTags: ['type:feature', 'type:ui', 'type:shared'] },
-        ],
-      }],
-    },
-  },
-
-  // Framework-specific rules — see .claude/profiles/frontend.md for additional ESLint config
-  // (e.g., Angular template/component rules, React hooks rules, etc.)
-
-  // Disable type-checked rules for plain JS config files (no tsconfig coverage)
-  { files: ['**/*.js', '**/*.mjs'], ...tseslint.configs.disableTypeChecked },
-];
-```
+Config templates are in `.claude/templates/` — copy to project root during Phase 0 scaffolding:
+- **ESLint**: `.claude/templates/eslint.config.js` → `eslint.config.js` (flat config, `@typescript-eslint/strict-type-checked` + `@nx/eslint-plugin` + `eslint-plugin-simple-import-sort` + `eslint-plugin-prefer-arrow-functions`). Add framework-specific rules from `.claude/profiles/frontend.md`.
+- **Prettier**: `.claude/templates/.prettierrc` → `.prettierrc`
+- **Stylelint**: `.claude/templates/.stylelintrc.json` → `.stylelintrc.json` (SCSS only, forces theme tokens over hardcoded colors)
+- **Pre-commit hooks**: `.claude/templates/.lefthook.yml` → `.lefthook.yml`
 
 Each library's `project.json` must declare tags: `"tags": ["type:domain", "scope:auth"]`
 
-**Prettier** (consistent formatting):
-```jsonc
-// .prettierrc
-{
-  "printWidth": 100,
-  "tabWidth": 2,
-  "useTabs": false,
-  "semi": true,
-  "singleQuote": true,
-  "trailingComma": "all",
-  "bracketSpacing": true,
-  "arrowParens": "avoid",
-  "bracketSameLine": true,
-  "singleAttributePerLine": true
-}
-```
-- Single config in root `.prettierrc` — no per-project overrides
-- Runs on commit via pre-commit hooks
-- `eslint-config-prettier` installed to disable conflicting ESLint rules
-- Do NOT use `eslint-plugin-prettier` (couples formatter to linter, slower)
-
-**Stylelint** (SCSS quality):
-```jsonc
-// .stylelintrc.json
-{
-  "extends": ["stylelint-config-standard-scss", "stylelint-config-recess-order"],
-  "plugins": ["stylelint-order"],
-  "rules": {
-    "color-no-hex": true,
-    "color-named": "never",
-    "declaration-no-important": true,
-    "max-nesting-depth": [3, { "ignore": ["at-rules", "pseudo-classes"] }],
-    "selector-class-pattern": "^(lib-)?[a-z0-9]+(-[a-z0-9]+)*$",
-    "scss/selector-no-redundant-nesting-selector": true,
-    "scss/at-function-pattern": "^[a-z]([a-z0-9-]*[a-z0-9])?$",
-    "scss/at-mixin-pattern": "^[a-z]([a-z0-9-]*[a-z0-9])?$",
-    "scss/dollar-variable-pattern": "^[a-z]([a-z0-9-]*[a-z0-9])?$"
-  }
-}
-```
-- `color-no-hex` + `color-named: never` → forces use of theme tokens (see frontend profile for theme function names)
-- `stylelint-config-recess-order` for logical property ordering
-- Integrated as Nx target or via pre-commit hooks
-
-**Pre-commit hooks** (lefthook or husky + lint-staged):
-```yaml
-# .lefthook.yml
-pre-commit:
-  parallel: true
-  commands:
-    prettier:
-      glob: "*.{ts,html,scss,json,md}"
-      run: npx prettier --check {staged_files}
-    eslint:
-      glob: "*.ts"
-      run: npx eslint {staged_files}
-    stylelint:
-      glob: "*.scss"
-      run: npx stylelint {staged_files}
-```
+Key rules enforced (do NOT weaken):
+- `prefer-arrow-functions/prefer-arrow-functions` — const arrow over function declarations
+- `max-classes-per-file: 1`, `max-depth: 4`
+- `@typescript-eslint/explicit-member-accessibility` — explicit public/private/protected
+- `@typescript-eslint/prefer-readonly` — readonly where possible
+- `@typescript-eslint/no-non-null-assertion`, `no-explicit-any`, `consistent-type-imports`, `strict-boolean-expressions`
+- `no-warning-comments: ['eslint-disable']` — no eslint-disable comments
+- `@nx/enforce-module-boundaries` — onion architecture layer constraints
+- `eslint-config-prettier` installed to disable conflicting rules. Do NOT use `eslint-plugin-prettier`.
 
 **Enforcement:**
 - All three tools run in CI pipeline (fail on violations)

package/dist/template/.claude/templates/eslint.config.js

@@ -0,0 +1,108 @@
+// eslint.config.js — root (framework-agnostic base)
+// Framework-specific rules (Angular, React, Vue, Svelte) are in .claude/profiles/frontend.md
+import js from '@eslint/js';
+import tseslint from 'typescript-eslint';
+import nx from '@nx/eslint-plugin';
+import simpleImportSort from 'eslint-plugin-simple-import-sort';
+import preferArrowFunctions from 'eslint-plugin-prefer-arrow-functions';
+
+export default [
+  { ignores: ['**/dist', '**/node_modules', '**/.nx'] },
+
+  // TypeScript files
+  {
+    files: ['**/*.ts'],
+    extends: [
+      js.configs.recommended,
+      ...tseslint.configs.strictTypeChecked,
+      ...nx.configs['flat/base'],
+      ...nx.configs['flat/typescript'],
+    ],
+    languageOptions: {
+      parserOptions: { projectService: true },
+    },
+    plugins: {
+      'simple-import-sort': simpleImportSort,
+      'prefer-arrow-functions': preferArrowFunctions,
+    },
+    rules: {
+      // Modern JS syntax (STRICT)
+      'prefer-const': 'error',
+      'no-var': 'error',
+      'prefer-arrow-callback': 'error',
+      'prefer-template': 'error',
+      'object-shorthand': 'error',
+      'prefer-destructuring': ['error', { object: true, array: false }],
+      'prefer-arrow-functions/prefer-arrow-functions': ['error', {
+        returnStyle: 'implicit',
+      }],
+      'max-classes-per-file': ['error', 1],
+      'max-depth': ['error', 4],
+      'no-restricted-syntax': [
+        'error',
+        {
+          selector: 'CallExpression[callee.property.name="forEach"]',
+          message: 'Use for...of instead of .forEach()',
+        },
+        {
+          selector: 'TSAsExpression > TSUnknownKeyword',
+          message: 'Do not use `as unknown as T` double-casting. Fix types or use type guards.',
+        },
+      ],
+
+      // TypeScript strict
+      '@typescript-eslint/no-non-null-assertion': 'error',
+      '@typescript-eslint/consistent-type-assertions': ['error', {
+        assertionStyle: 'as',
+        objectLiteralTypeAssertions: 'never',
+      }],
+      '@typescript-eslint/no-explicit-any': 'error',
+      '@typescript-eslint/no-unused-vars': ['error', { argsIgnorePattern: '^_' }],
+      '@typescript-eslint/consistent-type-imports': ['error', { prefer: 'type-imports' }],
+      '@typescript-eslint/explicit-function-return-type': ['error', {
+        allowExpressions: true,
+        allowTypedFunctionExpressions: true,
+      }],
+      '@typescript-eslint/explicit-member-accessibility': ['error', {
+        accessibility: 'explicit',
+        overrides: { constructors: 'no-public' },
+      }],
+      '@typescript-eslint/prefer-readonly': 'error',
+      '@typescript-eslint/no-floating-promises': 'error',
+      '@typescript-eslint/no-misused-promises': 'error',
+      '@typescript-eslint/prefer-for-of': 'error',
+      '@typescript-eslint/prefer-nullish-coalescing': 'error',
+      '@typescript-eslint/prefer-optional-chain': 'error',
+      '@typescript-eslint/strict-boolean-expressions': 'error',
+
+      // No eslint-disable comments — fix code, don't suppress rules
+      'no-warning-comments': ['error', { terms: ['eslint-disable'] }],
+
+      // Import sorting
+      'simple-import-sort/imports': 'error',
+      'simple-import-sort/exports': 'error',
+
+      // Nx module boundaries
+      '@nx/enforce-module-boundaries': ['error', {
+        enforceBuildableLibDependencies: true,
+        allow: [],
+        depConstraints: [
+          { sourceTag: 'type:domain', onlyDependOnLibsWithTags: ['type:domain'] },
+          { sourceTag: 'type:business', onlyDependOnLibsWithTags: ['type:domain', 'type:business', 'type:shared'] },
+          { sourceTag: 'type:infrastructure', onlyDependOnLibsWithTags: ['type:domain', 'type:shared'] },
+          { sourceTag: 'type:data-access', onlyDependOnLibsWithTags: ['type:domain', 'type:shared'] },
+          { sourceTag: 'type:ui', onlyDependOnLibsWithTags: ['type:domain', 'type:ui', 'type:shared'] },
+          { sourceTag: 'type:feature', onlyDependOnLibsWithTags: ['type:ui', 'type:data-access', 'type:domain', 'type:shared'] },
+          { sourceTag: 'type:api', onlyDependOnLibsWithTags: ['type:business', 'type:domain', 'type:shared'] },
+          { sourceTag: 'type:app', onlyDependOnLibsWithTags: ['type:feature', 'type:ui', 'type:shared'] },
+        ],
+      }],
+    },
+  },
+
+  // Framework-specific rules — see .claude/profiles/frontend.md for additional ESLint config
+  // (e.g., Angular template/component rules, React hooks rules, etc.)
+
+  // Disable type-checked rules for plain JS config files (no tsconfig coverage)
+  { files: ['**/*.js', '**/*.mjs'], ...tseslint.configs.disableTypeChecked },
+];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-claude-workspace",
-  "version": "1.1.62",
+  "version": "1.1.63",
   "description": "Scaffold a project with Claude Code agents for autonomous AI-driven development",
   "type": "module",
   "bin": {