crewly 1.3.30 → 1.4.0

package/config/skills/agent/core/handoff-task/execute.sh

@@ -0,0 +1,150 @@
+#!/bin/bash
+# =============================================================================
+# Multi-Agent Task Handoff (F12)
+#
+# Transfers an in-progress task from the current agent (Agent A) to another
+# agent (Agent B). Unlike delegate-task which assigns NEW work, handoff
+# transfers ONGOING work with full context (progress, findings, blockers).
+#
+# Flow:
+#   1. Agent A calls handoff-task with target agent + task context
+#   2. Backend creates a handoff record linking original task to new assignee
+#   3. Target agent receives the task with full A→B context
+#   4. Original agent's task is marked as 'handed_off' (not completed)
+#
+# Usage:
+#   execute.sh '{"to":"agent-b-session","taskPath":"/path/to/task.md",
+#     "reason":"Blocked on infra, B has access","progress":"70% done...",
+#     "projectPath":"/path/to/project"}'
+#
+# @see F12: Multi-Agent Task Handoff
+# =============================================================================
+
+set -euo pipefail
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "${SCRIPT_DIR}/../../_common/lib.sh"
+
+INPUT="${1:-}"
+[ -z "$INPUT" ] && error_exit "Usage: execute.sh '{\"to\":\"target-session\",\"taskPath\":\"/path/to/task.md\",\"reason\":\"...\",\"progress\":\"...\"}'"
+
+TO=$(echo "$INPUT" | jq -r '.to // empty')
+TASK_PATH=$(echo "$INPUT" | jq -r '.taskPath // empty')
+REASON=$(echo "$INPUT" | jq -r '.reason // "Task handoff"')
+PROGRESS=$(echo "$INPUT" | jq -r '.progress // empty')
+FINDINGS=$(echo "$INPUT" | jq -r '.findings // empty')
+BLOCKERS=$(echo "$INPUT" | jq -r '.blockers // empty')
+PROJECT_PATH=$(echo "$INPUT" | jq -r '.projectPath // empty')
+FROM_SESSION="${CREWLY_SESSION_NAME:-unknown}"
+
+require_param "to" "$TO"
+require_param "reason" "$REASON"
+
+# Resolve Crewly root
+CREWLY_ROOT="$(cd "${SCRIPT_DIR}/../../../.." && pwd)"
+
+# Build handoff context message
+HANDOFF_MESSAGE="[TASK HANDOFF] from ${FROM_SESSION}
+
+## Reason for Handoff
+${REASON}
+"
+
+if [ -n "$PROGRESS" ]; then
+  HANDOFF_MESSAGE="${HANDOFF_MESSAGE}
+## Current Progress
+${PROGRESS}
+"
+fi
+
+if [ -n "$FINDINGS" ]; then
+  HANDOFF_MESSAGE="${HANDOFF_MESSAGE}
+## Key Findings
+${FINDINGS}
+"
+fi
+
+if [ -n "$BLOCKERS" ]; then
+  HANDOFF_MESSAGE="${HANDOFF_MESSAGE}
+## Blockers / Notes
+${BLOCKERS}
+"
+fi
+
+if [ -n "$TASK_PATH" ]; then
+  HANDOFF_MESSAGE="${HANDOFF_MESSAGE}
+## Task File
+${TASK_PATH}
+"
+  # Read task content if file exists
+  if [ -f "$TASK_PATH" ]; then
+    TASK_CONTENT=$(head -100 "$TASK_PATH" 2>/dev/null || true)
+    HANDOFF_MESSAGE="${HANDOFF_MESSAGE}
+## Original Task Content
+\`\`\`
+${TASK_CONTENT}
+\`\`\`
+"
+  fi
+fi
+
+HANDOFF_MESSAGE="${HANDOFF_MESSAGE}
+---
+When done, report back using: bash ${CREWLY_ROOT}/config/skills/agent/core/report-status/execute.sh '{\"sessionName\":\"${TO}\",\"status\":\"done\",\"summary\":\"<brief summary>\",\"projectPath\":\"${PROJECT_PATH}\"}'"
+
+# Step 1: Deliver handoff message to target agent
+DELIVER_BODY=$(jq -n \
+  --arg message "$HANDOFF_MESSAGE" \
+  '{message: $message, waitForReady: true, waitTimeout: 15000}')
+
+echo "Delivering handoff to ${TO}..." >&2
+deliver_result=$(api_call POST "/terminal/${TO}/deliver" "$DELIVER_BODY" 2>/dev/null) || {
+  # Retry with force delivery
+  DELIVER_BODY=$(jq -n \
+    --arg message "$HANDOFF_MESSAGE" \
+    '{message: $message, force: true}')
+  deliver_result=$(api_call POST "/terminal/${TO}/deliver" "$DELIVER_BODY" 2>/dev/null) || deliver_result='{"error":"delivery failed"}'
+}
+
+# Step 2: Update original task status to handed_off (if task path provided)
+if [ -n "$TASK_PATH" ] && [ -f "$TASK_PATH" ]; then
+  # Append handoff metadata to task file
+  cat >> "$TASK_PATH" << HANDOFF_EOF
+
+## Handoff Record
+- **Handed off to**: ${TO}
+- **Handed off from**: ${FROM_SESSION}
+- **Reason**: ${REASON}
+- **Timestamp**: $(date -u +%Y-%m-%dT%H:%M:%SZ)
+HANDOFF_EOF
+fi
+
+# Step 3: Create handoff tracking via task management API
+HANDOFF_BODY=$(jq -n \
+  --arg from "$FROM_SESSION" \
+  --arg to "$TO" \
+  --arg taskPath "${TASK_PATH:-}" \
+  --arg reason "$REASON" \
+  --arg progress "${PROGRESS:-}" \
+  --arg projectPath "${PROJECT_PATH:-}" \
+  '{from: $from, to: $to, taskPath: $taskPath, reason: $reason, progress: $progress, projectPath: $projectPath}')
+
+# Try to record the handoff (non-fatal if endpoint doesn't exist yet)
+handoff_result=$(api_call POST "/task-management/handoff" "$HANDOFF_BODY" 2>/dev/null) || handoff_result='{"tracked":false}'
+
+cat <<EOF
+{
+  "success": true,
+  "handoff": {
+    "from": "${FROM_SESSION}",
+    "to": "${TO}",
+    "reason": "${REASON}",
+    "taskPath": "${TASK_PATH:-null}",
+    "timestamp": "$(date -u +%Y-%m-%dT%H:%M:%SZ)"
+  },
+  "delivery": ${deliver_result},
+  "tracking": ${handoff_result}
+}
+EOF
+
+# Auto-persist handoff as project knowledge
+auto_remember "$FROM_SESSION" "Task handoff from ${FROM_SESSION} to ${TO}: ${REASON}" "fact" "project" "$PROJECT_PATH"

package/config/skills/agent/core/heartbeat/{instructions.md → SKILL.md}

@@ -1,3 +1,30 @@
+---
+name: Heartbeat
+description: Perform a lightweight health check to confirm the agent is responsive. Updates the heartbeat timestamp via the API middleware.
+version: 1.0.0
+category: monitoring
+skillType: claude-skill
+assignableRoles:
+  - developer
+  - qa
+  - devops
+  - pm
+  - tpm
+triggers:
+  - heartbeat
+  - health check
+tags:
+  - monitoring
+  - heartbeat
+  - health
+execution:
+  type: script
+  script:
+    file: execute.sh
+    interpreter: bash
+    timeoutMs: 15000
+---
+
 # Agent Heartbeat Skill
 
 Perform a lightweight health check to confirm that you are responsive.

package/config/skills/agent/core/marketplace-search/{instructions.md → SKILL.md}

@@ -1,3 +1,44 @@
+---
+name: "Marketplace Search & Install"
+description: Search the Crewly marketplace for skills, roles, and models. Auto-install matching items when the agent lacks a capability.
+version: 1.0.0
+category: automation
+skillType: claude-skill
+assignableRoles:
+  - developer
+  - qa
+  - tpm
+  - designer
+  - frontend-developer
+  - backend-developer
+  - fullstack-dev
+  - qa-engineer
+  - product-manager
+  - architect
+  - generalist
+  - sales
+  - support
+triggers:
+  - search marketplace
+  - find skill
+  - install skill
+  - marketplace search
+  - need capability
+  - missing skill
+tags:
+  - marketplace
+  - skills
+  - install
+  - search
+  - auto-discover
+execution:
+  type: script
+  script:
+    file: execute.sh
+    interpreter: bash
+    timeoutMs: 30000
+---
+
 # Marketplace Search & Install
 
 Search the Crewly marketplace for skills, roles, and models. When you lack a capability needed for a task, use this skill to auto-discover and install it from the marketplace.

package/config/skills/agent/core/query-knowledge/{instructions.md → SKILL.md}

@@ -1,3 +1,43 @@
+---
+name: Query Knowledge
+description: Search the company knowledge base for SOPs, runbooks, architecture docs, and other documentation.
+version: 1.0.0
+category: memory
+skillType: claude-skill
+assignableRoles:
+  - developer
+  - qa
+  - tpm
+  - designer
+  - frontend-developer
+  - backend-developer
+  - fullstack-dev
+  - qa-engineer
+  - product-manager
+  - architect
+  - generalist
+  - sales
+  - support
+triggers:
+  - query knowledge
+  - search knowledge
+  - find docs
+  - search docs
+  - find runbook
+  - find SOP
+tags:
+  - memory
+  - knowledge
+  - search
+  - documentation
+execution:
+  type: script
+  script:
+    file: execute.sh
+    interpreter: bash
+    timeoutMs: 15000
+---
+
 # Query Knowledge
 
 Search the company knowledge base for relevant documents. Use this to find SOPs, runbooks, architecture docs, team norms, and other documentation before starting process-oriented tasks.

package/config/skills/agent/core/read-task/SKILL.md

@@ -0,0 +1,56 @@
+---
+name: Read Task
+description: Read the full details of a task file by its absolute path.
+version: 1.0.0
+category: task-management
+skillType: claude-skill
+assignableRoles:
+  - developer
+  - qa
+  - tpm
+  - designer
+  - frontend-developer
+  - backend-developer
+  - fullstack-dev
+  - qa-engineer
+  - product-manager
+  - architect
+  - generalist
+  - sales
+  - support
+triggers:
+  - read task
+  - view task
+  - show task
+  - task details
+tags:
+  - task
+  - read
+  - details
+execution:
+  type: script
+  script:
+    file: execute.sh
+    interpreter: bash
+    timeoutMs: 15000
+---
+
+# Read Task
+
+Read the full details of a task file by its absolute path. Returns the task content, metadata, status, and any subtasks.
+
+## Parameters
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `absoluteTaskPath` | Yes | Absolute filesystem path to the task file |
+
+## Example
+
+```bash
+bash config/skills/agent/read-task/execute.sh '{"absoluteTaskPath":"/projects/app/tasks/implement-login.md"}'
+```
+
+## Output
+
+JSON with full task details including description, acceptance criteria, priority, status, and related files.

package/config/skills/agent/core/recall/{instructions.md → SKILL.md}

@@ -1,3 +1,41 @@
+---
+name: Recall
+description: Retrieve stored memories relevant to a given context or query.
+version: 1.0.0
+category: memory
+skillType: claude-skill
+assignableRoles:
+  - developer
+  - qa
+  - tpm
+  - designer
+  - frontend-developer
+  - backend-developer
+  - fullstack-dev
+  - qa-engineer
+  - product-manager
+  - architect
+  - generalist
+  - sales
+  - support
+triggers:
+  - recall
+  - search memory
+  - remember what
+  - look up
+tags:
+  - memory
+  - recall
+  - search
+  - context
+execution:
+  type: script
+  script:
+    file: execute.sh
+    interpreter: bash
+    timeoutMs: 15000
+---
+
 # Recall
 
 Retrieve stored memories relevant to a given context or query. Use this to look up past decisions, architectural patterns, or findings before starting related work.

package/config/skills/agent/core/record-learning/{instructions.md → SKILL.md}

@@ -1,3 +1,41 @@
+---
+name: Record Learning
+description: Record a learning or insight gained during task execution for team knowledge sharing.
+version: 1.0.0
+category: memory
+skillType: claude-skill
+assignableRoles:
+  - developer
+  - qa
+  - tpm
+  - designer
+  - frontend-developer
+  - backend-developer
+  - fullstack-dev
+  - qa-engineer
+  - product-manager
+  - architect
+  - generalist
+  - sales
+  - support
+triggers:
+  - record learning
+  - learned that
+  - new insight
+  - knowledge share
+tags:
+  - memory
+  - learning
+  - knowledge
+  - insight
+execution:
+  type: script
+  script:
+    file: execute.sh
+    interpreter: bash
+    timeoutMs: 15000
+---
+
 # Record Learning
 
 Record a learning or insight gained during task execution. These learnings are shared with the team and accumulated over time to improve future work.

package/config/skills/agent/core/register-self/SKILL.md

@@ -0,0 +1,54 @@
+---
+name: Register Self
+description: Register the agent as active with the Crewly backend. Must be called on startup.
+version: 1.0.0
+category: system
+skillType: claude-skill
+assignableRoles:
+  - developer
+  - qa
+  - tpm
+  - designer
+  - frontend-developer
+  - backend-developer
+  - fullstack-dev
+  - qa-engineer
+  - product-manager
+  - architect
+  - generalist
+  - sales
+  - support
+triggers:
+  - register
+  - check in
+  - go online
+tags:
+  - system
+  - registration
+  - startup
+execution:
+  type: script
+  script:
+    file: execute.sh
+    interpreter: bash
+    timeoutMs: 15000
+---
+
+# Register Self
+
+Register this agent as active with the Crewly backend. This must be the first skill you run on startup.
+
+## Parameters
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `role` | Yes | Agent role (e.g., "developer", "qa", "tpm") |
+| `sessionName` | Yes | Your session name (from your identity) |
+| `teamMemberId` | No | Your team member ID |
+| `claudeSessionId` | No | Claude session ID for resume support |
+
+## Example
+
+```bash
+bash config/skills/agent/core/register-self/execute.sh '{"role":"developer","sessionName":"dev-1"}'
+```

package/config/skills/agent/core/remember/{instructions.md → SKILL.md}

@@ -1,3 +1,40 @@
+---
+name: Remember
+description: Store a memory entry for future recall. Use this to persist important context, decisions, or findings.
+version: 1.0.0
+category: memory
+skillType: claude-skill
+assignableRoles:
+  - developer
+  - qa
+  - tpm
+  - designer
+  - frontend-developer
+  - backend-developer
+  - fullstack-dev
+  - qa-engineer
+  - product-manager
+  - architect
+  - generalist
+  - sales
+  - support
+triggers:
+  - remember
+  - save memory
+  - store context
+  - note this
+tags:
+  - memory
+  - persistence
+  - context
+execution:
+  type: script
+  script:
+    file: execute.sh
+    interpreter: bash
+    timeoutMs: 15000
+---
+
 # Remember
 
 Store a memory entry for future recall. Use this to persist important context, decisions, architectural findings, or patterns you discover during work.

package/config/skills/agent/core/remember/execute.sh

@@ -16,6 +16,12 @@ require_param "content" "$CONTENT"
 require_param "category" "$CATEGORY"
 require_param "scope" "$SCOPE"
 
+# #187: Auto-inject projectPath from CREWLY_PROJECT_PATH env var when not provided
+PROJECT_PATH=$(echo "$INPUT" | jq -r '.projectPath // empty')
+if [ -z "$PROJECT_PATH" ] && [ -n "${CREWLY_PROJECT_PATH:-}" ]; then
+  INPUT=$(echo "$INPUT" | jq --arg pp "$CREWLY_PROJECT_PATH" '. + {projectPath: $pp}')
+fi
+
 # Build body with required and optional fields
 BODY=$(echo "$INPUT" | jq '{
   agentId: .agentId,

package/config/skills/agent/core/reply-chat/{instructions.md → SKILL.md}

@@ -1,3 +1,40 @@
+---
+name: Reply Chat
+description: Send a message to the Crewly Chat UI. Use this to post responses, updates, or notifications directly to a chat conversation.
+version: 1.0.0
+category: communication
+skillType: claude-skill
+assignableRoles:
+  - developer
+  - qa
+  - tpm
+  - designer
+  - frontend-developer
+  - backend-developer
+  - fullstack-dev
+  - qa-engineer
+  - product-manager
+  - architect
+  - generalist
+  - sales
+  - support
+triggers:
+  - reply chat
+  - send chat
+  - chat message
+  - chat response
+tags:
+  - communication
+  - chat
+  - notification
+execution:
+  type: script
+  script:
+    file: execute.sh
+    interpreter: bash
+    timeoutMs: 15000
+---
+
 # Reply Chat Skill
 
 Send a message to the Crewly Chat UI. This is the preferred way for agents to post messages to the Chat UI.

package/config/skills/agent/core/report-progress/{instructions.md → SKILL.md}

@@ -1,3 +1,41 @@
+---
+name: Report Progress
+description: Report progress on the current task with percentage, completed items, and next steps.
+version: 1.0.0
+category: task-management
+skillType: claude-skill
+assignableRoles:
+  - developer
+  - qa
+  - tpm
+  - designer
+  - frontend-developer
+  - backend-developer
+  - fullstack-dev
+  - qa-engineer
+  - product-manager
+  - architect
+  - generalist
+  - sales
+  - support
+triggers:
+  - report progress
+  - status update
+  - progress update
+  - sync status
+tags:
+  - task
+  - progress
+  - status
+  - sync
+execution:
+  type: script
+  script:
+    file: execute.sh
+    interpreter: bash
+    timeoutMs: 15000
+---
+
 # Report Progress
 
 Report progress on your current task. Includes a completion percentage, what you are currently working on, completed items, and next steps.

package/config/skills/agent/core/report-status/{instructions.md → SKILL.md}

@@ -1,3 +1,42 @@
+---
+name: Report Status
+description: Proactively notify the orchestrator when a task is done, blocked, or failed.
+version: 1.0.0
+category: task-management
+skillType: claude-skill
+assignableRoles:
+  - developer
+  - qa
+  - tpm
+  - designer
+  - frontend-developer
+  - backend-developer
+  - fullstack-dev
+  - qa-engineer
+  - product-manager
+  - architect
+  - generalist
+  - sales
+  - support
+triggers:
+  - report status
+  - notify orchestrator
+  - task done
+  - task blocked
+  - task failed
+tags:
+  - task
+  - status
+  - notification
+  - orchestrator
+execution:
+  type: script
+  script:
+    file: execute.sh
+    interpreter: bash
+    timeoutMs: 15000
+---
+
 # Report Status
 
 Proactively notify the orchestrator when a task is done, blocked, or failed. Use this skill to keep the orchestrator informed without waiting for a scheduled check-in.

package/config/skills/agent/core/send-chat-response/{instructions.md → SKILL.md}

@@ -1,3 +1,40 @@
+---
+name: Send Chat Response
+description: Send a chat response visible in the Crewly chat UI.
+version: 1.0.0
+category: communication
+skillType: claude-skill
+assignableRoles:
+  - developer
+  - qa
+  - tpm
+  - designer
+  - frontend-developer
+  - backend-developer
+  - fullstack-dev
+  - qa-engineer
+  - product-manager
+  - architect
+  - generalist
+  - sales
+  - support
+triggers:
+  - send chat
+  - reply chat
+  - chat response
+  - respond to user
+tags:
+  - chat
+  - communication
+  - response
+execution:
+  type: script
+  script:
+    file: execute.sh
+    interpreter: bash
+    timeoutMs: 15000
+---
+
 # Send Chat Response
 
 Send a chat response that appears in the Crewly chat UI. Use this to communicate results, status updates, or answers directly to the user.