agentblueprint 0.6.26 → 0.6.28

package/dist/renderers.d.ts

@@ -9,7 +9,6 @@ export interface SkillRenderInput {
     organizationName?: string;
     blueprintData: Record<string, unknown>;
     businessCaseData?: Record<string, unknown>;
-    implementationPlanData?: Record<string, unknown>;
     useCaseData?: Record<string, unknown>;
     businessProfileData?: Record<string, unknown>;
     generalGuide?: string;

package/dist/renderers.js

@@ -189,106 +189,67 @@ function buildSkillBody(input) {
     });
     lines.push('');
     lines.push('> Full agent specifications in `references/agent-specifications.md`', '');
-    // Phase rendering — prefer implementation plan epics when available
-    const ipEpics = input.implementationPlanData ? arr(rec(input.implementationPlanData).epics) : [];
-    if (ipEpics.length > 0) {
-        const pilotEpics = ipEpics.filter((e) => str(rec(e).phase).toLowerCase().includes('pilot'));
-        const fullEpics = ipEpics.filter((e) => !str(rec(e).phase).toLowerCase().includes('pilot'));
-        lines.push('## Phase 1: Pilot', '');
-        if (pilotEpics.length > 0) {
-            const seen = new Set();
-            for (const epic of pilotEpics) {
-                const e = rec(epic);
-                const name = str(e.name);
-                if (name && !seen.has(name)) {
-                    seen.add(name);
-                    lines.push(`- **${name}**${str(e.estimatedDuration) ? ` (${str(e.estimatedDuration)})` : ''}`);
-                }
+    // Phase rendering — always uses blueprint phases
+    lines.push('## Phase 1: Pilot', '');
+    const phases = arr(bp.phases);
+    const pilotPhase = phases.find((p) => str(p?.name).toLowerCase().includes('pilot') || str(p?.name).toLowerCase().includes('phase 1'));
+    if (pilotPhase) {
+        const p = rec(pilotPhase);
+        if (str(p.phaseGoal))
+            lines.push(`**Goal:** ${str(p.phaseGoal)}`, '');
+        if (p.durationWeeks)
+            lines.push(`**Duration:** ${p.durationWeeks} weeks`);
+        if (str(p.phaseCost))
+            lines.push(`**Cost target:** ${str(p.phaseCost)}`);
+        lines.push('');
+        const workstreams = arr(p.workstreams);
+        if (workstreams.length > 0) {
+            lines.push('**Pilot workstreams:**', '');
+            for (const ws of workstreams) {
+                const w = rec(ws);
+                lines.push(`- ${str(w.title)}`);
             }
             lines.push('');
         }
-        else {
-            lines.push('_No pilot epics defined. See `references/implementation-roadmap.md` for phasing._', '');
-        }
-        lines.push('## Phase 2: Full Implementation', '');
-        if (fullEpics.length > 0) {
-            const seen = new Set();
-            for (const epic of fullEpics) {
-                const e = rec(epic);
-                const name = str(e.name);
-                if (name && !seen.has(name)) {
-                    seen.add(name);
-                    lines.push(`- **${name}**${str(e.estimatedDuration) ? ` (${str(e.estimatedDuration)})` : ''}`);
-                }
+        const gate = rec(p.decisionGate);
+        if (gate.criteria) {
+            lines.push('**Decision gate criteria:**', '');
+            for (const c of arr(gate.criteria)) {
+                const cr = rec(c);
+                const label = str(cr.name) || str(cr.criterion) || str(cr.metric) || str(cr.description) || 'Unnamed criterion';
+                lines.push(`- ${label}: ${str(cr.target) || str(cr.threshold)}`);
             }
             lines.push('');
         }
-        else {
-            lines.push('_See `references/implementation-roadmap.md` for full rollout plan._', '');
+        const exitCriteria = arr(p.exitCriteria);
+        if (exitCriteria.length > 0) {
+            lines.push('**Exit criteria:**', '');
+            for (const c of exitCriteria)
+                lines.push(`- ${c}`);
+            lines.push('');
         }
     }
     else {
-        lines.push('## Phase 1: Pilot', '');
-        const phases = arr(bp.phases);
-        const pilotPhase = phases.find((p) => str(p?.name).toLowerCase().includes('pilot') || str(p?.name).toLowerCase().includes('phase 1'));
-        if (pilotPhase) {
-            const p = rec(pilotPhase);
+        lines.push('_No pilot phase defined._', '');
+    }
+    lines.push('## Phase 2: Full Implementation', '');
+    const fullPhases = phases.filter((p) => !str(p?.name).toLowerCase().includes('pilot') && !str(p?.name).toLowerCase().includes('phase 1'));
+    if (fullPhases.length > 0) {
+        for (const phase of fullPhases) {
+            const p = rec(phase);
+            lines.push(`### ${str(p.name)}`, '');
             if (str(p.phaseGoal))
-                lines.push(`**Goal:** ${str(p.phaseGoal)}`, '');
+                lines.push(str(p.phaseGoal), '');
             if (p.durationWeeks)
                 lines.push(`**Duration:** ${p.durationWeeks} weeks`);
             if (str(p.phaseCost))
-                lines.push(`**Cost target:** ${str(p.phaseCost)}`);
+                lines.push(`**Cost:** ${str(p.phaseCost)}`);
             lines.push('');
-            const workstreams = arr(p.workstreams);
-            if (workstreams.length > 0) {
-                lines.push('**Pilot workstreams:**', '');
-                for (const ws of workstreams) {
-                    const w = rec(ws);
-                    lines.push(`- ${str(w.title)}`);
-                }
-                lines.push('');
-            }
-            const gate = rec(p.decisionGate);
-            if (gate.criteria) {
-                lines.push('**Decision gate criteria:**', '');
-                for (const c of arr(gate.criteria)) {
-                    const cr = rec(c);
-                    const label = str(cr.name) || str(cr.criterion) || str(cr.metric) || str(cr.description) || 'Unnamed criterion';
-                    lines.push(`- ${label}: ${str(cr.target) || str(cr.threshold)}`);
-                }
-                lines.push('');
-            }
-            const exitCriteria = arr(p.exitCriteria);
-            if (exitCriteria.length > 0) {
-                lines.push('**Exit criteria:**', '');
-                for (const c of exitCriteria)
-                    lines.push(`- ${c}`);
-                lines.push('');
-            }
-        }
-        else {
-            lines.push('_No pilot phase defined. See `references/implementation-roadmap.md` for phasing._', '');
-        }
-        lines.push('## Phase 2: Full Implementation', '');
-        const fullPhases = phases.filter((p) => !str(p?.name).toLowerCase().includes('pilot') && !str(p?.name).toLowerCase().includes('phase 1'));
-        if (fullPhases.length > 0) {
-            for (const phase of fullPhases) {
-                const p = rec(phase);
-                lines.push(`### ${str(p.name)}`, '');
-                if (str(p.phaseGoal))
-                    lines.push(str(p.phaseGoal), '');
-                if (p.durationWeeks)
-                    lines.push(`**Duration:** ${p.durationWeeks} weeks`);
-                if (str(p.phaseCost))
-                    lines.push(`**Cost:** ${str(p.phaseCost)}`);
-                lines.push('');
-            }
-        }
-        else {
-            lines.push('_See `references/implementation-roadmap.md` for full rollout plan._', '');
         }
     }
+    else {
+        lines.push('_No full rollout phases defined._', '');
+    }
     // Financial Summary
     lines.push('## Financial Summary', '');
     if (bc) {
@@ -949,126 +910,6 @@ function buildFinancialCase(input) {
     }
     return lines.join('\n');
 }
-function buildImplementationRoadmap(input) {
-    const ip = input.implementationPlanData;
-    const lines = ['# Implementation Roadmap', ''];
-    if (!ip) {
-        lines.push('_No implementation plan data available. Generate an Implementation Plan to enrich this section._', '');
-        return lines.join('\n');
-    }
-    const overview = rec(ip.projectOverview);
-    if (str(overview.projectName)) {
-        lines.push(`## ${str(overview.projectName)}`, '');
-    }
-    if (str(overview.executiveSummary)) {
-        lines.push(str(overview.executiveSummary), '');
-    }
-    if (str(overview.scope)) {
-        lines.push('### Scope', '', str(overview.scope), '');
-    }
-    const assumptions = arr(overview.assumptions);
-    if (assumptions.length > 0) {
-        lines.push('### Assumptions', '');
-        for (const a of assumptions)
-            lines.push(`- ${a}`);
-        lines.push('');
-    }
-    const epics = arr(ip.epics);
-    if (epics.length > 0) {
-        lines.push('## Epics', '');
-        for (const epic of epics) {
-            const e = rec(epic);
-            lines.push(`### ${str(e.name)}`, '');
-            if (str(e.description))
-                lines.push(str(e.description), '');
-            lines.push(`- **Phase:** ${str(e.phase)}`);
-            lines.push(`- **Priority:** ${str(e.priority)}`);
-            if (str(e.estimatedDuration))
-                lines.push(`- **Duration:** ${str(e.estimatedDuration)}`);
-            if (str(e.businessValue))
-                lines.push(`- **Business value:** ${str(e.businessValue)}`);
-            lines.push('');
-            const ac = arr(e.acceptanceCriteria);
-            if (ac.length > 0) {
-                lines.push('**Acceptance criteria:**', '');
-                for (const c of ac)
-                    lines.push(`- [ ] ${c}`);
-                lines.push('');
-            }
-            const stories = arr(e.stories);
-            if (stories.length > 0) {
-                lines.push('**User stories:**', '');
-                for (const story of stories) {
-                    const s = rec(story);
-                    const userStory = `As ${str(s.asA)}, I want ${str(s.iWant)}, so that ${str(s.soThat)}`;
-                    lines.push(`- **${str(s.title)}**: ${userStory}`);
-                    if (str(s.estimatedEffort))
-                        lines.push(`  - Effort: ${str(s.estimatedEffort)}`);
-                }
-                lines.push('');
-            }
-            const deps = arr(e.dependencies);
-            if (deps.length > 0) {
-                lines.push('**Dependencies:**', '');
-                for (const d of deps)
-                    lines.push(`- ${d}`);
-                lines.push('');
-            }
-        }
-    }
-    const agentSpecs = arr(ip.agentSpecifications);
-    if (agentSpecs.length > 0) {
-        lines.push('## Agent Build Specifications', '');
-        for (const spec of agentSpecs) {
-            const s = rec(spec);
-            lines.push(`### ${str(s.name)}`, '');
-            if (str(s.role))
-                lines.push(str(s.role), '');
-            if (str(s.instructions))
-                lines.push('**Instructions:**', '', str(s.instructions), '');
-            if (str(s.linkedStoryId))
-                lines.push(`_Linked to story: ${str(s.linkedStoryId)}_`, '');
-        }
-    }
-    const resources = rec(ip.resources);
-    const timeline = rec(resources.timeline);
-    if (str(timeline.totalDuration)) {
-        lines.push('## Timeline', '');
-        lines.push(`**Total duration:** ${str(timeline.totalDuration)}`, '');
-        const timelinePhases = arr(timeline.phases);
-        if (timelinePhases.length > 0) {
-            for (const phase of timelinePhases) {
-                const p = rec(phase);
-                lines.push(`### ${str(p.name)} (${str(p.duration)})`, '');
-                for (const m of arr(p.milestones))
-                    lines.push(`- ${m}`);
-                lines.push('');
-            }
-        }
-    }
-    const roles = arr(resources.roles);
-    if (roles.length > 0) {
-        lines.push('## Required Roles', '');
-        lines.push('| Role | Allocation | Duration | Key Skills |');
-        lines.push('|------|-----------|----------|------------|');
-        for (const role of roles) {
-            const r = rec(role);
-            const skills = arr(r.skillsRequired).slice(0, 3).join(', ');
-            lines.push(`| ${str(r.role)} | ${str(r.allocation)} | ${str(r.duration)} | ${skills} |`);
-        }
-        lines.push('');
-    }
-    const deps = arr(ip.dependencies);
-    if (deps.length > 0) {
-        lines.push('## Dependencies', '');
-        for (const dep of deps) {
-            const d = rec(dep);
-            lines.push(`- **${str(d.type)}** (${str(d.criticality)}): ${str(d.description)}`);
-        }
-        lines.push('');
-    }
-    return lines.join('\n');
-}
 function buildArchitectureDecisions(input) {
     const bp = input.blueprintData;
     const lines = ['# Architecture Decisions', ''];
@@ -1438,54 +1279,10 @@ function buildRecommendations(input) {
     const bp = rec(input.blueprintData);
     const team = arr(bp.enhancedDigitalTeam);
     const bc = rec(input.businessCaseData);
-    // Build epic lookup for priority ordering
-    const epics = arr(rec(input.implementationPlanData).epics);
-    const epicByNormalizedName = new Map();
-    for (const e of epics) {
-        const epic = rec(e);
-        const name = str(epic.name).toLowerCase().trim();
-        epicByNormalizedName.set(name, {
-            phase: str(epic.phase),
-            priority: str(epic.priority) || 'P2',
-            dependencies: arr(epic.dependencies).map((d) => typeof d === 'string' ? d : str(rec(d).description) || str(d)),
-        });
-    }
-    // Helper to find the best-matching epic for an agent
-    function findEpicForAgent(agentName) {
-        const norm = agentName.toLowerCase().trim();
-        // Direct match
-        for (const [epicName, epic] of epicByNormalizedName) {
-            if (epicName.includes(norm) || norm.includes(epicName))
-                return epic;
-        }
-        // Word overlap
-        const agentWords = norm.split(/\s+/).filter(w => w.length > 2);
-        for (const [epicName, epic] of epicByNormalizedName) {
-            for (const word of agentWords) {
-                if (epicName.includes(word))
-                    return epic;
-            }
-        }
-        return undefined;
-    }
-    // Priority sort key: P0=0, P1=1, P2=2, unknown=3
-    function priorityKey(p) {
-        if (p === 'P0')
-            return 0;
-        if (p === 'P1')
-            return 1;
-        if (p === 'P2')
-            return 2;
-        return 3;
-    }
     // --- Section 1: Unimplemented agents ---
     if (hasImplementationData(input)) {
         const sd = rec(input.implementationState.stateData);
         const stateAgents = arr(sd.agents);
-        const implementedNames = new Set(stateAgents
-            .map((a) => rec(a))
-            .filter(a => str(a.status) === 'implemented' || str(a.status) === 'modified')
-            .map(a => str(a.name).toLowerCase().trim()));
         const unimplemented = [];
         for (const sa of stateAgents) {
             const a = rec(sa);
@@ -1495,20 +1292,8 @@ function buildRecommendations(input) {
             const name = str(a.name);
             const bpAgent = team.find((t) => str(rec(t).name).toLowerCase().trim() === name.toLowerCase().trim());
             const role = bpAgent ? str(rec(bpAgent).role) || str(rec(bpAgent).agentRole) : '-';
-            const epic = findEpicForAgent(name);
-            const phase = epic?.phase || '-';
-            const priority = epic?.priority || '-';
-            unimplemented.push({
-                name,
-                role,
-                status,
-                phase,
-                priority,
-                priorityNum: priorityKey(priority),
-            });
+            unimplemented.push({ name, role, status });
         }
-        // Sort by roadmap priority
-        unimplemented.sort((a, b) => a.priorityNum - b.priorityNum);
         if (unimplemented.length > 0) {
             lines.push('## Next Agents to Implement', '');
             for (const agent of unimplemented) {
@@ -1516,8 +1301,6 @@ function buildRecommendations(input) {
                 const statusLabel = agent.status === 'in_progress' ? ' (in progress)' : '';
                 lines.push(`### ${recNum}. ${agent.status === 'in_progress' ? 'Continue' : 'Implement'} ${agent.name}${statusLabel}`, '');
                 lines.push(`Role: ${agent.role}`);
-                if (agent.phase !== '-')
-                    lines.push(`Roadmap phase: ${agent.phase} | Priority: ${agent.priority}`);
                 lines.push(`Read agent spec in \`references/agent-specifications.md\`.`, '');
             }
         }
@@ -1843,7 +1626,7 @@ function buildGettingStartedReturnVisit(input) {
     lines.push('## Step 2: Follow recommendations');
     lines.push('');
     lines.push('Read `RECOMMENDATIONS.md` for prioritized next actions:');
-    lines.push('- Agents to implement next (ordered by roadmap priority)');
+    lines.push('- Agents to implement next');
     lines.push('- Metrics that need attention (deviations from targets)');
     lines.push('- Deviations from spec that warrant review');
     lines.push('');
@@ -1976,7 +1759,6 @@ function buildGettingStarted(input) {
     lines.push('');
     lines.push('- `references/agent-specifications.md` -- detailed agent team design (start here)');
     lines.push('- `references/architecture-decisions.md` -- platform rationale and integration gaps');
-    lines.push('- `references/implementation-roadmap.md` -- phased rollout plan with epics and stories');
     lines.push('- `references/guardrails-and-governance.md` -- risk controls and escalation rules');
     lines.push('');
     // Step 2
@@ -2039,7 +1821,7 @@ function buildGettingStarted(input) {
     // Step 3
     lines.push('## Step 3: Build and validate the pilot');
     lines.push('');
-    lines.push('Check `references/implementation-roadmap.md` for Phase 1 scope.');
+    lines.push('Check the Phase 1 section in `SKILL.md` for pilot scope.');
     lines.push('Build the lead agent first. **Do not expand to remaining agents until the');
     lines.push('pilot is fully working with real data.** This is a gate, not a suggestion.');
     lines.push('');
@@ -2245,7 +2027,7 @@ echo "--- Optional Files ---"
 check_optional "references/business-context.md"
 check_optional "references/organization-context.md"
 check_optional "references/financial-case.md"
-check_optional "references/implementation-roadmap.md"
+
 check_optional "references/guardrails-and-governance.md"
 check_optional "references/evaluation-criteria.md"
 check_optional "references/platform-connectivity.md"
@@ -2350,6 +2132,11 @@ function buildPlatformConnectivity() {
 // IMPLEMENTATION STATE TEMPLATE
 // =============================================================================
 function buildImplementationState(input) {
+    // If synced state exists with real progress, pre-populate from it
+    if (hasImplementationData(input)) {
+        return buildPopulatedImplementationState(input);
+    }
+    // First download: generate blank template from blueprint
     const bp = input.blueprintData;
     const team = getTeam(bp);
     const pattern = getAgenticPattern(bp);
@@ -2441,6 +2228,165 @@ function buildImplementationState(input) {
     }
     return lines.join('\n') + '\n';
 }
+// Helper to escape a string for YAML double-quoted values
+function yamlEscape(value) {
+    return value.replace(/\\/g, '\\\\').replace(/"/g, '\\"');
+}
+// Render a YAML string array inline, e.g. ["a", "b"] or []
+function yamlStringArray(items, indent) {
+    if (items.length === 0)
+        return '[]';
+    // Multi-line for readability
+    return '\n' + items.map(item => `${indent}  - "${yamlEscape(item)}"`).join('\n');
+}
+function buildPopulatedImplementationState(input) {
+    const state = input.implementationState;
+    const sd = rec(state.stateData);
+    const bp = input.blueprintData;
+    const team = getTeam(bp);
+    const pattern = getAgenticPattern(bp);
+    const lines = [];
+    // Header
+    lines.push('# implementation-state.yaml');
+    lines.push('# Pre-populated from last sync. Update and re-sync as implementation progresses.');
+    lines.push(`# Sync back to Agent Blueprint: agentblueprint sync --blueprint ${input.blueprintId}`);
+    lines.push('');
+    lines.push(`schema_version: "${str(sd.schema_version) || '1.0'}"`);
+    lines.push(`blueprint_id: "${input.blueprintId}"`);
+    lines.push(`last_updated: "${str(sd.last_updated)}"`);
+    lines.push('');
+    lines.push(`overall_status: ${str(sd.overall_status) || 'not_started'}  # not_started | in_progress | partial | complete`);
+    lines.push('');
+    // Platform
+    const plat = rec(sd.platform);
+    lines.push('platform:');
+    lines.push(`  name: "${yamlEscape(str(plat.name))}"`);
+    lines.push(`  version: "${yamlEscape(str(plat.version))}"`);
+    lines.push(`  environment: "${yamlEscape(str(plat.environment))}"`);
+    lines.push('');
+    // Build lookup of synced agents by lowercase name
+    const stateAgents = arr(sd.agents);
+    const stateAgentsByName = new Map();
+    for (const sa of stateAgents) {
+        const a = rec(sa);
+        const name = str(a.name).toLowerCase().trim();
+        if (name)
+            stateAgentsByName.set(name, a);
+    }
+    // Build lookup of blueprint agents by lowercase name for role/tools hints
+    const bpAgentsByName = new Map();
+    for (const ta of team) {
+        const a = ta;
+        const name = str(a.name).toLowerCase().trim();
+        if (name)
+            bpAgentsByName.set(name, a);
+    }
+    // Merge: start with synced agents, then add any blueprint agents not in state
+    const seenNames = new Set();
+    const mergedAgents = [];
+    for (const sa of stateAgents) {
+        const a = rec(sa);
+        const name = str(a.name).toLowerCase().trim();
+        seenNames.add(name);
+        mergedAgents.push({ stateAgent: a, bpAgent: bpAgentsByName.get(name) || null });
+    }
+    for (const ta of team) {
+        const a = ta;
+        const name = str(a.name).toLowerCase().trim();
+        if (!seenNames.has(name)) {
+            seenNames.add(name);
+            mergedAgents.push({ stateAgent: null, bpAgent: a });
+        }
+    }
+    // Agents
+    if (mergedAgents.length === 0) {
+        lines.push('agents: []');
+    }
+    else {
+        lines.push('agents:');
+        for (let i = 0; i < mergedAgents.length; i++) {
+            const { stateAgent, bpAgent } = mergedAgents[i];
+            // Name from state or blueprint
+            const name = stateAgent ? str(stateAgent.name) : str(bpAgent.name);
+            const escapedName = yamlEscape(name);
+            // Role/tools hint from blueprint
+            if (bpAgent) {
+                const type = str(bpAgent.agentRole) || str(bpAgent.orchestrationRole) || str(bpAgent.type) || 'Worker';
+                const tools = arr(bpAgent.enhancedTools).map((t) => str(t.name)).filter(Boolean);
+                const toolHint = tools.length > 0 ? ` | tools: ${tools.join(', ')}` : '';
+                lines.push(`  - name: "${escapedName}"`);
+                lines.push(`    # role: ${type}${toolHint}`);
+            }
+            else {
+                lines.push(`  - name: "${escapedName}"`);
+            }
+            if (stateAgent) {
+                const status = str(stateAgent.status) || 'not_started';
+                const artifact = str(stateAgent.platform_artifact);
+                const deviations = arr(stateAgent.deviations).map((d) => str(d)).filter(Boolean);
+                const integrations = arr(stateAgent.integrations_connected).map((ic) => str(ic)).filter(Boolean);
+                const notes = str(stateAgent.notes);
+                if (i === 0) {
+                    lines.push(`    status: ${status}  # not_started | in_progress | implemented | modified | skipped`);
+                    lines.push(`    platform_artifact: "${yamlEscape(artifact)}"`);
+                }
+                else {
+                    lines.push(`    status: ${status}`);
+                    lines.push(`    platform_artifact: "${yamlEscape(artifact)}"`);
+                }
+                lines.push(`    deviations: ${yamlStringArray(deviations, '    ')}`);
+                lines.push(`    integrations_connected: ${yamlStringArray(integrations, '    ')}`);
+                lines.push(`    notes: "${yamlEscape(notes)}"`);
+            }
+            else {
+                // Blueprint agent not yet in synced state
+                if (i === 0) {
+                    lines.push('    status: not_started  # not_started | in_progress | implemented | modified | skipped');
+                    lines.push('    platform_artifact: ""');
+                }
+                else {
+                    lines.push('    status: not_started');
+                    lines.push('    platform_artifact: ""');
+                }
+                lines.push('    deviations: []');
+                lines.push('    integrations_connected: []');
+                lines.push('    notes: ""');
+            }
+            if (i < mergedAgents.length - 1)
+                lines.push('');
+        }
+    }
+    lines.push('');
+    // Architecture
+    const arch = rec(sd.architecture);
+    const archPattern = str(arch.pattern);
+    const archDeviations = arr(arch.deviations).map((d) => str(d)).filter(Boolean);
+    const archComponents = arr(arch.additional_components).map((c) => str(c)).filter(Boolean);
+    lines.push('architecture:');
+    lines.push(`  pattern: "${yamlEscape(archPattern)}"${archPattern ? '' : `        # actual pattern used (spec recommends: ${pattern})`}`);
+    lines.push(`  deviations: ${yamlStringArray(archDeviations, '  ')}`);
+    lines.push(`  additional_components: ${yamlStringArray(archComponents, '  ')}`);
+    lines.push('');
+    // Metrics observed
+    const metricsObserved = arr(sd.metrics_observed);
+    if (metricsObserved.length > 0) {
+        lines.push('metrics_observed:');
+        for (const m of metricsObserved) {
+            const mr = rec(m);
+            lines.push(`  - metric: "${yamlEscape(str(mr.metric))}"`);
+            lines.push(`    target: "${yamlEscape(str(mr.target))}"`);
+            lines.push(`    actual: "${yamlEscape(str(mr.actual))}"`);
+            lines.push(`    measured_at: "${yamlEscape(str(mr.measured_at))}"`);
+            if (str(mr.source)) {
+                lines.push(`    source: "${yamlEscape(str(mr.source))}"`);
+            }
+        }
+    }
+    else {
+        lines.push('metrics_observed: []');
+    }
+    return lines.join('\n') + '\n';
+}
 // =============================================================================
 // AGENTS.MD -- UNIVERSAL SYNC RULES
 // =============================================================================
@@ -2575,7 +2521,6 @@ export function renderSkillDirectory(input) {
     files.set('references/organization-context.md', buildOrganizationContext(input));
     files.set('references/agent-specifications.md', buildAgentSpecifications(input));
     files.set('references/financial-case.md', buildFinancialCase(input));
-    files.set('references/implementation-roadmap.md', buildImplementationRoadmap(input));
     files.set('references/architecture-decisions.md', buildArchitectureDecisions(input));
     files.set('references/guardrails-and-governance.md', buildGuardrailsAndGovernance(input));
     files.set('references/evaluation-criteria.md', buildEvaluationCriteria(input));