emiliodominguez/flow-skills

flow-simplify

Targeted cleanup of provably dead code and accidental complexity.

ソースを見る

使い方

  1. インストールコマンドをコピーし、自分の環境へ導入する前にソースを確認します。
  2. 必要なツール、認証情報、対応環境を原文で確認します。
  3. 入力と成果物を指定し、出力を資料と照合します。
npx skills add https://github.com/emiliodominguez/flow-skills --skill flow-simplify

開始前の確認

  • 導入にはモデル契約、API枠、ファイルへのアクセス許可は含まれません。
  • スター数や導入数は活動の指標であり、独立した品質・安全性試験ではありません。
リポジトリの原文

見出し、例、コード、表、リンク、参照画像を含む原文を表示しています。

Simplify

Subtract only where it improves understanding without changing required behavior. Fewer lines is a possible outcome, not the acceptance criterion.

Process

  1. Bound the cleanup, establish relevant checks and preserve unrelated staged/unstaged work.

Name the concrete complexity: dead paths, needless indirection, duplicate responsibility, stale comments or generated slop.

  1. Order reduction passes by semantic risk. For large scopes, authorized read-only reviewers can

inspect disjoint areas; one writer per file. No arbitrary agent or file-count threshold.

  1. Caller-check before deleting a symbol: imports, dynamic lookup, registries, reflection,

routes, config, templates, tests, generated sources, package exports. Repository search cannot see external consumers of a published API.

  1. Mark a deletion CONFIRMED-DEAD only with usage and runtime evidence; keep uncertain

exports or negotiate the compatibility change. Keep side-effect imports (registration, polyfills) and license, compiler and tool-directive comments.

  1. Inspect single-use abstractions instead of auto-inlining. Components, Hooks, closures and

effects carry identity, state lifetime and evaluation order even with one caller.

  1. Remove a defensive guard only when input provenance proves it redundant. Static types do not

validate network, JSON, storage, DOM or JavaScript consumers.

  1. Cut in small steps, run behavior and repository checks, inspect the combined diff. Stop when

the stated complexity is resolved.

Anti-patterns

  • Net-negative lines as a quality gate, or every single-use component as waste.
  • Removing imports, comments or guards on regex or type evidence alone.
  • Deleting a public export because internal grep finds no caller.
  • Quietly changing error behavior or component state lifetime.

Done when

  • The targeted code is easier to understand with semantics and compatibility preserved.
  • Deletions have evidence; uncertain consumers remain explicit.
  • Required checks ran on the resulting artifact, not an earlier baseline.

Use flow-review for the diff or flow-refactor for a separate ownership or structure problem.

タスクに関連する項目

同じリポジトリから

関連する Skills

すべての Skills