Agent skill · software engineering · nexu-io

rewrite-plan

Author a long-running multi-file rewrite plan that subsequent patch-edit + diff-review + build-test stages will execute, with explicit ownership boundaries and patch-safety guarantees.

Why this skill is useful

Adds a comprehensive multi-file rewrite plan generation script that ensures patch-safety and ownership classification, which the AI cannot generate on its own.

What it needs

Requires node installed locally. About 1k tokens when loaded. Last updated 2026-08-07. 84,236 stars on the source repository.

What this skill does

Rewrite plan Spec §20.3 / §21.3.2: scenario 4 (design → deliverable production code) requires a contract-shaped rewrite plan before the agent starts editing files. The plan is the audit trail every subsequent stage references; without it the patch path slides into "refactor everything that looks wrong" and the build breaks in unreviewable ways. Inputs code/index.json from code-import. token-map/.json from token-map. The active design system DESIGN.md (already in prompt). The user's tune intent (typically a short brief). Output steps.json is the input patch-edit reads one entry per iteration. ownership.json is the source of truth for "which files belong to a single component vs. shared infrastructure"; patch-edit refuses to touch a shell-tier file unless the matching step has risk: 'high' and the user explicitly confirmed. Convergence The atom completes when plan.md is non-empty AND steps.json contains at least one step. Anti-patterns the prompt fragment forbids Plans that include "rewrite the whole component library" as a single step. Break into per-component steps. Plans that don't classify ownership. Plans that don't list a build-test step at the end. Status Implemented by the daemon runner in apps/daemon/src/plugins/atoms/rewrite-plan.ts. It classifies ownership and writes plan.md, steps.json, and ownership.json.

How to use it

Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:

@skills nexu-io/rewrite-plan

View the source on GitHub

Browse the @skills marketplace