scaffold-upgrade

Upgrade harness control-plane configurations without overwriting project state.

3|Updated Jun 10, 2026
One-click install
npx skills add https://github.com/cwijayasundara/claude_harness_eng_v5 --skill scaffold-upgrade
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: scaffold-upgrade
Source: https://github.com/cwijayasundara/claude_harness_eng_v5/tree/main/.claude/skills/scaffold-upgrade
Command: npx skills add https://github.com/cwijayasundara/claude_harness_eng_v5 --skill scaffold-upgrade

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill allows for the upgrade of harness control-plane files without overwriting project state, ensuring seamless updates.

Core Features & Use Cases

  • Non-Destructive Upgrade: Safely update hooks, scripts, and git-hooks without affecting project-manifest.json or .claude/state/.
  • Selective Application: Apply changes to specific profiles (core, full, brownfield) based on project requirements.
  • Quick Dry-Run: Perform a dry-run to review changes before applying them.

Quick Start

Run the scaffold-upgrade skill with the dry-run flag to preview changes without applying them:

/scaffold-upgrade --target /path/to/project --profile core --dry-run

Frequently Asked Questions about scaffold-upgrade

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I upgrade harness control-plane configurations without disrupting project state?

To upgrade harness control-plane configurations without state disruption, use a non-destructive upgrade process that updates hooks and scripts while preserving the project-manifest.json and .claude/state/ files.

Can I preview configuration updates before applying them to a monorepo?

Yes, you can preview configuration updates by performing a dry-run. This allows you to review all script and hook changes across your monorepo before any actual modifications are applied to the project.

How do I apply control-plane updates to specific project profiles like core or brownfield?

You can apply control-plane updates selectively by specifying a target profile such as core, full, or brownfield. This selective application ensures changes match your specific project requirements.

What files are protected during a harness control-plane upgrade?

During a harness control-plane upgrade, your project-manifest.json and the .claude/state/ directory are protected from being overwritten, ensuring your existing project state remains fully intact.

When do I need to run a scaffold upgrade for my project?

You need to run a scaffold upgrade when updating your harness monorepo version. It focuses on safely migrating configuration files and scripts to the new version without losing your current project setup.