worclaude 1.9.0 → 2.0.0

package/src/core/scaffolder.js

@@ -46,7 +46,13 @@ export async function scaffoldDirectory(templateDir, destDir, variables, project
 
 export async function updateGitignore(projectDir) {
   const gitignorePath = path.join(projectDir, '.gitignore');
-  const entries = ['.claude/sessions/', '.claude/workflow-meta.json', '.claude-backup-*/'];
+  const entries = [
+    '.claude/sessions/',
+    '.claude/settings.local.json',
+    '.claude/workflow-meta.json',
+    '.claude/worktrees/',
+    '.claude-backup-*/',
+  ];
   const header = '# Worclaude (generated workflow files)';
 
   let content = '';

package/src/data/agents.js

@@ -207,6 +207,7 @@ export const UNIVERSAL_SKILLS = [
   'claude-md-maintenance',
   'subagent-usage',
   'security-checklist',
+  'coordinator-mode',
 ];
 
 export const TEMPLATE_SKILLS = [
@@ -314,6 +315,7 @@ export const CONFIRMATION_STEPS = [
   { name: 'Project type', value: 'projectType' },
   { name: 'Tech stack', value: 'techStack' },
   { name: 'Agent selection', value: 'agents' },
+  { name: 'MEMORY.md (optional)', value: 'memoryMd' },
 ];
 
 export const NOTIFICATION_COMMANDS = {

package/src/utils/file.js

@@ -31,6 +31,11 @@ export async function copyFile(src, dest) {
   await fs.copy(src, dest);
 }
 
+export async function moveFile(src, dest) {
+  await fs.ensureDir(path.dirname(dest));
+  await fs.move(src, dest);
+}
+
 export async function listFiles(dirPath) {
   try {
     const entries = await fs.readdir(dirPath, { withFileTypes: true });
@@ -40,6 +45,22 @@ export async function listFiles(dirPath) {
   }
 }
 
+export async function listSkillDirs(dirPath) {
+  try {
+    const entries = await fs.readdir(dirPath, { withFileTypes: true });
+    const dirs = entries.filter((e) => e.isDirectory()).map((e) => e.name);
+    const valid = [];
+    for (const dir of dirs) {
+      if (await fileExists(path.join(dirPath, dir, 'SKILL.md'))) {
+        valid.push(dir);
+      }
+    }
+    return valid;
+  } catch {
+    return [];
+  }
+}
+
 export async function copyDirectory(src, dest) {
   await fs.copy(src, dest);
 }

package/templates/agents/optional/backend/api-designer.md

@@ -1,7 +1,13 @@
 ---
 name: api-designer
+description: "Reviews API design for RESTful conventions"
 model: opus
 isolation: none
+disallowedTools:
+  - Edit
+  - NotebookEdit
+  - Agent
+maxTurns: 30
 ---
 
 You are a senior API architect who reviews API designs for

package/templates/agents/optional/backend/auth-auditor.md

@@ -1,7 +1,9 @@
 ---
 name: auth-auditor
+description: "Audits authentication and authorization"
 model: opus
 isolation: none
+maxTurns: 40
 ---
 
 You are a security-focused engineer specializing in authentication

package/templates/agents/optional/backend/database-analyst.md

@@ -1,7 +1,14 @@
 ---
 name: database-analyst
+description: "Reviews database schemas and queries"
 model: sonnet
 isolation: none
+disallowedTools:
+  - Edit
+  - Write
+  - NotebookEdit
+  - Agent
+maxTurns: 30
 ---
 
 You are a database specialist who reviews schemas, queries, and

package/templates/agents/optional/data/data-pipeline-reviewer.md

@@ -1,7 +1,14 @@
 ---
 name: data-pipeline-reviewer
+description: "Reviews data pipeline correctness"
 model: sonnet
 isolation: none
+disallowedTools:
+  - Edit
+  - Write
+  - NotebookEdit
+  - Agent
+maxTurns: 30
 ---
 
 You are a data engineering specialist who reviews data pipeline code

package/templates/agents/optional/data/ml-experiment-tracker.md

@@ -1,7 +1,14 @@
 ---
 name: ml-experiment-tracker
+description: "Reviews ML experiment reproducibility"
 model: sonnet
 isolation: none
+disallowedTools:
+  - Edit
+  - Write
+  - NotebookEdit
+  - Agent
+maxTurns: 30
 ---
 
 You are an ML engineering specialist who reviews experiment code for

package/templates/agents/optional/data/prompt-engineer.md

@@ -1,7 +1,9 @@
 ---
 name: prompt-engineer
+description: "Reviews and improves LLM prompts"
 model: opus
 isolation: none
+maxTurns: 30
 ---
 
 You are an LLM prompt engineering specialist who reviews and improves

package/templates/agents/optional/devops/ci-fixer.md

@@ -1,7 +1,9 @@
 ---
 name: ci-fixer
+description: "Diagnoses and fixes CI/CD failures"
 model: sonnet
 isolation: worktree
+maxTurns: 40
 ---
 
 You are a CI/CD specialist who diagnoses and fixes pipeline failures.

package/templates/agents/optional/devops/dependency-manager.md

@@ -1,7 +1,14 @@
 ---
 name: dependency-manager
+description: "Reviews dependency health and updates"
 model: haiku
 isolation: none
+disallowedTools:
+  - Edit
+  - Write
+  - NotebookEdit
+  - Agent
+maxTurns: 20
 ---
 
 You are a dependency health analyst. You review the project's

package/templates/agents/optional/devops/deploy-validator.md

@@ -1,7 +1,14 @@
 ---
 name: deploy-validator
+description: "Validates deployment readiness"
 model: sonnet
 isolation: none
+disallowedTools:
+  - Edit
+  - Write
+  - NotebookEdit
+  - Agent
+maxTurns: 20
 ---
 
 You are a deployment readiness specialist who validates that an

package/templates/agents/optional/devops/docker-helper.md

@@ -1,7 +1,9 @@
 ---
 name: docker-helper
+description: "Reviews Docker configs for best practices"
 model: sonnet
 isolation: none
+maxTurns: 30
 ---
 
 You are a Docker and containerization specialist who reviews

package/templates/agents/optional/docs/changelog-generator.md

@@ -1,7 +1,14 @@
 ---
 name: changelog-generator
+description: "Generates changelog from commits"
 model: haiku
 isolation: none
+disallowedTools:
+  - Edit
+  - NotebookEdit
+  - Agent
+maxTurns: 15
+omitClaudeMd: true
 ---
 
 You are a changelog generator that creates clear, well-organized

package/templates/agents/optional/docs/doc-writer.md

@@ -1,7 +1,10 @@
 ---
 name: doc-writer
+description: "Writes and updates documentation"
 model: sonnet
 isolation: worktree
+maxTurns: 40
+memory: project
 ---
 
 You are a technical writer who creates and maintains project

package/templates/agents/optional/frontend/style-enforcer.md

@@ -1,7 +1,9 @@
 ---
 name: style-enforcer
+description: "Ensures design system compliance"
 model: haiku
 isolation: none
+maxTurns: 30
 ---
 
 You are a design system compliance checker. Your job is to scan the

package/templates/agents/optional/frontend/ui-reviewer.md

@@ -1,7 +1,14 @@
 ---
 name: ui-reviewer
+description: "Reviews UI for consistency and accessibility"
 model: sonnet
 isolation: none
+disallowedTools:
+  - Edit
+  - Write
+  - NotebookEdit
+  - Agent
+maxTurns: 30
 ---
 
 You are a senior UI/UX engineer who reviews frontend components for

package/templates/agents/optional/quality/bug-fixer.md

@@ -1,7 +1,9 @@
 ---
 name: bug-fixer
+description: "Diagnoses and fixes bugs"
 model: sonnet
 isolation: worktree
+maxTurns: 50
 ---
 
 You are a senior developer who specializes in diagnosing and fixing

package/templates/agents/optional/quality/build-fixer.md

@@ -1,7 +1,9 @@
 ---
 name: build-fixer
+description: "Diagnoses and fixes build failures"
 model: sonnet
 isolation: worktree
+maxTurns: 40
 ---
 
 You are a build error specialist. When the build is broken — tests

package/templates/agents/optional/quality/e2e-runner.md

@@ -1,7 +1,10 @@
 ---
 name: e2e-runner
+description: "Writes and runs end-to-end tests"
 model: sonnet
 isolation: worktree
+background: true
+maxTurns: 50
 ---
 
 You are an end-to-end testing specialist. You write and run tests

package/templates/agents/optional/quality/performance-auditor.md

@@ -1,7 +1,15 @@
 ---
 name: performance-auditor
+description: "Analyzes code for performance issues"
 model: sonnet
 isolation: none
+disallowedTools:
+  - Edit
+  - Write
+  - NotebookEdit
+  - Agent
+maxTurns: 30
+omitClaudeMd: true
 ---
 
 You are a performance engineer who reviews code for efficiency

package/templates/agents/optional/quality/refactorer.md

@@ -1,7 +1,9 @@
 ---
 name: refactorer
+description: "Refactors code to improve maintainability"
 model: sonnet
 isolation: worktree
+maxTurns: 50
 ---
 
 You are a refactoring specialist. You improve code structure and

package/templates/agents/optional/quality/security-reviewer.md

@@ -1,7 +1,16 @@
 ---
 name: security-reviewer
+description: "Reviews code for security vulnerabilities"
 model: opus
 isolation: none
+disallowedTools:
+  - Edit
+  - Write
+  - NotebookEdit
+  - Agent
+maxTurns: 40
+omitClaudeMd: true
+memory: project
 ---
 
 You are a senior application security engineer performing a code

package/templates/agents/universal/build-validator.md

@@ -1,7 +1,10 @@
 ---
 name: build-validator
+description: "Validates that the project builds and all tests pass"
 model: haiku
 isolation: none
+background: true
+maxTurns: 20
 ---
 
 You are a build validation specialist. You run all project checks

package/templates/agents/universal/code-simplifier.md

@@ -1,7 +1,9 @@
 ---
 name: code-simplifier
+description: "Reviews changed code and simplifies overly complex implementations"
 model: sonnet
 isolation: worktree
+maxTurns: 50
 ---
 
 You are a code quality specialist. You review recently changed code and

package/templates/agents/universal/plan-reviewer.md

@@ -1,7 +1,15 @@
 ---
 name: plan-reviewer
+description: "Reviews implementation plans for specificity, gaps, and executability"
 model: opus
 isolation: none
+disallowedTools:
+  - Edit
+  - Write
+  - NotebookEdit
+  - Agent
+maxTurns: 30
+omitClaudeMd: true
 ---
 
 You are a senior staff engineer reviewing an implementation plan.

package/templates/agents/universal/test-writer.md

@@ -1,7 +1,10 @@
 ---
 name: test-writer
+description: "Writes comprehensive, meaningful tests for recently changed code"
 model: sonnet
 isolation: worktree
+maxTurns: 50
+memory: project
 ---
 
 You are a test specialist. You write comprehensive, meaningful tests
@@ -65,7 +68,7 @@ Test names should read as specifications:
 1. Run `git diff --name-only HEAD~3` to identify changed files
 2. Read each changed file to understand what it does
 3. Check for existing tests — extend them, don't duplicate
-4. Read .claude/skills/testing.md for project-specific test patterns
+4. Read .claude/skills/testing/SKILL.md for project-specific test patterns
 5. Write tests grouped by function/component
 6. Run all tests to verify they pass
 7. Check coverage on the changed files specifically

package/templates/agents/universal/verify-app.md

@@ -1,7 +1,10 @@
 ---
 name: verify-app
+description: "Verifies the running application end-to-end — tests actual behavior, not just code reading"
 model: sonnet
 isolation: worktree
+background: true
+maxTurns: 50
 ---
 
 You are a verification specialist. You test the actual running
@@ -72,3 +75,44 @@ For each verification, report:
 - Include the exact commands you ran so findings can be reproduced
 - If the application won't start, that's a FAILED verdict — report the startup error
 - Verify against the spec, not against what you think it should do
+
+## Output Format (REQUIRED)
+
+Every check MUST follow this structure:
+
+### Check: [what you're verifying]
+
+**Command run:** [exact command executed]
+**Output observed:** [actual terminal output — copy-paste, not paraphrased]
+**Result: PASS** (or **FAIL** with Expected vs Actual)
+
+End with exactly one of:
+
+- VERDICT: PASS
+- VERDICT: FAIL
+- VERDICT: PARTIAL (environmental limitations only — not "I'm unsure")
+
+## Recognize Your Own Rationalizations
+
+You will feel the urge to skip checks. These are the excuses — recognize them:
+
+- "The code looks correct based on my reading" — reading is not verification. Run it.
+- "The tests already pass" — the implementer is an LLM. Verify independently.
+- "This is probably fine" — probably is not verified. Run it.
+- "I don't have a browser" — did you check for available MCP tools?
+- If you catch yourself writing an explanation instead of a command, stop. Run the command.
+
+## Verification by Change Type
+
+- **Frontend**: start dev server → navigate to affected page → check console errors → test responsive
+- **Backend/API**: start server → curl endpoints → verify response shapes → test error handling
+- **CLI**: run with typical args → run with edge cases → verify exit codes → test piping
+- **Config/Infrastructure**: validate syntax → dry-run where possible → check env vars
+- **Bug fixes**: reproduce original bug → verify fix → run regression tests
+- **Refactoring**: existing test suite must pass unchanged → diff public API surface
+
+## Before Issuing PASS
+
+Your report must include at least one adversarial probe (boundary value, concurrent request,
+idempotency check, or orphan operation) and its result. If all your checks are "returns 200"
+or "test suite passes," you have confirmed the happy path, not verified correctness.

package/templates/commands/build-fix.md

@@ -1,3 +1,7 @@
+---
+description: "Fix current build failures via build-fixer agent"
+---
+
 Fix the current build failures. Delegates to the build-fixer agent
 for diagnosis and resolution.
 

package/templates/commands/commit-push-pr.md

@@ -1,6 +1,17 @@
+---
+description: "Commit, push, and create PR — branch-aware with session summary"
+---
+
 Determine which branch you're on, then follow the appropriate flow.
 Do not add Co-Authored-By trailers or AI-generated footers to commits or PR descriptions.
 
+## Worktree Awareness
+
+If you are in a git worktree session:
+- Verify you are on the correct branch: `git branch --show-current`
+- All changes must be committed before creating a PR — `git status --porcelain` should be empty after staging
+- Do NOT attempt to switch branches inside a worktree — each worktree is locked to its branch
+
 ## On a feature branch (feature/*, fix/*, chore/*, refactor/*)
 
 Feature branches contain ONLY the task changes. Do NOT touch shared-state

package/templates/commands/compact-safe.md

@@ -1,3 +1,7 @@
+---
+description: "Compress context via /compact with safety checks"
+---
+
 Run /compact to compress context.
 The PostCompact hook will automatically re-read CLAUDE.md
 and PROGRESS.md.

package/templates/commands/conflict-resolver.md

@@ -1,3 +1,7 @@
+---
+description: "Resolve merge conflicts on develop branch"
+---
+
 You are resolving merge conflicts. ONLY resolve conflicts — do not
 update PROGRESS.md, SPEC.md, or bump versions. That is /sync's job.
 

package/templates/commands/end.md

@@ -1,7 +1,20 @@
+---
+description: "Mid-task stop — writes handoff file and session summary for next session"
+---
+
 Use this ONLY when stopping work mid-task without committing.
 
 Do NOT update PROGRESS.md — /sync handles that on develop after merging.
 
+## Pre-flight: Worktree Safety
+
+If you are working in a git worktree (not the main checkout):
+
+1. Check for uncommitted changes: `git status --porcelain`
+2. If changes exist, commit or stash before proceeding
+3. Note which worktree you are in for the handoff file
+4. Do NOT remove the worktree from /end — the user may resume here
+
 ## Mid-task handoff
 
 1. Create docs/handoffs/HANDOFF-{branch-name}-{date}.md

package/templates/commands/refactor-clean.md

@@ -1,3 +1,7 @@
+---
+description: "Focused cleanup pass on recently changed code"
+---
+
 Run a focused cleanup pass on recently changed code. This command
 runs INLINE in your current session — it reads uncommitted changes,
 improves them in place, and leaves everything uncommitted for

package/templates/commands/review-changes.md

@@ -1,3 +1,7 @@
+---
+description: "Code review — reports findings as prioritized table without modifying files"
+---
+
 Review changed code for reuse, quality, and efficiency.
 
 CRITICAL: This is a READ-ONLY review. You MUST NOT edit any files.

package/templates/commands/review-plan.md

@@ -1,3 +1,7 @@
+---
+description: "Send implementation plan to plan-reviewer agent for staff-level review"
+---
+
 Send the current implementation plan to the plan-reviewer agent.
 The plan-reviewer will act as a staff engineer and critically
 review the plan for:

package/templates/commands/setup.md

@@ -1,3 +1,7 @@
+---
+description: "Project setup interview — fills in CLAUDE.md, skills, and configuration"
+---
+
 You are conducting a project setup interview. Your goal is to gather
 enough information to fill in all project-specific files with real,
 useful content.
@@ -94,15 +98,15 @@ these files with real, project-specific content:
    from the interview answers. Include all features, data models,
    architecture decisions, and implementation phases.
 
-3. **.claude/skills/backend-conventions.md** — Fill with real
+3. **.claude/skills/backend-conventions/SKILL.md** — Fill with real
    backend patterns, framework-specific conventions, database
    patterns specific to this project.
 
-4. **.claude/skills/frontend-design-system.md** — Fill with real
+4. **.claude/skills/frontend-design-system/SKILL.md** — Fill with real
    design system, component patterns, styling approach if
    applicable.
 
-5. **.claude/skills/project-patterns.md** — Fill with real
+5. **.claude/skills/project-patterns/SKILL.md** — Fill with real
    architectural patterns, directory structure explanation,
    module interaction patterns.
 

package/templates/commands/start.md

@@ -1,3 +1,7 @@
+---
+description: "Load session context, check for handoff files, detect drift since last session"
+---
+
 The SessionStart hook has already loaded CLAUDE.md, PROGRESS.md,
 and the most recent session summary into context.
 
@@ -53,7 +57,7 @@ Look in docs/handoffs/ for any HANDOFF*.md files:
 
 ## 3. Load Agent Routing
 
-Read .claude/skills/agent-routing.md for agent usage guidance.
+Read .claude/skills/agent-routing/SKILL.md for agent usage guidance.
 
 ## 4. Check for Active Prompt Files
 

package/templates/commands/status.md

@@ -1,3 +1,7 @@
+---
+description: "Report current session state — branch, recent changes, pending work"
+---
+
 Report current session state:
 - Current task / what you're working on
 - Git branch and recent commits

package/templates/commands/sync.md

@@ -1,3 +1,7 @@
+---
+description: "Update PROGRESS.md, SPEC.md, and version after merging PRs on develop"
+---
+
 Update shared-state files after merging feature PRs into develop.
 Run this on the develop branch AFTER all PRs are merged and any
 conflicts are resolved.

package/templates/commands/techdebt.md

@@ -1,3 +1,7 @@
+---
+description: "Scan codebase for technical debt and report findings"
+---
+
 Scan the codebase for technical debt:
 - Duplicated code
 - Dead code (unused functions, imports, variables)

package/templates/commands/test-coverage.md

@@ -1,3 +1,7 @@
+---
+description: "Analyze test coverage and fill gaps in recently changed code"
+---
+
 Analyze test coverage and fill gaps in the most critical areas.
 Delegates to the test-writer agent for test creation.
 

package/templates/commands/update-claude-md.md

@@ -1,3 +1,7 @@
+---
+description: "Propose updates to CLAUDE.md based on session work and recurring patterns"
+---
+
 Based on this session's work, propose updates to CLAUDE.md:
 
 Review what happened:

package/templates/commands/verify.md

@@ -1,3 +1,7 @@
+---
+description: "Run full project verification — tests, build, lint, type checking"
+---
+
 Run full project verification:
 1. Run the test suite
 2. Run the build