cleanup
/cleanup
Domyka workflow po scaleniu: weryfikuje status scalenia PR, uzupełnia metadane syntezy, wymusza rozstrzygnięcie statusów przeglądu, przenosi do stanu ukończonego i sprząta worktrees oraz gałęzie.
- Autor
- lvlup-sw ↗
- Repozytorium
- exarchos ↗
- Licencja
- Apache-2.0
- Ostatnia zmiana repozytorium
- 24.10.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 2
- Skrypty
- 0
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 0
Brak sygnałów. Repozytorium zmienione 24.10.2026, bez odwołań do wycofanych modeli i API.
Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.
Co robi i kiedy
Domyka workflow po scaleniu: weryfikuje status scalenia PR, uzupełnia metadane syntezy, wymusza rozstrzygnięcie statusów przeglądu, przenosi do stanu ukończonego i sprząta worktrees oraz gałęzie.
Wyzwalacze z opisu
Oryginalny opis (EN)
Post-merge workflow resolution. Verifies PR merge status, backfills synthesis metadata, force-resolves review statuses, transitions to completed, and cleans up worktrees/branches. Use when the user says 'cleanup', 'resolve workflow', 'mark as done', or runs /cleanup. Do NOT use before PRs are merged.
Jak działa
- VCS Provider
- Overview
- Batch Pruning for Stale Workflows
- Triggers
- Prerequisites
- Process
- Dry Run
- Error Handling
- Anti-Patterns
- Exarchos Integration
Podgląd SKILL.md
---
name: cleanup
description: "Post-merge workflow resolution. Verifies PR merge status, backfills synthesis metadata, force-resolves review statuses, transitions to completed, and cleans up worktrees/branches. Use when the user says 'cleanup', 'resolve workflow', 'mark as done', or runs /cleanup. Do NOT use before PRs are merged."
metadata:
author: exarchos
version: 1.0.0
mcp-server: exarchos
category: workflow
phase-affinity: completed
---
# Cleanup Skill
## VCS Provider
This skill uses VCS operations through Exarchos MCP actions (`list_prs`, `get_pr_comments`, etc.).
These actions automatically detect and route to the correct VCS provider (GitHub, GitLab, Azure DevOps).
No `gh`/`glab`/`az` commands needed — the MCP server handles provider dispatch.
## Overview
Resolve merged workflows to `completed` state in a single operation. Replaces the manual multi-step process of navigating HSM guards after PR stacks merge.
## Batch Pruning for Stale Workflows
For bulk cleanup of accumulated stale or abandoned workflows (as opposed to resolving a single merged workflow), use `@skills/prune/SKILL.md`. That skill invokes `exarchos_orchestrate prune_stale_workflows` in dry-run mode, displays candidates, and applies after user confirmation. Safeguards automatically skip workflows with open PRs or recent commits.
**Rule of thumb:** cleanup is per-workflow (one merged feature → `completed`); prune is bulk (N inactive workflows → `cancelled`). They are complementary, not alternatives.
## Triggers
Activate this skill when:
- User runs `cleanup` command
- User says "cleanup", "resolve workflow", "mark as done"
- PR stack has merged and workflow needs resolution
- User wants to close out a completed feature
## Prerequisites
- Active workflow in any non-terminal phase
- All PRs merged on GitHub
## Process
### 1. Identify Target Workflow
Read workflow state to get current phase and metadata:
```typescript
exarchos:exarchos_workflow({ action: "get", featureId: "<id>" })
```
If featureId not provided, use pipeline view to list active workflows:
```typescript
exarchos:exarchos_view({ action: "pipeline" })
```
The pipeline view is **repo-scoped by default** — only the caller's repo. A workflow started in another repo won't appear; when the response reports `unscopedTotal` greater than `page.total`, re-query with `scope: "all"` to reveal the hidden rows.
### 2. Verify Merge Status
For each PR associated with the workflow, verify it is merged.
**Primary method** — VCS MCP action:
```typescript
exarchos_orchestrate({ action: "list_prs", state: "merged" })
```
For individual PR details, use `exarchos_orchestrate({ action: "get_pr_comments", prId: "<number>" })` or the VCS provider's native API.
Collect from merged PRs:
- `prUrl`: The PR URL (or array of URLs for stacked PRs)
- `mergedBranches`: The head branch names that were merged
**Safety check:** If ANY PR is not merged, abort with clear error message.
For detailed verification guidance, see `references/merge-verification.md`.
### 2.5. Post-Merge Regression Check (Advisory)
After verifying merge status, run the post-merge regression check:
```typescript
exarchos_orchestrate({
action: "check_post_merge",
featureId: "<id>",
prUrl: "<url>",
mergeSha: "<sha>",
repoRoot: "<repo-root>"
})
```
`repoRoot` is the absolute path of a checkout that contains the merge commit. The check runs the test command that the toolchain resolver finds for that checkout. If no test command resolves, the test check fails and the finding tells you what to add to `.exarchos.yml`.
This check is **advisory** — findings are reported but do not block cleanup. If findings are detected, log them for the user's awareness before proceeding.
### 3. Invoke Cleanup Action
Call the MCP cleanup action with collected data:
```typescript
exarchos:exarchos_workflow({
action: "cleanup",
featureId: "<id>",
mergeVerified: true,
prUrl: "<url-or-array>",
mergedBranches: ["branch1", "branch2"]
})
```
This single call:
- Backfills `synthesis.prUrl` and `synthesis.mergedBranches`
- Force-resolves all blocking review statuses to `approved`
- Transitions to `completed` via universal cleanup path
- Emits `workflow.cleanup` event to event store
### 4. Worktree Cleanup
Reclaim all worktrees associated with the workflow through the governed
garbage-collector `prune_worktrees` — **not** ad-hoc `git worktree remove`.
> **GC cadence — after synthesize (INV-12).** Governed worktrees become
> reclaimable once a workflow reaches synthesis; cleanup runs post-merge (after
> synthesize completes), so this is the natural point to apply the reclamation.
> The `next_actions` projection surfaces the same `prune_worktrees` dry-run
> affordance from synthesis onward.
`prune_worktrees` runs the fail-closed safety ladder (it refuses to destroy a
worktree with unsaved work) and auto-emits the `worktree.remove.requested` /
`worktree.remove.executed` pair per deleted worktree. Dry-run first (the default
— reports candidates + reclaimable bytes + grouped skip reasons, deletes
nothing), then apply:
```typescript
// Dry-run (default) — preview candidates, delete nothing
exarchos:exarchos_orchestrate({ action: "prune_worktrees", repoRoot: "<repo-root>" })
// Apply — reclaim the delete-eligible candidates
exarchos:exarchos_orchestrate({ action: "prune_worktrees", repoRoot: "<repo-root>", dryRun: false })
```
Handle gracefully if worktrees are already removed. If the GC skips a worktree
(e.g. uncommitted work), resolve the reported reason before re-applying — never
force-remove a dirty worktree by hand.
### 5. Branch Sync
Remove merged local branches:
```bash
git fetch --prune
git branch -d <merged-branch-1> <merged-branch-2> ...
```
### 6. Report Completion
Output summary:
```markdown
## Cleanup Complete
**Feature:** <featureId>
**Transition:** <previousPhase> → completed
**PRs merged:** <count>
**Worktrees removed:** <count>
**Branches synced:** ✓
```
## Dry Run
Use `dryRun: true` to preview what cleanup would do without modifying state:
```typescript
exarchos:exarchos_workflow({
action: "cleanup",
featureId: "<id>",
mergeVerified: true,
dryRun: true
})
```
## Error Handling
| Error | Cause | Resolution |
|-------|-------|------------|
| STATE_NOT_FOUND | Invalid featureId | Check pipeline view for active workflows (repo-scoped by default; add `scope: "all"` if the workflow may live in another repo) |
| ALREADY_COMPLETED | Workflow already done | No action needed |
| INVALID_TRANSITION | Workflow is cancelled | Cannot cleanup cancelled workflows |
| GUARD_FAILED | mergeVerified is false | Verify PRs are merged before cleanup |
## Anti-Patterns
| Don't | Do Instead |
|-------|------------|
| Use cleanup as escape hatch during implementation | Only use after PRs are merged |
| Skip merge verification | Always verify via GitHub API |
| Manually navigate HSM guards post-merge | Use cleanup |
| Leave worktrees after cleanup | Include worktree removal in process |
## Exarchos Integration
The cleanup action auto-emits events — do NOT manually emit:
- `workflow.cleanup` — emitted by the MCP cleanup action for the phase change to completed
Pliki w paczce (2)
- SKILL.md 7 KB
- references/merge-verification.md 1 KB
Wersje
| Repozytorium | Wynik | Licencja |
|---|---|---|
| Ta strona · lvlup-sw/exarchos | 100 | Apache-2.0 |
| civitai/civitai | 100 | Apache-2.0 |
| davepoon/buildwithclaude | 100 | MIT |
| rubycatco/herdr-fleet | 100 | MIT |
| CMMD-Center/cmmdstack | 100 | MIT |
| ronedgecomb/anything | 100 | Apache-2.0 |
| NISH1001/vibepiler | 100 | MIT |
| Mooshieblob1/MooshieUI | 100 | AGPL-3.0 |
| Everyone-Needs-A-Copilot/claude-copilot | 100 | MIT |
Identyczna treść występuje jeszcze w 1 innych folderach na GitHubie. Tu pokazujemy jedną, najlepiej ocenioną kopię.
Migawka bazy z 13.11.2026 · wersja paczki fb9d2338ab6e (skrót SHA-256 całej paczki)
Pobrania w ostatnich 30 dniach: 1 · ranking
Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.
Podobne skille
- 100post-merge-cleanup
Sprząta gałęzie i worktree po scaleniu PR i aktualizuje status zadania w STATUS.md lub Linear, z podglądem zmian. - 100cleanup-work
Sprząta worktree i gałęzie lokalne oraz zdalne, których pull requesty zostały scalone, na prośbę lub po scaleniu PR. - 100cleanup-git
Usuwa scalone lokalne gałęzie git i nieaktualne worktrees, porządkując lokalny stan repozytorium. - 100github-pr-cleanup
Sprząta lokalne worktree i gałęzie po scalonych PR na GitHubie oraz opcjonalnie robi cherry-pick do gałęzi wydań, na podstawie linku do PR. - 100branch-cleanup
Sprząta scalone i nieaktualne gałęzie w repozytoriach lokalnych i zdalnych, gdy lista gałęzi jest zagracona lub po scaleniu pull requestów. - 100git-post-merge-cleanup
Sprząta po scaleniach jednym przebiegiem: lokalne gałęzie scalone do domyślnej, referencje zdalne bez remote'a i worktrees już na main; skanuje, klasyfikuje, pokazuje plan i działa po potwierdzeniu.