Tick Md

# Tick Multi-Agent Coordination

Coordinate work across human and AI agents using structured Markdown files. Users interact naturally with you, and you maintain tasks transparently in TICK.md.

## Installation

**Prerequisites**: The Tick CLI and MCP server should already be installed and configured by your environment.

**First time setup?** See `INSTALL.md` for editor-specific installation instructions.

## Safety Boundaries

- Ask for explicit user approval before editing editor MCP config files.
- Ask for explicit user approval before running any command that pushes to remote git (`tick sync --push` or `git push`).
- If user approval is not explicit, use read-only/status commands and explain what write action is pending.

**Quick Check**:
```bash
# Verify CLI is available
tick --version

# Check if TICK.md exists in project
ls TICK.md

# If not, initialize
tick init
```

## Core Concept

**Tick Protocol** = Git-based task coordination via TICK.md files
- **Human-readable**: Standard Markdown with YAML
- **Machine-parseable**: Structured for tools
- **Git-backed**: Full version control and audit trail
- **Local-first**: No cloud required

## Quick Start

### Check if Tick is initialized
```bash
ls TICK.md
```

### If not initialized
```bash
tick init
```

### Get current status
```bash
tick status
```

## Common Workflows

### 1. User Asks You to Do Something

**User**: "Can you refactor the authentication system?"

**Your Actions**:
```bash
# 1. Create task
tick add "Refactor authentication system" --priority high --tags backend,security

# 2. Register yourself (first time only)
tick agent register @your-name --type bot --roles "engineer,refactoring"

# 3. Claim the task
tick claim TASK-XXX @your-name

# 4. Work on it (do the actual work)

# 5. Add progress comments
tick comment TASK-XXX @your-name --note "Analyzing current auth flow"
tick comment TASK-XXX @your-name --note "Refactored to use JWT tokens"

# 6. Mark complete
tick done TASK-XXX @your-name
```

###...

# tick-md Skill

ClawHub-ready skill package for multi-agent task coordination.

## Package Structure

```
clawhub-skill/
├── SKILL.md              # Main skill documentation (ClawHub displays this)
├── skill.json            # Metadata for ClawHub registry
├── INSTALL.md            # Installation and editor setup
├── mcp-reference.md      # Complete MCP tools reference
├── CHANGELOG.md          # Version history
└── README.md             # This file
```

## Publishing to ClawHub

### Prerequisites
1. Install ClawHub CLI:
   ```bash
   npm install -g clawhub
   ```

2. Authenticate (if required):
   ```bash
   clawhub login
   ```

### Publishing

From this directory:
```bash
clawhub publish .
```

The CLI will:
- Package all files in this directory
- Read metadata from `skill.json`
- Upload to ClawHub registry
- Make available at `clawhub.ai/gianni-dalerta/tick-md`

### Updating

To publish a new version:
1. Update `skill.json` version (follow semver)
2. Update `CHANGELOG.md`
3. Run `clawhub publish .` again

```bash
# Example: publish v1.0.1
# 1. Edit skill.json: "version": "1.0.1"
# 2. Add entry to CHANGELOG.md
# 3. Publish
clawhub publish .
```

## Local Testing

Test the skill locally before publishing:

### Option 1: Copy to Cursor Skills
```bash
cp -r . ~/.cursor/skills/tick-md/
```

Restart Cursor and the skill will be available.

### Option 2: Use workspace skills
```bash
# In your project
mkdir -p skills
cp -r . skills/tick-md/
```

OpenClaw/Cursor will pick up skills from `./skills/` in the current workspace.

### Option 3: Install from ClawHub (after publishing)
```bash
clawhub search "tick-md"
clawhub install tick-md
```

## What Gets Published

When you run `clawhub publish .`, these files are included:
- ✅ `SKILL.md` - Main documentation (required, editor-agnostic)
- ✅ `skill.json` - Metadata (required)
- ✅ `INSTALL.md` - Installation guide (editor-specific setup)
- ✅ `mcp-reference.md` - API reference
- ✅ `CHANGELOG.md` - Version history
- ✅ `RE...