spec-migrate-1.0-to-1.1

Upgrade v1.0 Project Specs to v1.1 by adding schemaVersion and idp.realmStrategy fields.

Updated May 21, 2026
One-click install
npx skills add https://github.com/furqan90/ai_mediated_platform_engineering --skill spec-migrate-1-0-to-1-1
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-migrate-1.0-to-1.1
Source: https://github.com/furqan90/ai_mediated_platform_engineering/tree/main/skills/spec-migrate-1.0-to-1.1
Command: npx skills add https://github.com/furqan90/ai_mediated_platform_engineering --skill spec-migrate-1-0-to-1-1

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Legacy v1.0 Project Specs lack required v1.1 fields (schemaVersion and idp.realmStrategy), causing processing failures when used with the latest DevEnv Agent platform engineering workflows. This skill resolves that compatibility gap automatically.

Core Features & Use Cases

  • Automatic Version Upgrade: Adds mandatory v1.1 fields to v1.0 Project Specs with no manual editing required.
  • Transparent Background Operation: Invokes automatically when the DevEnv Agent orchestrator loads an outdated spec, with no user intervention needed.
  • Use Case: If your team has existing v1.0 Project Specs for services, this skill updates them to v1.1 compliance so they work with current platform onboarding and deployment pipelines.

Quick Start

Ask the DevEnv Agent to process your existing v1.0 Project Spec, and the spec-migrate-1.0-to-1.1 skill will automatically upgrade it to v1.1 compliance.

Frequently Asked Questions about spec-migrate-1.0-to-1.1

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

FAQPage Schema
How do I upgrade a Project Spec from v1.0 to v1.1?

To upgrade a Project Spec from v1.0 to v1.1, this skill automatically adds the required schemaVersion and idp.realmStrategy fields. It ensures legacy specs become compliant with current DevEnv Agent platform engineering workflows without manual editing.

Why does my v1.0 Project Spec fail when loaded by the DevEnv Agent orchestrator?

Your v1.0 Project Spec fails because it lacks mandatory v1.1 fields, specifically schemaVersion and idp.realmStrategy. The spec-migrate skill resolves this compatibility gap automatically by injecting the missing schema requirements during the orchestrator loading process.

What is schema compliance for v1.1 Project Specs?

Schema compliance for v1.1 Project Specs requires including the schemaVersion and idp.realmStrategy fields. This ensures consistent Spec formatting across all project onboarding workflows and prevents processing failures within platform engineering pipelines.

Do I need to manually edit legacy Project Specs to add the idp.realmStrategy field?

No, you do not need to manually edit legacy Project Specs to add the idp.realmStrategy field. The skill operates transparently in the background, automatically upgrading outdated v1.0 specs to v1.1 compliance when they are processed.

Can I use existing v1.0 Project Specs with current platform onboarding pipelines?

Yes, you can use existing v1.0 Project Specs with current platform onboarding pipelines by asking the DevEnv Agent to process them. The skill automatically updates the specs to v1.1 compliance so they work seamlessly with current deployment workflows.

When should I use an automated spec migration for legacy Project Specs?

You should use automated spec migration for legacy Project Specs when your team has existing v1.0 service definitions that need to integrate with current platform engineering workflows. It applies required v1.1 mandatory fields to prevent onboarding failures.