About

Imported from GuiMiran/guido-sdd-migration-effort-scale (skills/SKILL.md). Install upstream with npx skills add GuiMiran/guido-sdd-migration-effort-scale --skill skills. Copyright stays with the author.

GUIDO Scale Skill

Name: guido-scale
Author: GuiMiran

A Maturity and Migration Effort Model for Specification-Driven Development in AI-Agentic Software Engineering. Author: Guido Miranda Mercado · Version 1.0 · 2026

The GUIDO Scale answers the question no existing framework does:

"How ready are we to transition to Specification-Driven Development, and how difficult will that migration be?"

CMMI measures process capability. DevOps maturity models measure delivery performance. The GUIDO Scale measures transformation effort toward AI-native engineering — a dimension that did not exist before SDD.

The dual-dimension approach

Every existing maturity model measures only ONE dimension: current process quality. The GUIDO Scale measures TWO simultaneously:

Dimension	What it measures
Organizational maturity	Current state of process discipline, documentation, governance, automation, and cultural readiness
Migration effort	How hard it is to move from the current state to SDD-Native (G5)

These two dimensions are inversely correlated but not identical. An organization can have moderate maturity (G3) with low effort if their documentation is strong. A high-maturity org (G4) can still have cultural resistance that raises effort. The GUIDO Scale captures both.

The three conceptual foundations

Before assessing any organization, internalize these three principles:

1. Documentation as a strategic asset

In AI-driven development, structured specifications become the primary source of truth. Organizations with stronger documentation practices have significantly lower migration effort. This is why Spectra (the spec framework) pairs naturally with GUIDO Scale assessment.

2. AI amplifies existing process quality

AI does not fix broken processes — it makes them faster. A chaotic organization (G1) that adopts AI agents gets chaotic automation. A mature organization (G4) that adopts AI agents gets powerful leverage. The GUIDO Scale makes this visible before the investment.

3. Migration requires cultural transformation

Adopting SDD involves not only technological changes but shifts in roles, governance models, and engineering mindset. Technical readiness is necessary but not sufficient. The Scale explicitly accounts for cultural readiness as a dimension.

The five GUIDO levels

G1 — Chaotic State

Migration effort: Very High

Characteristics:

Minimal or no documentation
Reactive processes — firefighting mode
High dependency on individual knowledge (key-person risk)
No standardized workflows
No governance structures

What this means for SDD migration: The organization must build documentation culture, process discipline, and governance from scratch before any meaningful SDD adoption. AI agents at G1 produce chaotic automation — faster failures, not faster delivery.

Recommended first move: stabilize documentation practices before touching AI tooling.

G2 — Initial Directed State

Migration effort: High

Characteristics:

Project-level documentation (exists but inconsistent)
Emerging governance structures
Partial process adoption — some teams follow standards, others don't
Inconsistent engineering methodologies across the organization

What this means for SDD migration: Migration is possible but requires substantial process formalization first. The main risk is that SDD adoption happens in isolated pockets without organizational alignment, creating fragmented spec quality.

Recommended first move: standardize documentation format and establish cross-team spec review processes.

G3 — Defined Standards State

Migration effort: Moderate

Characteristics:

Organization-wide process standards defined and followed
Structured documentation practices in place
Consistent development methodologies across teams
Engineering culture exists but is not metrics-driven

What this means for SDD migration: Organizations at G3 are well positioned for SDD adoption. The foundation (standards + documentation + consistency) is in place. The gap is moving from documentation-as-artifact to documentation-as-source-of-truth.

Recommended first move: introduce Spectra framework on one pilot project. Measure reconstruction success. Scale from there.

G4 — Quantitatively Managed State

Migration effort: Low

Characteristics:

Metrics-driven process management
Advanced automation pipelines (CI/CD, testing, quality gates)
Strong governance and compliance controls
Data-informed engineering decisions

What this means for SDD migration: AI-agent integration becomes highly efficient at G4. The organization already measures quality — now it can connect those metrics to spec coverage scores (SPECTRA-TRACE). The transition is evolutionary, not revolutionary.

Recommended first move: instrument existing pipelines with spec-coverage metrics. Connect SPECTRA-TRACE to existing dashboards.

G5 — SDD-Native State

Migration effort: Minimal

Characteristics:

Specification-centric workflows as the default mode
Fully integrated AI orchestration — agents operate on specs autonomously
Continuous specification evolution — specs update as domain changes
High adaptability and organizational resilience
AI-native engineering as standard practice

What this means: G5 is the target state. Organizations here operate with the full Spectra + SDD stack. Agents build, maintain, validate, and evolve systems from specs. SPECTRA-TRACE runs automatically. GUIDO Scale level is maintained through continuous self-assessment.

What the GUIDO Scale measures — the 6 dimensions

Assess each dimension independently, then derive the overall level:

Dimension	G1	G2	G3	G4	G5
Process discipline	None	Partial	Org-wide	Metrics-driven	Spec-driven
Documentation maturity	None	Project-level	Structured	Quantified	Source of truth
Governance	None	Emerging	Defined	Strong controls	AI governance
Automation	None	Basic	Consistent	Advanced CI/CD	Agent-orchestrated
Cultural readiness	Resistant	Unaware	Open	Engaged	Native
Migration complexity	Very High	High	Moderate	Low	Minimal

The overall GUIDO level is the lowest dimension that consistently applies. A single weak dimension pulls the entire level down. This is intentional — the bottleneck dimension determines real migration effort.

How to perform a GUIDO Scale assessment

Step 1 — Collect evidence per dimension

For each of the 6 dimensions, gather:

Existing documentation samples
Process artifacts (workflows, standards, runbooks)
Governance documents (policies, compliance records)
Automation inventory (CI/CD pipelines, test coverage)
Cultural indicators (team interviews, adoption of past changes)
Migration history (how long previous process changes took)

Step 2 — Score each dimension independently

Assign G1–G5 to each dimension based on the evidence. Do not average — identify the bottleneck dimension.

Step 3 — Determine the overall GUIDO level

The overall level = the bottleneck dimension level. Document why the bottleneck dimension limits the whole organization.

Step 4 — Map the migration path

For each dimension below G5, define:

What needs to change (specific gaps)
Who owns the change (role/team)
Estimated effort (weeks/months/quarters)
Success criteria (how you'll know the dimension moved up)

Step 5 — Prioritize by leverage

Not all dimensions have equal migration cost. Prioritize the dimension that unblocks the most others. Documentation maturity is often the highest-leverage starting point because it directly enables Spectra adoption.

Step 6 — Reassess after each major change

The GUIDO Scale is not a one-time assessment. Reassess after:

Major process changes
New team formation
Significant tooling changes
AI agent adoption milestones

Strategic outcomes of SDD adoption by GUIDO level

Organizations that successfully migrate to G5 gain:

Accelerated development cycles — agents build from specs without ambiguity
Improved software quality — SPECTRA-TRACE detects gaps before they become bugs
Reduced technical debt — specs are always updated before code
Enhanced regulatory compliance — regulations live in specs (Layer 03), never forgotten
Sustainable competitive advantage — the spec corpus grows with every iteration

Integration with Spectra and SDD

The GUIDO Scale is the diagnostic layer of the full ecosystem:

GUIDO Scale Assessment
  → determines readiness level (G1–G5)
  → maps effort to reach G5
  → identifies bottleneck dimensions

SDD Methodology
  → provides the working philosophy (spec first, code second)
  → activated once GUIDO assessment shows G3+ readiness

Spectra Framework
  → provides the concrete implementation of SDD
  → 13 layers, SPECTRA-TRACE, reconstructability test
  → fully activated at G3, native at G5

SPECTRA-TRACE
  → provides continuous measurement of spec coverage
  → feeds back into GUIDO level tracking
  → closes the loop: assessment → adoption → measurement → reassessment

The virtuous cycle: each successful Spectra iteration raises the GUIDO level. GUIDO level rises reduce migration effort for the next Spectra initiative. Over time, the organization converges on G5 through accumulated spec quality.

When to activate this skill

Activate GUIDO Scale when the user:

Asks "how ready are we for AI agents / SDD?"
Asks "how much effort will it take to adopt Spectra / SDD?"
Needs to build a migration roadmap toward AI-native engineering
Is planning an AI transformation strategy
Needs to assess engineering maturity for governance purposes
Asks about digital modernization or enterprise architecture readiness
Mentions CMMI, DevOps maturity, or similar frameworks in the context of AI adoption
Asks "where are we on the GUIDO Scale?"

Quick reference — assessment questions per dimension

Use these questions to quickly orient an organization's GUIDO level:

Process discipline

Do all teams follow the same engineering process? (G3+)
Is the process measured with metrics? (G4+)
Is the process spec-driven? (G5)

Documentation maturity

Does documentation exist and get maintained? (G2+)
Is there a single source of truth for every system? (G3+)
Can a new agent reconstruct the system from docs alone? (G5 — Spectra)

Governance

Are there defined policies and someone enforcing them? (G3+)
Are compliance controls automated and measured? (G4+)
Is AI agent behavior governed by specs? (G5)

Automation

Is there CI/CD? (G3+)
Are quality gates automated and metric-driven? (G4+)
Do AI agents run autonomously on specs? (G5)

Cultural readiness

Are teams open to changing how they work? (G3)
Are teams actively engaged in process improvement? (G4)
Is spec-first thinking the default instinct? (G5)

Core rules for AI agents using this skill

Never assign G5 without evidence of spec-centric workflows. G5 is rare and specific.
The bottleneck rules. One G1 dimension = G1 organization, regardless of other dimensions.
Assessment before prescription. Always assess current level before recommending tools or processes.
Effort is not linear. G1→G2 often takes longer than G3→G4 because it requires cultural change, not just tooling.
Spectra is the path from G3 to G5. For organizations at G1–G2, prepare the ground first.
Reassessment is mandatory. A GUIDO level without a date is not useful — it decays.

Resources

Repository: https://github.com/GuiMiran/guido-sdd-migration-effort-scale
Whitepaper: https://github.com/GuiMiran/guido-sdd-migration-effort-scale/blob/main/whitepaper/GUIDO-Scale-Whitepaper.md
Spectra framework: https://github.com/GuiMiran/spectra
Assessment tools: https://github.com/GuiMiran/guido-sdd-migration-effort-scale/tree/main/assessment

Citation

Miranda, G. (2026). The GUIDO Scale: A Maturity and Migration Effort Model for Specification-Driven Development. GitHub Repository. https://github.com/GuiMiran/guido-sdd-migration-effort-scale

Licensed under CC BY 4.0 — free to use, share and adapt with attribution. Created by Guido Miranda Mercado · Senior Quality Engineering Leader AI-Driven Software Quality Strategist

Use it

Copy one of these into your project. Installing also returns the manifest and these snippets.

yaml

targets:
  - https://api.opensmartroute.ai/api/v1/registry/guimiran-guido-sdd-migration-effort-scale-skills/manifest   # or paste the manifest below

Manifest

An Open Capability Manifest: the router reads it to know what this does, what it costs and when to pick it.

guimiran-guido-sdd-migration-effort-scale-skills.ocm.jsonjson

{
  "ocm": "1",
  "id": "guimiran-guido-sdd-migration-effort-scale-skills",
  "kind": "skill",
  "name": "guido-scale",
  "description": "The GUIDO Scale is a unified maturity and migration effort framework that measures both organizational readiness and the effort required to migrate toward Specification-Driven Development (SDD) in AI-agentic software engineering environments. It fills the gap that CMMI and other models leave: they measure process maturity but not the effort of transforming toward AI-native engineering.",
  "publisher": "GuiMiran",
  "version": "1.0.0",
  "capabilities": {
    "domains": [
      "general"
    ],
    "tags": [
      "skill-md",
      "maturity-model",
      "sdd",
      "spec-driven-development",
      "ai-engineering",
      "migration-effort",
      "qa-engineering",
      "organizational-readiness",
      "agentic-ai",
      "github"
    ],
    "languages": [
      "en"
    ]
  },
  "quality_prior": 0.6,
  "examples": [
    "The GUIDO Scale is a unified maturity and migration effort framework that measures both organizational readiness and the effort required to migrate toward Specification-Driven Development (SDD) in AI-agentic software engineering environments. It fills the gap that CMMI and other models leave: they measure process maturity but not the effort of transforming toward AI-native engineering."
  ],
  "primary": false,
  "metadata": {
    "source": {
      "provider": "github",
      "repository": "https://github.com/GuiMiran/guido-sdd-migration-effort-scale",
      "path": "skills/SKILL.md",
      "ref": "b94906e7e9edc3cf51b0462d7388c373686229f4",
      "url": "https://github.com/GuiMiran/guido-sdd-migration-effort-scale/blob/b94906e7e9edc3cf51b0462d7388c373686229f4/skills/SKILL.md",
      "key": "GuiMiran/guido-sdd-migration-effort-scale/skills/SKILL.md"
    }
  },
  "instructions": "# GUIDO Scale Skill\n\n> A Maturity and Migration Effort Model for Specification-Driven Development\n> in AI-Agentic Software Engineering.\n> Author: Guido Miranda Mercado · Version 1.0 · 2026\n\nThe GUIDO Scale answers the question no existing framework does:\n\n> **\"How ready are we to transition to Specification-Driven Development,\n> and how difficult will that migration be?\"**\n\nCMMI measures process capability. DevOps maturity models measure delivery\nperformance. The GUIDO Scale measures **transformation effort toward AI-native\nengineering** — a dimension that did not exist before SDD.\n\n---\n\n## Th",
  "cost": {
    "context_tokens": 3131
  }
}

Fetch it by URL: GET /api/v1/registry/guimiran-guido-sdd-migration-effort-scale-skills/manifest?version=1.0.0

Reviews

Star ratings from people who tried it. One review per account; edit yours any time.

No reviews yet. Install it, try it, and be the first to rate it.