Source profileQuality 74/100

nexu-io/open-design/plugins/_official/atoms/rewrite-plan/SKILL.md

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.

Source repository stars
82,073
Declared platforms
0
Static risk flags
1
Last source update
2026-07-28
Source checked
2026-07-28

Decision brief

What it does—and where it fits

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 l…

Best for

    Not for

    • Plans that include "rewrite the whole component library" as a
    • Plans that don't classify ownership.

    Compatibility matrix

    Platform support, with evidence labels

    PlatformStatusEvidenceWhat to check
    CodexNot declaredNo explicit evidencePortability before use
    Claude CodeNot declaredNo explicit evidencePortability before use
    CursorNot declaredNo explicit evidencePortability before use
    Gemini CLINot declaredNo explicit evidencePortability before use
    Open the compatibility checker

    Installation

    Inspect first. Install second.

    The source command is displayed only when detected. A safe inspection prompt is always available so your agent can explain every action before execution.

    Source-detected install commandSource
    npx skills add https://github.com/nexu-io/open-design --skill "plugins/_official/atoms/rewrite-plan"
    Safe inspection promptEditorial

    Inspect the Agent Skill "rewrite-plan" from https://github.com/nexu-io/open-design/blob/89d6d4ef21baf80f871595abdf6f7de6e941dd44/plugins/_official/atoms/rewrite-plan/SKILL.md at commit 89d6d4ef21baf80f871595abdf6f7de6e941dd44. List every install step, command, network request, credential, file read/write, external action, and rollback step. Explain whether it fits my task. Do not install or execute anything until I approve.

    Workflow

    What the source asks the agent to do

    1. 01

      Inputs

      code/index.json from code-import.

      code/index.json from code-import.token-map/.json from token-map.The active design system DESIGN.md (already in prompt).
    2. 02

      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…

      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…
    3. 03

      Convergence

      The atom completes when plan.md is non-empty AND steps.json contains at least one step.

      The atom completes when plan.md is non-empty AND steps.json contains at least one step.
    4. 04

      Anti-patterns the prompt fragment forbids

      Plans that include "rewrite the whole component library" as a

      Plans that include "rewrite the whole component library" as aPlans that don't classify ownership.Plans that don't list a build-test step at the end.

    Permission review

    Static risk signals and limitations

    Writes files

    medium · line 31

    The documentation asks the agent to create, modify, or delete local files.

    `patch-edit` refuses to touch a `shell`-tier file unless the

    Evidence record

    Why each signal appears

    EvidenceSourceComputedTestedEditorial
    SignalValueEvidence typeMeaning
    Quality score74/100ComputedDocumentation, specificity, maintenance, and trust rules
    Repository stars82,073SourceRepository attention, not individual Skill quality
    Compatibility0 platformsSourceDeclared in the catalog source record
    Usage guideautomated source guideEditorialGenerated or reviewed according to the visible evidence level

    Pinned source

    Provenance and original SKILL.md

    Repository
    nexu-io/open-design
    Skill path
    plugins/_official/atoms/rewrite-plan/SKILL.md
    Commit
    89d6d4ef21baf80f871595abdf6f7de6e941dd44
    License
    Apache-2.0
    Collected
    2026-07-28
    Default branch
    main
    View the original SKILL.md

    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

    project-cwd/
    └── plan/
        ├── plan.md           # human-readable narrative
        ├── ownership.json    # { file: '...', layer: 'leaf' | 'shared' | 'route' | 'shell' }
        ├── steps.json        # ordered { id, files[], rationale, risk: 'low' | 'medium' | 'high' }[]
        └── meta.json         # { generatedAt, atomDigest, tokenMapDigest }
    

    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.

    Alternatives

    Compare before choosing