tlc-claude-code 1.2.13 → 1.2.15

package/README.md

@@ -371,6 +371,7 @@ helm install tlc tlc/tlc-server \
 
 ## Documentation
 
+- **[Getting Started Guide](docs/getting-started-guide.md)** — New to coding? Start here!
 - **[Help / All Commands](help.md)** — Complete command reference
 - **[Team Workflow](docs/team-workflow.md)** — Guide for teams (engineers + PO + QA)
 - **[Dev Server](docs/devserver.md)** — Deploy on Ubuntu server

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

@@ -122,13 +122,79 @@ 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
-  "deploy": {                   // NEW: added by setup
+  "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",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tlc-claude-code",
-  "version": "1.2.13",
+  "version": "1.2.15",
   "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,7 +64,64 @@ fi
 echo "✓ Synced"
 ```
 
-### Step 0b: Check for Team Features (Existing Projects)
+### Step 0b: Check Team Identity (First Time on Team Project)
+
+When joining a team project (team.enabled = true), check if user is identified:
+
+```bash
+# Check if team mode is enabled
+teamEnabled=$(jq -r '.team.enabled // false' .tlc.json)
+
+if [ "$teamEnabled" = "true" ]; then
+  # Check for user identity
+  if [ -z "$TLC_USER" ]; then
+    # No TLC_USER set, prompt for identity
+    gitUser=$(git config user.name)
+
+    echo "═══════════════════════════════════════════════════════════════"
+    echo "Team Project Detected"
+    echo "═══════════════════════════════════════════════════════════════"
+    echo ""
+    echo "This project uses team coordination."
+    echo "Please identify yourself for task claiming."
+    echo ""
+    echo "Your git name: $gitUser"
+    echo ""
+    echo "Use this name? [Y/n/other]: _"
+
+    # If Y → Set TLC_USER=$gitUser (normalized)
+    # If n → Ask for name
+    # Save to shell profile: export TLC_USER="username"
+  fi
+fi
+```
+
+**On first run, show team onboarding:**
+
+```
+═══════════════════════════════════════════════════════════════
+Welcome to the Team!
+═══════════════════════════════════════════════════════════════
+
+Project: my-awesome-app
+Team coordination: enabled
+
+You'll be identified as: @alice
+
+How it works:
+  1. /tlc:claim    ← Reserve a task before working
+  2. git push      ← Share your claim with team
+  3. Work on task
+  4. git commit    ← Task auto-marked complete
+
+Current team activity:
+  @bob is working on: Task 2 - Add validation
+  @carol completed: Task 1 - Create schema
+
+Press Enter to continue...
+```
+
+### Step 0c: Check for Team Features (Upgrade Hint)
 
 For projects that existed before team features, check if dev server is configured:
 
@@ -72,7 +129,7 @@ For projects that existed before team features, check if dev server is configure
 # Check if deploy config exists
 deployDomain=$(jq -r '.deploy.domain // ""' .tlc.json)
 
-if [ -z "$deployDomain" ]; then
+if [ -z "$deployDomain" ] && [ "$teamEnabled" != "true" ]; 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"
@@ -119,7 +176,7 @@ Phase 2: User Dashboard
   [2] Go back and fix skipped steps
   [3] Show all commands (/tlc:help)
   [4] Full project checklist (/tlc:checklist)
-  [5] Set up team dev server (/tlc:deploy setup)
+  [5] Enable team collaboration (/tlc:deploy setup)
 
 Choice [1/2/3/4/5]: _
 ```

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`