# Run Upgrade Repair

> Convert legacy PRD and HLD documents into current concise structures while preserving every existing decision and adding no new product or architecture content.

- Skill: `keyvaluesoftwaresystems/run-upgrade-repair` (Agent Skill)
- Install (CLI): `npx skillmds@latest add keyvaluesoftwaresystems/run-upgrade-repair`
- Raw SKILL.md: https://api.skillmd.com/api/skills/keyvaluesoftwaresystems/run-upgrade-repair/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Product & Planning
- Author: keyvaluesoftwaresystems (https://skillmd.com/u/keyvaluesoftwaresystems)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/keyvaluesoftwaresystems/run-upgrade-repair

---


# Legacy design structure conversion

Convert supplied legacy PRD and HLD artifacts to the requested current document contracts. The
source decisions are authoritative; this skill changes organization and wording only where needed
for the current validator.

## Method

1. Read the upgrade manifest, immutable legacy copies, current PRD/HLD copies, and deferred-question
   ledger.
2. Build a compact decision inventory before editing: product scope and acceptance, non-goals,
   constraints, architecture ownership and boundaries, data flow, security/failure behavior,
   migration/rollout, risks, and open questions.
3. Map every inventoried fact into exactly one current section. Keep acceptance identifiers only in
   acceptance criteria and preserve their meaning.
4. Remove only repetition, obsolete revision history, and excess explanation. Do not remove a
   unique requirement or decision merely to shorten the document; compress it when that preserves
   the complete meaning.
5. Run the supplied validators. Repair only named structural, metadata, ordering, duplication, or
   readability defects.

## Standards

- Use plain, skimmable technical English and short bullets or tables where they reduce repetition.
- Preserve every settled decision exactly in meaning, including decisions that seem unusual.
- Keep implementation-level schema/route detail in repository LLDs, not the HLD.
- Preserve explicit unknowns in the deferred-question ledger; never manufacture an answer.
- Add no migration commentary to the converted documents.

## Safety

- Edit only the supplied current PRD and HLD paths.
- Never edit immutable legacy copies, workflow state, approval receipts, source code, or LLDs.
- Stop rather than inventing content when an exact current section cannot be populated from the
  legacy documents.

## Output contract

Return `summary` with a short factual conversion and validation result. Never return document text.