Skip to content

mikeparcewski/wicked-garden / skills/core

wicked-garden-core

Flagged

Core utility surface for the wicked-garden plugin: help/overview, first-run setup + codebase onboarding, the wicked-* peer installer, selective state reset, the where-am-i path manifest, and structured issue filing. Use when: "wicked-garden help", "show wicked-garden commands", "what can wicked-garden do", "set up wicked-garden", "setup", "--reconfigure", "onboard this codebase", "install wicked tools", "add peers", "install layers", "reset wicked-garden", "clear state", "--list-projects", "where am I", "path manifest", "report issue", "file a bug", "--list-unfiled", or any former /wicked-garden:{help|setup|install|reset| where-am-i|report-issue} invocation.

FileKindSize
SKILL.mdskill md13.4 KB
refs/install.mdmarkdown5.3 KB
refs/inventory-report.mdmarkdown1.3 KB
refs/report-issue.mdmarkdown8.4 KB
refs/reset.mdmarkdown4.3 KB
refs/runtime.mdmarkdown4.2 KB
refs/setup.mdmarkdown23.5 KB
refs/templates.mdmarkdown2.3 KB

refs/reset.md

View on GitHub
# Action: reset

Reset wicked-garden to a clean state — selectively clear wicked-garden local
state. Shows what exists and lets the user choose what to reset.

## Arguments

- `--all`: Select all domains for clearing (can combine with `--keep`)
- `--only {domains}`: Comma-separated list of specific domains to clear
- `--keep {domains}`: Comma-separated domains to preserve when using `--all`
- `--force`: Skip confirmation prompt
- `--list-projects`: List all projects with stored state (each working directory is a separate project)
- `--all-projects`: Operate on all projects, not just the current one

## Project Scope

State is project-scoped — each working directory gets its own isolated storage. The reset action operates on the current project by default. Use `--list-projects` to see all projects, and `--all-projects` to clear data across all of them.

## Question Mode

Detect whether a native question prompt is usable (INTERACTIVE) or every question goes out as a plain-text list (PLAIN_TEXT). The detector keys on the Claude harness's dangerous-mode flag only — on any other seat read PLAIN_TEXT regardless of its answer:

```bash
wicked-garden python -c "
import json, os, sys
from pathlib import Path
sys.path.insert(0, str(Path(os.environ["WICKED_GARDEN_ROOT"]) / 'scripts'))
from _session import SessionState
state = SessionState.load()
print('PLAIN_TEXT' if state.dangerous_mode else 'INTERACTIVE')
"
```

## Instructions

### 1. Scan Current State

Run a dry-run scan to see what exists:

```bash
wicked-garden run scripts/_run.py scripts/reset.py --json
```

Parse the JSON output. Extract the domains where `exists` is `true`.

The JSON output includes `project` (current project slug) and `project_root` (storage path).

If no domains have state, tell the user: "Nothing to reset — wicked-garden has no local state for project {project}." and stop.

**If `--list-projects` was passed**: Run `wicked-garden run scripts/_run.py scripts/reset.py --list-projects --json` instead and display the project list. Stop after showing.

**If `--all-projects` was passed**: Add `--all-projects` to the reset command in Step 4.

### 2. Show State and Ask What to Clear

**If `--all` or `--only` was passed**: Skip the selection — targets are already known. Go to Step 3.

**Otherwise**: Present the found domains and let the user choose.

Show a numbered list of domains that have state, plus an "All" option:

```
## Current wicked-garden state (project: {project_slug})

Found {n} domain(s) with local data:

  1. config — Setup configuration (52 B)
  2. crew — Crew project data (4 KB)
  3. mem — Memory store (8 KB)
  4. search — Search index (2.1 MB)
  a. All of the above

Which domains would you like to reset? (comma-separated numbers, or 'a' for all)
```

Only list domains where `exists` is `true`. Number them sequentially.

**INTERACTIVE mode**: the native question prompt would apply, but since there may be more than 4 options use plain text instead (native prompts support up to 4 options).

**In both modes**: Present as plain text and STOP. Wait for the user to reply.

Parse the user's reply:
- Single number → that domain only
- Comma-separated numbers (e.g., "1,3,5") → those domains
- "a" or "all" → all found domains
- Domain names (e.g., "crew, jam") → those domains directly

Echo back: "You selected: **{domain list}**."

### 3. Confirm

**If `--force` was passed**: Skip to Step 4.

Present a confirmation:

```
This will permanently clear: {selected domains}

1. Yes, clear selected data
2. Cancel

Please reply with 1 or 2.
```

STOP and wait. If the user cancels, say "Reset cancelled." and stop.

### 4. Execute Reset

Build the `--only` list from the user's selection:

```bash
wicked-garden run scripts/_run.py scripts/reset.py --confirm --only {selected_domains_space_separated} --json
```

Or if `--all` with `--keep`:

```bash
wicked-garden run scripts/_run.py scripts/reset.py --confirm --all --keep {kept_domains_space_separated} --json
```

### 5. Report Results

Parse the JSON output and show:

```
## Reset complete

Cleared: crew, jam
Kept: config, mem, search, delivery, jam
Errors: none

Note: If you cleared 'config', the setup wizard will run on your next session.
Invoke the wicked-garden-core skill's setup action to reconfigure now.
```

If there were errors, show them and suggest manual cleanup.
receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementationStars: 322kUpdated Claude CodeCodexVerifiedInstall
requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirementsStars: 322kUpdated Claude CodeCodexVerifiedInstall
using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallbackStars: 322kUpdated Claude CodeCodexVerifiedInstall
verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions alwaysStars: 322kUpdated Claude CodeCodexVerifiedInstall