cmd-internal-refactor

Installation
SKILL.md

cmd/gormes Internal Refactor

Quick start

Move exactly one cmd/gormes command domain without behavior changes. A domain is not one file: when the user says "too slow", "refactor all", or supplies a file list, use accelerated same-domain mode to select the largest cohesive domain cluster from that list, move its directly owned behavior/tests/facades in one pass, validate once, then stop before a second domain. Start every move with a bug-finding oracle: capture the selected command's current observable behavior, add/keep characterization tests for risky seams, and rerun the same evidence after extraction.

Mission

Thin cmd/gormes toward this final topology:

  • cmd/gormes/main.go: executable shim and root factory delegation only. Other tracked root entries, including docs such as codemap.md, must be rehomed or explicitly classified before final topology claims.
  • internal/platform/cli/gormescli: Cobra wiring, flags, args, help, command registration, exit-code seams, CLI/golden tests, root test helpers.
  • internal/app/<domain>: command-local behavior, options/results, formatting/path/env helpers, behavior tests.
  • deeper internal/<runtime-domain> packages: reusable gateway, provider, session, persistence, memory, TUI, channel, and tool runtime behavior.

This is refactor-only, not blind relocation. Use the move to expose regressions and preexisting defects, but preserve current Gormes behavior unless the refactor itself introduced the bug. If a slice needs intentional behavior changes, split them out and route through planner/builder/TDD.

Entry protocol

Installs
1
GitHub Stars
8
First Seen
Jun 22, 2026
cmd-internal-refactor — trebuchetdynamics/gormes-agent