clawdie/colibri
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions 43

skill(debug): positive framing — failure modes→resolution patterns, broken→errors

Browse source
This commit is contained in:
Sam & Claude 2026-06-26 12:42:30 +02:00
parent 6c37022380
commit d6147bf6a9
1 changed files with 7 additions and 7 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

14
.agent/skills/debug/SKILL.md
View file

@ -1,6 +1,6 @@
---
name: debug
description: Debug Clawdie agent issues on the current FreeBSD host runtime. Use when the agent is not responding, the service is crashing, Telegram messages go unanswered, pi subprocesses fail, or when verifying the live runtime shape. Covers host service management, logs, optional jail state, memory DB reachability, and common failure modes.
description: Debug Clawdie agent issues on the current FreeBSD host runtime. Use when the agent is not responding, the service is restarting, Telegram messages go unanswered, subprocesses stall, or when verifying the live runtime shape. Covers host service management, logs, optional jail state, memory DB reachability, and common resolution patterns.
---
# Clawdie Agent Debugging (FreeBSD host runtime)
@ -74,7 +74,7 @@ tail -50 logs/clawdie.error.log
ls groups/*/logs/agent-*.log | tail -5
```
When a specific run failed, read the newest per-run log directly:
After a run completes with an error, read the newest per-run log:
```bash
ls -t groups/*/logs/agent-*.log | head -3
@ -133,7 +133,7 @@ command -v pi
pi --version
```
Common causes:
What to check first:
- provider key missing or expired
- `PI_TUI_BIN` points at a dead path
@ -177,7 +177,7 @@ grep -E 'fatal|error|exit|SIGTERM|SIGKILL' logs/clawdie.log | tail -20
grep '409\|duplicate\|conflict' logs/clawdie.log | tail -10
```
Temporarily stop the service to break the loop, fix the root cause, then
Pause the service to stop the restart loop, resolve the underlying issue, then
restart.
### Watchdog or controlplane resets the agent
@ -187,7 +187,7 @@ grep -i watchdog logs/clawdie.log | tail -10
grep -i controlplane logs/heartbeat.log | tail -20
```
### Build broken after a code change
### Build errors after a code change
```bash
npm run build
@ -217,7 +217,7 @@ tail -10 logs/clawdie.error.log
## 6. Optional jail shell access
Only for installs that actually use jails for the thing you are debugging:
For jail-backed installs:
```bash
sudo bastille console db
@ -272,7 +272,7 @@ ls groups/main/logs/
ls groups/main/ipc/ 2>/dev/null
```
Run logs are disposable debugging artifacts:
Run logs are temporary diagnostic files:
```bash
rm -f groups/main/logs/agent-*.log