tlc-claude-code 1.2.12 → 1.2.14

package/claim.md

@@ -10,6 +10,22 @@ Reserve a task so teammates know you're working on it.
 
 ## Process
 
+### Step 0: Check Team Mode
+
+Verify team coordination is enabled:
+
+```bash
+teamEnabled=$(jq -r '.team.enabled // false' .tlc.json 2>/dev/null)
+
+if [ "$teamEnabled" != "true" ]; then
+  echo "Team coordination not enabled."
+  echo ""
+  echo "Enable it with: /tlc:deploy setup"
+  echo "Or add to .tlc.json: { \"team\": { \"enabled\": true } }"
+  exit 1
+fi
+```
+
 ### Step 1: Identify User
 
 Get current user identity:

package/deploy.md

@@ -88,11 +88,120 @@ Config saved to .tlc.json
 
 ### Process
 
-1. **Read project info** from `.tlc.json` or `package.json`
+1. **Detect project state**:
+   - New project? Use info from `/tlc:new-project` or `/tlc:init`
+   - Existing TLC project? Read from `.tlc.json`
+   - Legacy project? Read from `package.json` + git remote
 2. **Ask for domain** if not configured
 3. **Generate webhook secret** (random 16 chars)
 4. **Output setup command** with all config embedded
-5. **Save config** to `.tlc.json`
+5. **Save/update config** in `.tlc.json`
+
+### Upgrading Existing Projects
+
+For projects already using TLC but without team features:
+
+```
+> /tlc:deploy setup
+
+TLC Dev Server Setup
+════════════════════════════════════════════════════════════════════
+
+Detected existing TLC project: my-awesome-app
+  ✓ .tlc.json found
+  ✓ .planning/ directory exists
+  ✗ No deploy config yet
+
+Adding team collaboration features...
+
+Project: my-awesome-app
+Repo:    git@github.com:myorg/my-awesome-app.git
+
+Enter your server domain: _
+```
+
+The setup continues with the same flow - generates config, shows server command, DNS instructions, webhook config.
+
+### Enable Team Coordination
+
+After domain setup, ask about team coordination model:
+
+```
+───────────────────────────────────────────────────────────────
+Team Coordination
+───────────────────────────────────────────────────────────────
+
+Enable task claiming and multi-user coordination?
+
+This adds:
+  • Task markers: [ ], [>@alice], [x@bob]
+  • /tlc:claim - reserve a task before working
+  • /tlc:release - release a task if blocked
+  • /tlc:who - see who's working on what
+  • Git-based sync (push/pull shares claims)
+
+Enable team coordination? [Y/n]: _
+```
+
+**If Yes:**
+
+1. Add team config to `.tlc.json`
+2. Migrate existing PLAN.md files to add `[ ]` markers
+3. Show coordination workflow
+
+```
+✓ Team coordination enabled
+
+Existing plans updated:
+  .planning/phases/1-PLAN.md - 3 tasks marked as available
+  .planning/phases/2-PLAN.md - 4 tasks marked as available
+
+Team Workflow:
+───────────────────────────────────────────────────────────────
+  1. git pull                  ← Get latest claims
+  2. /tlc:claim               ← Reserve your task
+  3. git push                  ← Share your claim
+  4. ... work on task ...
+  5. git commit & push         ← Task auto-marked complete
+───────────────────────────────────────────────────────────────
+```
+
+### Plan Migration
+
+Existing task headings are updated:
+
+**Before:**
+```markdown
+### Task 1: Create user schema
+### Task 2: Add validation
+```
+
+**After:**
+```markdown
+### Task 1: Create user schema [ ]
+### Task 2: Add validation [ ]
+```
+
+This makes tasks claimable without changing any other content.
+
+**What gets added to .tlc.json:**
+
+```json
+{
+  "project": "my-awesome-app",
+  "testFrameworks": { ... },    // existing config preserved
+  "team": {                     // NEW: team coordination
+    "enabled": true,
+    "model": "git-based"
+  },
+  "deploy": {                   // NEW: dev server
+    "domain": "myapp.example.com",
+    "webhookSecret": "x7k9m2p4q8r1s5t3",
+    "dashboardUrl": "https://dashboard.myapp.example.com",
+    "configured": false
+  }
+}
+```
 
 ```javascript
 // Config generation

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tlc-claude-code",
-  "version": "1.2.12",
+  "version": "1.2.14",
   "description": "TLC - Test Led Coding for Claude Code",
   "bin": {
     "tlc": "./bin/tlc.js",

package/release.md

@@ -17,6 +17,18 @@ Release a task you claimed so others can work on it.
 
 ## Process
 
+### Step 0: Check Team Mode
+
+```bash
+teamEnabled=$(jq -r '.team.enabled // false' .tlc.json 2>/dev/null)
+
+if [ "$teamEnabled" != "true" ]; then
+  echo "Team coordination not enabled."
+  echo "Enable it with: /tlc:deploy setup"
+  exit 1
+fi
+```
+
 ### Step 1: Identify User
 
 Get current user identity (same as `/tlc:claim`):

package/tlc.md

@@ -64,6 +64,23 @@ fi
 echo "✓ Synced"
 ```
 
+### Step 0b: Check for Team Features (Existing Projects)
+
+For projects that existed before team features, check if dev server is configured:
+
+```bash
+# Check if deploy config exists
+deployDomain=$(jq -r '.deploy.domain // ""' .tlc.json)
+
+if [ -z "$deployDomain" ]; then
+  # No deploy config - this is an existing project without team setup
+  # Show subtle hint in header (not blocking)
+  teamHint="│ 💡 Team sharing available: /tlc:deploy setup"
+fi
+```
+
+This adds a non-blocking hint. Users can also access it via Quick Actions [5].
+
 ### Step 1: Show Phase Checklist (ALWAYS SHOW THIS)
 
 **This is the core of `/tlc` - always show the current phase status:**
@@ -102,8 +119,9 @@ Phase 2: User Dashboard
   [2] Go back and fix skipped steps
   [3] Show all commands (/tlc:help)
   [4] Full project checklist (/tlc:checklist)
+  [5] Enable team collaboration (/tlc:deploy setup)
 
-Choice [1/2/3/4]: _
+Choice [1/2/3/4/5]: _
 ```
 
 ### Step 2: Detect Current Phase

package/who.md

@@ -10,6 +10,18 @@ See who's working on what in the current phase.
 
 ## Process
 
+### Step 0: Check Team Mode
+
+```bash
+teamEnabled=$(jq -r '.team.enabled // false' .tlc.json 2>/dev/null)
+
+if [ "$teamEnabled" != "true" ]; then
+  echo "Team coordination not enabled."
+  echo "Enable it with: /tlc:deploy setup"
+  exit 1
+fi
+```
+
 ### Step 1: Find Current Phase
 
 1. Read `.planning/ROADMAP.md`