Skip to content

tvproductions/gzkit / .agents/skills/gz-how

gz-how

Verified

Use when the operator asks "how do I …?" or "what can I …?", or when unsure which skill applies or two look alike.

references/codebase-upkeep.md

View on GitHub
# Codebase upkeep

Not feature work: keeping the codebase good to operate in. You are here with a
maintenance task, or time to spare.

## Steps

- **A scheduled or stale chore** → **`gz-chore-runner`**: show, plan, advise,
  run and validate one chore. `uv run gz chores status` shows which are stale.
- **Where the debt is** → **`gz-tech-debt-review`**: a line-grounded survey that
  routes each finding to a chore, an in-flight fix or at most one GHI.
- **Class shapes that should be plain Python** →
  **`gz-pythonic-pattern-detect`** finds candidates;
  **`gz-pythonic-pattern-apply`** records the evidence for each rewrite applied.
- **Toolchain and dependencies** → **`gz-deps-upgrade`**: uv, the Python
  runtime, `pyproject.toml` pins and `uv.lock` in one pass.
- **The foundation backlog** → **`gz-foundation-triage`** ranks it.
- **Hygiene** → **`gz-tidy`**.

## Branches

- **A finding is a defect** → [Defects and GHIs](defects-and-ghis.md).
- **A finding suggests a design** → [Idea to ADR](idea-to-adr.md).

## Only you can

Choose which upkeep to spend time on; a chore never outranks drawn work.

## Then

[Commit and sync](commit-and-sync.md).
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall