Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 11 additions & 0 deletions .claude-plugin/marketplace.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
{
"name": "tg-autopilot",
"owner": { "name": "ThemeGrill" },
"plugins": [
{
"name": "tg-autopilot",
"source": "./",
"description": "ThemeGrill shared bot automation playbooks: repo onboarding, Crisp triage debugging, and GitHub Actions verification."
}
]
}
5 changes: 5 additions & 0 deletions .claude-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
{
"name": "tg-autopilot",
"description": "ThemeGrill shared bot automation playbooks: repo onboarding, Crisp triage debugging, and GitHub Actions verification.",
"version": "1.0.0"
}
6 changes: 3 additions & 3 deletions CLAUDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,16 +2,16 @@

This repo hosts ThemeGrill's shared bot automation: reusable GitHub Actions workflows (PR build-zip, Copilot review) and the Crisp β†’ AI β†’ GitHub issue triage pipeline. Machine user: `tg-autopilot`.

**Before doing anything here, check `.claude/skills/` first.** There is very likely already a skill covering the task β€” onboarding a repo, debugging a specific failure mode, verifying a change actually took effect. Re-deriving one of these from scratch instead of using the existing skill is exactly how repeat mistakes happen; see `CHANGELOG.md` 2026-09-29 for one that cost real debugging time.
**Before doing anything here, check `skills/` first (plugin `tg-autopilot`; skills show up as `tg-autopilot:<name>`).** There is very likely already a skill covering the task β€” onboarding a repo, debugging a specific failure mode, verifying a change actually took effect. Re-deriving one of these from scratch instead of using the existing skill is exactly how repeat mistakes happen; see `CHANGELOG.md` 2026-09-29 for one that cost real debugging time.

**Work from a persistent local checkout, not a disposable clone.** A fresh `git clone` into a scratch directory (e.g. `/tmp`) never has `.claude/skills/` loaded, which defeats the point of this file and everything below it.
**Work from a persistent local checkout, not a disposable clone.** A fresh `git clone` into a scratch directory (e.g. `/tmp`) never has the `tg-autopilot` plugin loaded, which defeats the point of this file and everything below it.

## Map

- `SETUP.md` β€” Phase 1 (pr-build-zip, Copilot review): one-time credentials/setup.
- `PHASE2-SETUP.md` β€” Phase 2 (Crisp triage): credentials/setup **and** the actual design policy β€” Β§ 4c/4d explain what triggers an investigation and why, and are the first thing to read before touching `crisp-classify.mjs`.
- `CHANGELOG.md` β€” dated entries for notable fixes/redesigns. Read the most recent entries before assuming you understand current behavior; policy here has changed more than once.
- `.claude/skills/` β€” task- and symptom-oriented playbooks (onboarding, debugging, verification). Check this before improvising.
- `skills/` β€” task- and symptom-oriented playbooks (onboarding, debugging, verification). Check this before improvising.
- `scripts/` β€” all Node scripts, most with dense "why" comments at the point of the actual gotcha, not just a docstring at the top. Read the comment before changing the line it's attached to.
- `state/` β€” committed JSON state (`cursor.json`, `escalated.json`, `resolved-seen.json`, `investigated.json`, `active-notified.json`). These are data, not config β€” don't hand-edit without understanding what reads them first.
- `config/inbox-to-repo.json` β€” Crisp account β†’ GitHub repo routing.
Expand Down
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ We use a machine user instead of a GitHub App because it keeps one identity acro

## Maintainer skills

`.claude/skills/` has step-by-step guides for the maintenance tasks below. Start here before touching config or workflows by hand β€” each one already bakes in the gotchas this README used to spell out inline.
`skills/` (a Claude Code plugin, invoked as `tg-autopilot:<skill>`) has step-by-step guides for the maintenance tasks below. Start here before touching config or workflows by hand β€” each one already bakes in the gotchas this README used to spell out inline.

| Skill | Use it when... |
|---|---|
Expand Down
Loading