crewly 1.0.0

package/config/runtime_scripts/runtime-config.json

@@ -0,0 +1,26 @@
+{
+  "runtimes": {
+    "claude-code": {
+      "displayName": "Claude Code",
+      "initScript": "initialize_claude.sh",
+      "welcomeMessage": "Welcome to Claude Code",
+      "timeout": 120000,
+      "description": "Anthropic's Claude Code CLI with advanced coding capabilities"
+    },
+    "gemini-cli": {
+      "displayName": "Gemini CLI", 
+      "initScript": "initialize_gemini.sh",
+      "welcomeMessage": "GEMINI.md",
+      "timeout": 90000,
+      "description": "Google's Gemini AI CLI for code generation and analysis"
+    },
+    "codex-cli": {
+      "displayName": "OpenAI Codex",
+      "initScript": "initialize_codex.sh", 
+      "welcomeMessage": "OpenAI Codex",
+      "timeout": 90000,
+      "description": "OpenAI's Codex CLI for advanced code understanding"
+    }
+  },
+  "defaultRuntime": "claude-code"
+}

package/config/skills/_common/lib.sh

@@ -0,0 +1,64 @@
+#!/bin/bash
+# =============================================================================
+# Crewly Shared Skills Common Library
+# Provides common utilities for all bash skills (agent and orchestrator).
+# =============================================================================
+
+# Base URL for the Crewly backend API
+CREWLY_API_URL="${CREWLY_API_URL:-http://localhost:8787}"
+
+# -----------------------------------------------------------------------------
+# api_call METHOD endpoint [json_body]
+#
+# Makes an HTTP request to the Crewly backend API.
+# Outputs the response body on success (stdout).
+# Outputs a JSON error object on failure (stderr) and returns 1.
+# -----------------------------------------------------------------------------
+api_call() {
+  local method="$1" endpoint="$2" body="${3:-}"
+  local url="${CREWLY_API_URL}/api${endpoint}"
+  local args=(-s -w '\n%{http_code}' -X "$method" -H "Content-Type: application/json")
+  # Include agent session identity header for heartbeat tracking
+  [ -n "$TMUX_SESSION_NAME" ] && args+=(-H "X-Agent-Session: $TMUX_SESSION_NAME")
+  [ -n "$body" ] && args+=(-d "$body")
+
+  local response
+  response=$(curl "${args[@]}" "$url")
+  local curl_exit=$?
+
+  if [ $curl_exit -ne 0 ]; then
+    echo '{"error":true,"status":0,"details":"curl failed with exit code '"$curl_exit"'"}' >&2
+    return 1
+  fi
+
+  local http_code
+  http_code=$(echo "$response" | tail -1)
+  local body_content
+  body_content=$(echo "$response" | sed '$d')
+
+  if [ "$http_code" -ge 200 ] 2>/dev/null && [ "$http_code" -lt 300 ] 2>/dev/null; then
+    echo "$body_content"
+  else
+    echo '{"error":true,"status":'"${http_code}"',"details":'"${body_content:-\"Request failed\"}"'}' >&2
+    return 1
+  fi
+}
+
+# -----------------------------------------------------------------------------
+# error_exit message
+# Prints a JSON error to stderr and exits with code 1.
+# -----------------------------------------------------------------------------
+error_exit() {
+  echo '{"error":"'"$1"'"}' >&2
+  exit 1
+}
+
+# -----------------------------------------------------------------------------
+# require_param name value
+# Exits with error if value is empty.
+# -----------------------------------------------------------------------------
+require_param() {
+  if [ -z "$2" ]; then
+    error_exit "Missing required parameter: $1"
+  fi
+}

package/config/skills/agent/_common/lib.sh

@@ -0,0 +1,4 @@
+#!/usr/bin/env bash
+# Agent Skills Common Library - delegates to shared library
+SHARED_LIB_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)/_common"
+source "${SHARED_LIB_DIR}/lib.sh"

package/config/skills/agent/accept-task/execute.sh

@@ -0,0 +1,21 @@
+#!/bin/bash
+# Accept and take the next available task from the task queue
+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 '{\"sessionName\":\"dev-1\"}'"
+
+SESSION_NAME=$(echo "$INPUT" | jq -r '.sessionName // empty')
+require_param "sessionName" "$SESSION_NAME"
+
+TEAM_MEMBER_ID=$(echo "$INPUT" | jq -r '.teamMemberId // empty')
+
+BODY=$(jq -n \
+  --arg sessionName "$SESSION_NAME" \
+  --arg teamMemberId "$TEAM_MEMBER_ID" \
+  '{sessionName: $sessionName} +
+   (if $teamMemberId != "" then {teamMemberId: $teamMemberId} else {} end)')
+
+api_call POST "/task-management/take-next" "$BODY"

package/config/skills/agent/accept-task/instructions.md

@@ -0,0 +1,20 @@
+# Accept Task
+
+Accept and take the next available task from the task queue. The backend assigns the highest-priority unassigned task to your session.
+
+## Parameters
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `sessionName` | Yes | Your agent session name |
+| `teamMemberId` | No | Your team member ID for targeted assignment |
+
+## Example
+
+```bash
+bash config/skills/agent/accept-task/execute.sh '{"sessionName":"dev-1"}'
+```
+
+## Output
+
+JSON with the assigned task details including path, description, and priority. Returns an empty result if no tasks are available.

package/config/skills/agent/accept-task/skill.json

@@ -0,0 +1,20 @@
+{
+  "id": "agent-accept-task",
+  "name": "Accept Task",
+  "description": "Accept and take the next available task from the task queue.",
+  "category": "task-management",
+  "skillType": "claude-skill",
+  "promptFile": "instructions.md",
+  "execution": {
+    "type": "script",
+    "script": {
+      "file": "execute.sh",
+      "interpreter": "bash",
+      "timeoutMs": 15000
+    }
+  },
+  "assignableRoles": ["developer", "qa", "tpm", "designer", "frontend-developer", "backend-developer", "fullstack-dev", "qa-engineer", "product-manager", "architect", "generalist", "sales", "support"],
+  "triggers": ["accept task", "take task", "get next task", "pick up task"],
+  "tags": ["task", "queue", "assignment"],
+  "version": "1.0.0"
+}

package/config/skills/agent/block-task/execute.sh

@@ -0,0 +1,26 @@
+#!/bin/bash
+# Mark a task as blocked with a reason and optional questions
+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 '{\"absoluteTaskPath\":\"/path/to/task\",\"reason\":\"Missing API credentials\"}'"
+
+ABSOLUTE_TASK_PATH=$(echo "$INPUT" | jq -r '.absoluteTaskPath // empty')
+REASON=$(echo "$INPUT" | jq -r '.reason // empty')
+QUESTIONS=$(echo "$INPUT" | jq -r '.questions // empty')
+URGENCY=$(echo "$INPUT" | jq -r '.urgency // empty')
+require_param "absoluteTaskPath" "$ABSOLUTE_TASK_PATH"
+require_param "reason" "$REASON"
+
+BODY=$(jq -n \
+  --arg absoluteTaskPath "$ABSOLUTE_TASK_PATH" \
+  --arg reason "$REASON" \
+  --arg questions "$QUESTIONS" \
+  --arg urgency "$URGENCY" \
+  '{absoluteTaskPath: $absoluteTaskPath, reason: $reason} +
+   (if $questions != "" then {questions: $questions} else {} end) +
+   (if $urgency != "" then {urgency: $urgency} else {} end)')
+
+api_call POST "/task-management/block" "$BODY"

package/config/skills/agent/block-task/instructions.md

@@ -0,0 +1,22 @@
+# Block Task
+
+Mark a task as blocked with a reason explaining the blocker. Optionally include questions for the orchestrator and an urgency level.
+
+## Parameters
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `absoluteTaskPath` | Yes | Absolute filesystem path to the task file |
+| `reason` | Yes | Explanation of why the task is blocked |
+| `questions` | No | Specific questions for the orchestrator to resolve the blocker |
+| `urgency` | No | Urgency level: `low`, `medium`, `high`, `critical` |
+
+## Example
+
+```bash
+bash config/skills/agent/block-task/execute.sh '{"absoluteTaskPath":"/projects/app/tasks/deploy-api.md","reason":"Missing production database credentials","questions":"Where are the DB credentials stored?","urgency":"high"}'
+```
+
+## Output
+
+JSON confirmation that the task has been marked as blocked and the orchestrator has been notified.

package/config/skills/agent/block-task/skill.json

@@ -0,0 +1,20 @@
+{
+  "id": "agent-block-task",
+  "name": "Block Task",
+  "description": "Mark a task as blocked with a reason and optional questions for the orchestrator.",
+  "category": "task-management",
+  "skillType": "claude-skill",
+  "promptFile": "instructions.md",
+  "execution": {
+    "type": "script",
+    "script": {
+      "file": "execute.sh",
+      "interpreter": "bash",
+      "timeoutMs": 15000
+    }
+  },
+  "assignableRoles": ["developer", "qa", "tpm", "designer", "frontend-developer", "backend-developer", "fullstack-dev", "qa-engineer", "product-manager", "architect", "generalist", "sales", "support"],
+  "triggers": ["block task", "task blocked", "stuck on task", "need help"],
+  "tags": ["task", "blocker", "status"],
+  "version": "1.0.0"
+}

package/config/skills/agent/check-quality-gates/execute.sh

@@ -0,0 +1,20 @@
+#!/bin/bash
+# Run quality gate checks against the project
+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 '{\"projectPath\":\"/path/to/project\"}'"
+
+PROJECT_PATH=$(echo "$INPUT" | jq -r '.projectPath // empty')
+GATES=$(echo "$INPUT" | jq -r '.gates // empty')
+SKIP_OPTIONAL=$(echo "$INPUT" | jq -r '.skipOptional // empty')
+
+# Build body with optional fields
+BODY=$(echo "$INPUT" | jq '{} +
+  (if .projectPath then {projectPath: .projectPath} else {} end) +
+  (if .gates then {gates: .gates} else {} end) +
+  (if .skipOptional == true then {skipOptional: true} else {} end)')
+
+api_call POST "/quality-gates/check" "$BODY"

package/config/skills/agent/check-quality-gates/instructions.md

@@ -0,0 +1,23 @@
+# Check Quality Gates
+
+Run quality gate checks against the project. This includes build verification, linting, unit tests, and any other configured gates. Use this before completing a task to ensure your changes meet project standards.
+
+Note: This operation may take several minutes depending on the project size and configured gates.
+
+## Parameters
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `projectPath` | No | Absolute path to the project directory |
+| `gates` | No | Array of specific gates to run (e.g., `["build", "test", "lint"]`). Runs all if omitted |
+| `skipOptional` | No | Set to `true` to skip optional quality gates |
+
+## Example
+
+```bash
+bash config/skills/agent/check-quality-gates/execute.sh '{"projectPath":"/projects/app","gates":["build","test"]}'
+```
+
+## Output
+
+JSON with results for each quality gate including pass/fail status, duration, and any error details.

package/config/skills/agent/check-quality-gates/skill.json

@@ -0,0 +1,20 @@
+{
+  "id": "agent-check-quality-gates",
+  "name": "Check Quality Gates",
+  "description": "Run quality gate checks (build, tests, lint) against the project before completing a task.",
+  "category": "quality",
+  "skillType": "claude-skill",
+  "promptFile": "instructions.md",
+  "execution": {
+    "type": "script",
+    "script": {
+      "file": "execute.sh",
+      "interpreter": "bash",
+      "timeoutMs": 300000
+    }
+  },
+  "assignableRoles": ["developer", "qa", "tpm", "designer", "frontend-developer", "backend-developer", "fullstack-dev", "qa-engineer", "product-manager", "architect", "generalist", "sales", "support"],
+  "triggers": ["check quality", "run gates", "quality gates", "verify build", "run tests"],
+  "tags": ["quality", "testing", "build", "lint", "gates"],
+  "version": "1.0.0"
+}

package/config/skills/agent/complete-task/execute.sh

@@ -0,0 +1,26 @@
+#!/bin/bash
+# Mark a task as complete with a summary of the work done
+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 '{\"absoluteTaskPath\":\"/path/to/task\",\"sessionName\":\"dev-1\",\"summary\":\"Implemented feature X\"}'"
+
+ABSOLUTE_TASK_PATH=$(echo "$INPUT" | jq -r '.absoluteTaskPath // empty')
+SESSION_NAME=$(echo "$INPUT" | jq -r '.sessionName // empty')
+SUMMARY=$(echo "$INPUT" | jq -r '.summary // empty')
+SKIP_GATES=$(echo "$INPUT" | jq -r '.skipGates // empty')
+require_param "absoluteTaskPath" "$ABSOLUTE_TASK_PATH"
+require_param "sessionName" "$SESSION_NAME"
+require_param "summary" "$SUMMARY"
+
+BODY=$(jq -n \
+  --arg absoluteTaskPath "$ABSOLUTE_TASK_PATH" \
+  --arg sessionName "$SESSION_NAME" \
+  --arg summary "$SUMMARY" \
+  --arg skipGates "$SKIP_GATES" \
+  '{absoluteTaskPath: $absoluteTaskPath, sessionName: $sessionName, summary: $summary} +
+   (if $skipGates == "true" then {skipGates: true} else {} end)')
+
+api_call POST "/task-management/complete" "$BODY"

package/config/skills/agent/complete-task/instructions.md

@@ -0,0 +1,22 @@
+# Complete Task
+
+Mark a task as complete with a summary of the work done. Optionally skip quality gates if they have already been verified separately.
+
+## Parameters
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `absoluteTaskPath` | Yes | Absolute filesystem path to the task file |
+| `sessionName` | Yes | Your agent session name |
+| `summary` | Yes | Summary of the work completed |
+| `skipGates` | No | Set to `true` to skip quality gate checks |
+
+## Example
+
+```bash
+bash config/skills/agent/complete-task/execute.sh '{"absoluteTaskPath":"/projects/app/tasks/implement-login.md","sessionName":"dev-1","summary":"Implemented login form with validation and tests"}'
+```
+
+## Output
+
+JSON confirmation of task completion status.

package/config/skills/agent/complete-task/skill.json

@@ -0,0 +1,20 @@
+{
+  "id": "agent-complete-task",
+  "name": "Complete Task",
+  "description": "Mark a task as complete with a summary of the work done.",
+  "category": "task-management",
+  "skillType": "claude-skill",
+  "promptFile": "instructions.md",
+  "execution": {
+    "type": "script",
+    "script": {
+      "file": "execute.sh",
+      "interpreter": "bash",
+      "timeoutMs": 15000
+    }
+  },
+  "assignableRoles": ["developer", "qa", "tpm", "designer", "frontend-developer", "backend-developer", "fullstack-dev", "qa-engineer", "product-manager", "architect", "generalist", "sales", "support"],
+  "triggers": ["complete task", "finish task", "mark done", "task done"],
+  "tags": ["task", "completion", "status"],
+  "version": "1.0.0"
+}

package/config/skills/agent/get-my-context/execute.sh

@@ -0,0 +1,23 @@
+#!/bin/bash
+# Retrieve accumulated context including memories, learnings, and project knowledge
+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 '{\"agentId\":\"dev-1\",\"agentRole\":\"developer\",\"projectPath\":\"/projects/app\"}'"
+
+AGENT_ID=$(echo "$INPUT" | jq -r '.agentId // empty')
+AGENT_ROLE=$(echo "$INPUT" | jq -r '.agentRole // empty')
+PROJECT_PATH=$(echo "$INPUT" | jq -r '.projectPath // empty')
+require_param "agentId" "$AGENT_ID"
+require_param "agentRole" "$AGENT_ROLE"
+require_param "projectPath" "$PROJECT_PATH"
+
+BODY=$(jq -n \
+  --arg agentId "$AGENT_ID" \
+  --arg agentRole "$AGENT_ROLE" \
+  --arg projectPath "$PROJECT_PATH" \
+  '{agentId: $agentId, agentRole: $agentRole, projectPath: $projectPath}')
+
+api_call POST "/memory/my-context" "$BODY"

package/config/skills/agent/get-my-context/instructions.md

@@ -0,0 +1,21 @@
+# Get My Context
+
+Retrieve your accumulated context including memories, learnings, and project knowledge. Use this at startup or when beginning a new task to load relevant background information.
+
+## Parameters
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `agentId` | Yes | Your agent ID |
+| `agentRole` | Yes | Your role (e.g., `"developer"`, `"qa"`) |
+| `projectPath` | Yes | Absolute path to the current project |
+
+## Example
+
+```bash
+bash config/skills/agent/get-my-context/execute.sh '{"agentId":"dev-1","agentRole":"developer","projectPath":"/projects/app"}'
+```
+
+## Output
+
+JSON with your accumulated context including past memories, learnings, project-specific knowledge, team SOPs, and relevant history.

package/config/skills/agent/get-my-context/skill.json

@@ -0,0 +1,20 @@
+{
+  "id": "agent-get-my-context",
+  "name": "Get My Context",
+  "description": "Retrieve your accumulated context including memories, learnings, and project knowledge.",
+  "category": "memory",
+  "skillType": "claude-skill",
+  "promptFile": "instructions.md",
+  "execution": {
+    "type": "script",
+    "script": {
+      "file": "execute.sh",
+      "interpreter": "bash",
+      "timeoutMs": 15000
+    }
+  },
+  "assignableRoles": ["developer", "qa", "tpm", "designer", "frontend-developer", "backend-developer", "fullstack-dev", "qa-engineer", "product-manager", "architect", "generalist", "sales", "support"],
+  "triggers": ["get context", "my context", "what do I know", "load context"],
+  "tags": ["memory", "context", "knowledge", "startup"],
+  "version": "1.0.0"
+}

package/config/skills/agent/get-sops/execute.sh

@@ -0,0 +1,24 @@
+#!/bin/bash
+# Query standard operating procedures relevant to the current context
+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 '{\"context\":\"deploying to production\"}'"
+
+CONTEXT=$(echo "$INPUT" | jq -r '.context // empty')
+require_param "context" "$CONTEXT"
+
+CATEGORY=$(echo "$INPUT" | jq -r '.category // empty')
+ROLE=$(echo "$INPUT" | jq -r '.role // empty')
+
+BODY=$(jq -n \
+  --arg context "$CONTEXT" \
+  --arg category "$CATEGORY" \
+  --arg role "$ROLE" \
+  '{context: $context} +
+   (if $category != "" then {category: $category} else {} end) +
+   (if $role != "" then {role: $role} else {} end)')
+
+api_call POST "/system/sops/query" "$BODY"

package/config/skills/agent/get-sops/instructions.md

@@ -0,0 +1,21 @@
+# Get SOPs
+
+Query standard operating procedures (SOPs) relevant to your current context or task. SOPs contain team-defined guidelines, workflows, and best practices.
+
+## Parameters
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `context` | Yes | Description of what you need SOPs for (e.g., `"deploying to production"`) |
+| `category` | No | Filter by SOP category (e.g., `"deployment"`, `"testing"`, `"code-review"`) |
+| `role` | No | Filter by role relevance (e.g., `"developer"`, `"qa"`) |
+
+## Example
+
+```bash
+bash config/skills/agent/get-sops/execute.sh '{"context":"deploying a new backend service","category":"deployment","role":"developer"}'
+```
+
+## Output
+
+JSON with matching SOPs including their titles, content, and applicability metadata.

package/config/skills/agent/get-sops/skill.json

@@ -0,0 +1,20 @@
+{
+  "id": "agent-get-sops",
+  "name": "Get SOPs",
+  "description": "Query standard operating procedures relevant to your current context or task.",
+  "category": "system",
+  "skillType": "claude-skill",
+  "promptFile": "instructions.md",
+  "execution": {
+    "type": "script",
+    "script": {
+      "file": "execute.sh",
+      "interpreter": "bash",
+      "timeoutMs": 15000
+    }
+  },
+  "assignableRoles": ["developer", "qa", "tpm", "designer", "frontend-developer", "backend-developer", "fullstack-dev", "qa-engineer", "product-manager", "architect", "generalist", "sales", "support"],
+  "triggers": ["get sops", "standard procedures", "how to", "best practices"],
+  "tags": ["system", "sops", "procedures", "guidelines"],
+  "version": "1.0.0"
+}

package/config/skills/agent/get-team-status/execute.sh

@@ -0,0 +1,8 @@
+#!/bin/bash
+# Get the current status of all teams and their members
+set -euo pipefail
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "${SCRIPT_DIR}/../_common/lib.sh"
+
+# No input required for this skill
+api_call GET "/teams"

package/config/skills/agent/get-team-status/instructions.md

@@ -0,0 +1,17 @@
+# Get Team Status
+
+Get the current status of all teams and their members. Returns team names, member roles, agent statuses, and working statuses.
+
+## Parameters
+
+No parameters required.
+
+## Example
+
+```bash
+bash config/skills/agent/get-team-status/execute.sh '{}'
+```
+
+## Output
+
+JSON with team data including each team's members, their roles, agent status (active/inactive), and current working status (idle/in_progress).

package/config/skills/agent/get-team-status/skill.json

@@ -0,0 +1,20 @@
+{
+  "id": "agent-get-team-status",
+  "name": "Get Team Status",
+  "description": "Get the current status of all teams and their members.",
+  "category": "monitoring",
+  "skillType": "claude-skill",
+  "promptFile": "instructions.md",
+  "execution": {
+    "type": "script",
+    "script": {
+      "file": "execute.sh",
+      "interpreter": "bash",
+      "timeoutMs": 15000
+    }
+  },
+  "assignableRoles": ["developer", "qa", "tpm", "designer", "frontend-developer", "backend-developer", "fullstack-dev", "qa-engineer", "product-manager", "architect", "generalist", "sales", "support"],
+  "triggers": ["team status", "who is online", "check team", "team members"],
+  "tags": ["monitoring", "team", "status", "agents"],
+  "version": "1.0.0"
+}

package/config/skills/agent/manage-knowledge/execute.sh

@@ -0,0 +1,60 @@
+#!/bin/bash
+# Manage Knowledge Documents - create or update company knowledge docs
+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 '{\"action\":\"create\",\"title\":\"...\",\"content\":\"...\",\"category\":\"SOPs\",\"scope\":\"global\"}'"
+
+ACTION=$(echo "$INPUT" | jq -r '.action // empty')
+require_param "action" "$ACTION"
+
+if [ "$ACTION" = "create" ]; then
+  TITLE=$(echo "$INPUT" | jq -r '.title // empty')
+  CONTENT=$(echo "$INPUT" | jq -r '.content // empty')
+  CATEGORY=$(echo "$INPUT" | jq -r '.category // "General"')
+  SCOPE=$(echo "$INPUT" | jq -r '.scope // "global"')
+  PROJECT_PATH=$(echo "$INPUT" | jq -r '.projectPath // empty')
+  TAGS=$(echo "$INPUT" | jq -c '.tags // []')
+  CREATED_BY=$(echo "$INPUT" | jq -r '.createdBy // "agent"')
+
+  require_param "title" "$TITLE"
+  require_param "content" "$CONTENT"
+
+  BODY=$(jq -n \
+    --arg title "$TITLE" \
+    --arg content "$CONTENT" \
+    --arg category "$CATEGORY" \
+    --arg scope "$SCOPE" \
+    --arg projectPath "$PROJECT_PATH" \
+    --argjson tags "$TAGS" \
+    --arg createdBy "$CREATED_BY" \
+    '{title: $title, content: $content, category: $category, scope: $scope, projectPath: $projectPath, tags: $tags, createdBy: $createdBy}')
+
+  api_call POST "/knowledge/documents" "$BODY"
+
+elif [ "$ACTION" = "update" ]; then
+  ID=$(echo "$INPUT" | jq -r '.id // empty')
+  require_param "id" "$ID"
+
+  SCOPE=$(echo "$INPUT" | jq -r '.scope // "global"')
+  PROJECT_PATH=$(echo "$INPUT" | jq -r '.projectPath // empty')
+  UPDATED_BY=$(echo "$INPUT" | jq -r '.updatedBy // "agent"')
+
+  # Build update body with only provided fields
+  BODY=$(echo "$INPUT" | jq '{
+    title: .title,
+    content: .content,
+    category: .category,
+    tags: .tags,
+    scope: (.scope // "global"),
+    projectPath: .projectPath,
+    updatedBy: (.updatedBy // "agent")
+  } | with_entries(select(.value != null and .value != ""))')
+
+  api_call PUT "/knowledge/documents/${ID}" "$BODY"
+
+else
+  error_exit "Invalid action '${ACTION}'. Must be 'create' or 'update'"
+fi