Back to Skills

cancelloop

verified

Reason for pausing/cancelling

View on GitHub

Marketplace

brockhoff-tools

kbrockhoff/brockhoff-tools-claude

Plugin

bkff

Repository

kbrockhoff/brockhoff-tools-claude

plugins/bkff/skills/cancelloop/SKILL.md

Last Verified

January 24, 2026

Install Skill

Select agents to install to:

Scope:
npx add-skill https://github.com/kbrockhoff/brockhoff-tools-claude/blob/main/plugins/bkff/skills/cancelloop/SKILL.md -a claude-code --skill cancelloop

Installation paths:

Claude
.claude/skills/cancelloop/
Powered by add-skill CLI

Instructions

# Cancel Development Loop

Stops the agentic development loop gracefully. The loop will complete its current atomic operation before stopping.

## Usage

```bash
# Cancel the loop (archives state to history)
/bkff:cancelloop

# Pause the loop (can be resumed later)
/bkff:cancelloop --pause

# Pause with a reason
/bkff:cancelloop --pause --reason="Need to review approach"
```

## Behavior

### Cancel (Default)

- Stops the loop immediately after current operation
- Archives loop state to `.bkff/history/`
- Removes active loop state file
- Current task remains in `in_progress` status in beads

### Pause

- Sets loop status to `paused`
- Preserves all state for later resume
- Records pause reason if provided
- Can be resumed with `/bkff:startloop --resume`

## Output

### Cancelling Active Loop

```
Development Loop Status
─────────────────────────────────────
  Status:         running
  Started:        2026-01-24T10:30:00Z
  Completed:      5 tasks

Current Task
  Task ID:        T018
  Title:          Implement validation helpers
  Started:        2026-01-24T11:15:00Z

✓ Loop cancelled
Debug: Archived loop state to .bkff/history/2026-01-24T11-20-00Z.json
```

### Pausing Loop

```
Development Loop Status
─────────────────────────────────────
  Status:         running
  Started:        2026-01-24T10:30:00Z
  Completed:      5 tasks

Info: Loop paused: Need to review approach

To resume: /bkff:startloop --resume
```

### No Loop Running

```
Info: No loop running
```

## State After Cancel

When cancelled, the loop state is archived to `.bkff/history/`:

```json
{
  "status": "stopped",
  "started_at": "2026-01-24T10:30:00Z",
  "stopped_at": "2026-01-24T11:20:00Z",
  "current_task": {
    "beads_id": "beads-abc123",
    "task_id": "T018",
    "title": "Implement validation helpers",
    "started_at": "2026-01-24T11:15:00Z"
  },
  "completed_tasks": [
    {"beads_id": "beads-xyz789", "task_id": "T014", ...},
    {"beads_id": "beads-def456", "task_id": "T015", ...}
  ],

Validation Details

Front Matter
Required Fields
Valid Name Format
Valid Description
Has Sections
Allowed Tools
Instruction Length:
3568 chars