Skip to content

Commit b79413b

Browse files
clockwork-labs-botclockwork-labs-bot
andauthored
Add GREMLINS.md documenting repo bots and agents (#4290)
Documents the automated agents operating on this repo. Starting with Clawd (clockwork-labs-bot), the CI watchdog. This is a living document — new bots/gremlins get documented here. # API and ABI breaking changes None — documentation only. # Expected complexity level and risk 0 — documentation only. # Testing N/A — documentation only. --------- Co-authored-by: clockwork-labs-bot <bot@clockworklabs.com>
1 parent c85219e commit b79413b

1 file changed

Lines changed: 33 additions & 0 deletions

File tree

.github/GREMLINS.md

Lines changed: 33 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,33 @@
1+
# GREMLINS.md — Who Lives in the Pipes
2+
3+
This file documents the automated agents and bots that operate on this repository.
4+
5+
## Clawd 🔧
6+
7+
- **What:** Anti-entropy gremlin / CI watchdog
8+
- **GitHub account:** `clockwork-labs-bot`
9+
- **Discord channel:** #gremlins (CL - SpacetimeDB)
10+
- **Powered by:** [OpenClaw](https://github.com/openclaw/openclaw) + Claude
11+
12+
### What Clawd does
13+
14+
- **Monitors CI** — watches for failures, flaky tests, and regressions
15+
- **Reviews PRs** — comments on obvious bugs (never approves)
16+
- **Surfaces stale PRs** — finds approved PRs that just need a rebase
17+
- **Documents testing** — creates and maintains `DEVELOP.md` files explaining CI and test infrastructure
18+
- **Alerts the team** — posts findings in #gremlins, pings DevOps when something needs attention
19+
20+
### What Clawd does NOT do
21+
22+
- Approve or merge PRs
23+
- Take any destructive action (delete branches, close PRs, force push)
24+
- Modify production infrastructure
25+
26+
### Contacting Clawd
27+
28+
- Mention `@Openclaw` in #gremlins on Discord
29+
- Tag `@clockwork-labs-bot` on GitHub PRs/issues
30+
31+
---
32+
33+
*To add a new gremlin, document it here.*

0 commit comments

Comments
 (0)