@planu/cli 3.9.11 → 3.9.12

package/dist/engine/spec-splitter.js

@@ -289,8 +289,8 @@ export function buildChildSpecs(original, proposals, nextIdFn) {
             createdAt: now,
             updatedAt: now,
             specPath: original.specPath.replace(/\/[^/]+\/spec\.md$/, `/${childId}-${childSlug}/spec.md`),
-            technicalPath: original.technicalPath.replace(/\/[^/]+\/technical\.md$/, `/${childId}-${childSlug}/technical.md`),
-            progressPath: original.progressPath?.replace(/\/[^/]+\/progress\.md$/, `/${childId}-${childSlug}/progress.md`),
+            technicalPath: original.specPath.replace(/\/[^/]+\/spec\.md$/, `/${childId}-${childSlug}/spec.md`),
+            progressPath: undefined,
             estimation,
             actuals: null,
             target: original.target,

package/dist/engine/spec-summary-html/report-renderer.d.ts

@@ -1,9 +1,8 @@
 import type { Spec } from '../../types/index.js';
 /**
- * Regenerate executive-report.html and technical-report.html for each spec.
- * Reads actual spec.md and technical.md content to produce rich HTML reports.
- * Also generates structural reports as fallback data source.
- * Best-effort per spec — one failure doesn't block others.
+ * Per-spec HTML reports are deprecated. The unified docs site renders spec.md
+ * on demand, so this function intentionally does not write files inside
+ * planu/specs/SPEC-* directories.
  */
 export declare function regeneratePerSpecReports(specs: Spec[]): Promise<void>;
 //# sourceMappingURL=report-renderer.d.ts.map

package/dist/engine/spec-summary-html/report-renderer.js

@@ -1,139 +1,10 @@
-import { writeFile, readFile } from 'node:fs/promises';
-import { join, dirname } from 'node:path';
-import { generatePerSpecExecutiveReport, generatePerSpecTechnicalReport, } from '../doc-generator/per-spec-report/index.js';
-import { buildSpecMetricsSection, buildEffortDistributionSvg, buildSpecDependenciesSection, buildSpecTagsSection, } from '../doc-generator/per-spec-report/spec-section-builders.js';
-import { extractPerSpecData } from '../doc-generator/per-spec-report/spec-data-extractor.js';
-import { markdownToHtml } from '../markdown-renderer.js';
-const STATUS_COLORS = {
-    draft: { bg: '#e5e7eb', fg: '#374151' },
-    review: { bg: '#dbeafe', fg: '#1d4ed8' },
-    approved: { bg: '#d1fae5', fg: '#065f46' },
-    implementing: { bg: '#fef3c7', fg: '#92400e' },
-    done: { bg: '#d1fae5', fg: '#065f46' },
-    discarded: { bg: '#f3f4f6', fg: '#9ca3af' },
-};
-const REPORT_CSS = `
-  body { font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif; max-width: 900px; margin: 0 auto; padding: 24px; color: #1f2937; background: #fff; line-height: 1.6; font-size: 14px; }
-  .header { border-bottom: 3px solid #4F46E5; padding-bottom: 16px; margin-bottom: 24px; }
-  .header h1 { font-size: 1.1em; color: #6b7280; font-weight: 400; margin: 0 0 4px; }
-  .header h2 { font-size: 1.6em; color: #111827; margin: 0; }
-  .header .meta { margin-top: 8px; font-size: 0.85em; color: #6b7280; }
-  .badge { display: inline-block; padding: 2px 10px; border-radius: 12px; font-size: 0.78em; font-weight: 600; }
-  .nav { margin-bottom: 24px; }
-  .nav a { color: #4F46E5; text-decoration: none; font-size: 0.85em; }
-  .nav a:hover { text-decoration: underline; }
-  .section { margin-bottom: 28px; }
-  .section h2 { font-size: 1.15em; color: #4F46E5; border-left: 4px solid #4F46E5; padding-left: 10px; margin-bottom: 14px; }
-  .metric-grid { display: grid; grid-template-columns: repeat(auto-fit, minmax(140px, 1fr)); gap: 12px; margin-bottom: 16px; }
-  .metric-card { background: #f9fafb; border: 1px solid #e5e7eb; border-radius: 8px; padding: 14px; text-align: center; }
-  .metric-value { font-size: 1.8em; font-weight: 700; color: #4F46E5; line-height: 1; }
-  .metric-label { font-size: 0.78em; color: #6b7280; margin-top: 4px; }
-  .tags-section .tag { display: inline-block; padding: 2px 8px; border-radius: 4px; background: #ede9fe; color: #5b21b6; font-size: 0.8em; margin: 2px 4px; }
-  .md-content h1 { font-size: 1.4em; color: #111827; border-bottom: 2px solid #e5e7eb; padding-bottom: 8px; margin: 24px 0 12px; }
-  .md-content h2 { font-size: 1.2em; color: #4F46E5; border-left: 4px solid #4F46E5; padding-left: 10px; margin: 20px 0 10px; }
-  .md-content h3 { font-size: 1.05em; color: #374151; margin: 16px 0 8px; }
-  .md-content p { margin: 8px 0; }
-  .md-content ul, .md-content ol { padding-left: 24px; margin: 8px 0; }
-  .md-content li { margin: 4px 0; }
-  .md-content blockquote { border-left: 4px solid #d1d5db; padding: 8px 16px; margin: 12px 0; color: #6b7280; background: #f9fafb; border-radius: 0 6px 6px 0; }
-  .md-content code { background: #f3f4f6; padding: 1px 5px; border-radius: 3px; font-size: 0.9em; }
-  .md-content pre { background: #1f2937; color: #e5e7eb; padding: 16px; border-radius: 8px; overflow-x: auto; margin: 12px 0; }
-  .md-content pre code { background: none; color: inherit; padding: 0; }
-  .md-table { width: 100%; border-collapse: collapse; margin: 12px 0; font-size: 0.85em; }
-  .md-table th { text-align: left; padding: 8px 10px; background: #f9fafb; border-bottom: 2px solid #e5e7eb; font-weight: 600; color: #374151; }
-  .md-table td { padding: 8px 10px; border-bottom: 1px solid #f3f4f6; }
-  .md-table tr:hover { background: #f9fafb; }
-  .md-content hr { border: none; border-top: 1px solid #e5e7eb; margin: 20px 0; }
-  .md-content input[type=checkbox] { margin-right: 6px; }
-  .footer { margin-top: 32px; padding-top: 16px; border-top: 1px solid #e5e7eb; font-size: 0.78em; color: #9ca3af; text-align: center; }
-  .footer a { color: #4F46E5; text-decoration: none; }
-  @media print { body { padding: 0; } .nav { display: none; } }`;
-function escapeHtml(text) {
-    return text
-        .replace(/&/g, '&')
-        .replace(/</g, '&lt;')
-        .replace(/>/g, '&gt;')
-        .replace(/"/g, '&quot;');
-}
-function buildMetricsDashboard(spec) {
-    const data = extractPerSpecData(spec, [], []);
-    return [
-        buildSpecMetricsSection(data),
-        buildEffortDistributionSvg(data.devHours, data.reviewHours),
-        buildSpecDependenciesSection(data),
-        buildSpecTagsSection(data),
-    ]
-        .filter(Boolean)
-        .join('\n');
-}
-function buildReportHtml(spec, title, mdContent) {
-    const colors = STATUS_COLORS[spec.status] ?? { bg: '#e5e7eb', fg: '#374151' };
-    const date = new Date().toLocaleDateString('en-US', {
-        year: 'numeric',
-        month: 'long',
-        day: 'numeric',
-    });
-    const bodyHtml = markdownToHtml(mdContent);
-    const dashboard = buildMetricsDashboard(spec);
-    return `<!DOCTYPE html>
-<html lang="en">
-<head><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1.0">
-<title>${escapeHtml(title)}</title>
-<style>${REPORT_CSS}</style></head>
-<body>
-<div class="nav"><a href="../../index.html">&larr; Back to Dashboard</a></div>
-<div class="header">
-  <h1>Planu — Spec Report</h1>
-  <h2>${escapeHtml(spec.id)}: ${escapeHtml(spec.title)}</h2>
-  <div class="meta">
-    <span class="badge" style="background:${colors.bg};color:${colors.fg}">${escapeHtml(spec.status)}</span>
-    &middot; Generated ${escapeHtml(date)}
-  </div>
-</div>
-${dashboard}
-<div class="md-content">${bodyHtml}</div>
-<div class="footer">Generated by <strong>Planu</strong> — Spec Driven Development</div>
-</body></html>`;
-}
-async function readMdSafe(path) {
-    try {
-        return await readFile(path, 'utf-8');
-    }
-    catch {
-        return '';
-    }
-}
 /**
- * Regenerate executive-report.html and technical-report.html for each spec.
- * Reads actual spec.md and technical.md content to produce rich HTML reports.
- * Also generates structural reports as fallback data source.
- * Best-effort per spec — one failure doesn't block others.
+ * Per-spec HTML reports are deprecated. The unified docs site renders spec.md
+ * on demand, so this function intentionally does not write files inside
+ * planu/specs/SPEC-* directories.
  */
-export async function regeneratePerSpecReports(specs) {
-    await Promise.all(specs.map(async (spec) => {
-        if (!spec.specPath) {
-            return;
-        }
-        const specDir = dirname(spec.specPath);
-        try {
-            const [specMd, techMd] = await Promise.all([
-                readMdSafe(spec.specPath),
-                readMdSafe(spec.technicalPath),
-            ]);
-            const execHtml = specMd
-                ? buildReportHtml(spec, `Executive Report — ${spec.id}: ${spec.title}`, specMd)
-                : generatePerSpecExecutiveReport(spec, [], []).content;
-            const techHtml = techMd
-                ? buildReportHtml(spec, `Technical Report — ${spec.id}: ${spec.title}`, techMd)
-                : generatePerSpecTechnicalReport(spec, [], [], []).content;
-            await Promise.all([
-                writeFile(join(specDir, 'executive-report.html'), execHtml, 'utf-8'),
-                writeFile(join(specDir, 'technical-report.html'), techHtml, 'utf-8'),
-            ]);
-        }
-        catch {
-            /* best-effort per spec */
-        }
-    }));
+export function regeneratePerSpecReports(specs) {
+    void specs;
+    return Promise.resolve();
 }
 //# sourceMappingURL=report-renderer.js.map

package/dist/engine/spec-summary-html.js

@@ -43,7 +43,7 @@ async function scanFilesystemSpecs(projectPath) {
                 createdAt: str(m.created ?? m.createdAt),
                 updatedAt: str(m.updated ?? m.updatedAt),
                 specPath: join(specsDir, folder, 'spec.md'),
-                technicalPath: join(specsDir, folder, 'technical.md'),
+                technicalPath: join(specsDir, folder, 'spec.md'),
                 estimation: {
                     devHours: num(m.devHours, 8),
                     reviewHours: num(m.reviewHours, 2),

package/dist/engine/universal-rules/rules/planu-english-specs.js

@@ -6,14 +6,11 @@ Auto-generated by \`init_project\`. Do not edit manually.
 
 ## Rule
 
-All generated spec artifacts are written in English, regardless of the user's conversation language:
+All generated spec content is written in English, regardless of the user's conversation language:
 
 - \`spec.md\`
-- \`technical.md\`
-- architecture notes inside \`planu/specs/**\`
-- acceptance criteria
-- implementation notes
-- validation and reconciliation notes
+- inline \`## Technical\`, \`## Files\`, and \`## Progress\` sections
+- acceptance criteria, implementation notes, validation notes, and reconciliation notes
 
 User-facing chat may use the user's preferred language. The spec contract itself stays in English so every agent, tool, and CI gate can parse it consistently.
 
@@ -21,6 +18,7 @@ User-facing chat may use the user's preferred language. The spec contract itself
 
 - Do not create mixed-language acceptance criteria.
 - Do not translate BDD keywords.
+- Do not create standalone \`technical.md\`, \`progress.md\`, \`HU.md\`, \`FICHA-TECNICA.md\`, or \`PROGRESS.md\`.
 - Do not approve a spec that contains unresolved placeholders such as \`to be determined\`, \`TBD\`, \`TODO\`, or equivalent filler.
 `;
 }

package/dist/server/routes/specs.js

@@ -83,7 +83,7 @@ export async function handleCreateSpec(ctx) {
             createdAt: now,
             updatedAt: now,
             specPath: `planu/specs/${specId}-${slug}/spec.md`,
-            technicalPath: `planu/specs/${specId}-${slug}/technical.md`,
+            technicalPath: `planu/specs/${specId}-${slug}/spec.md`,
             estimation: {
                 devHours: 4,
                 reviewHours: 1,

package/dist/tools/create-spec/autopilot-analyzer.js

@@ -210,7 +210,7 @@ function generatePatternCriteria(patterns, _knowledge) {
                 break;
             // SPEC-535: EU AI Act Article 53-55 compliance criteria for foundation model features
             case 'llm-feature':
-                criteria.push('GIVEN the feature uses a foundation model WHEN the spec is implemented THEN technical.md documents: model name, provider (Anthropic/OpenAI/Google), and access date — required by EU AI Act Article 53(1)(a)');
+                criteria.push('GIVEN the feature uses a foundation model WHEN the spec is implemented THEN spec.md documents in its inline Technical section: model name, provider (Anthropic/OpenAI/Google), and access date — required by EU AI Act Article 53(1)(a)');
                 criteria.push('GIVEN EU users interact with this feature WHEN the feature is deployed THEN an acceptable use policy is visible before the first AI interaction — required by EU AI Act Article 53(1)(c)');
                 criteria.push("GIVEN the feature processes user-generated content via LLM WHEN any EU user's data is involved THEN the privacy notice explicitly states LLM processing and links to the model provider's data processing terms");
                 break;

package/dist/tools/create-spec/spec-builder.js

@@ -81,7 +81,7 @@ export async function buildSpecContext(params) {
         // Expected: directory doesn't exist yet — proceed
     }
     const specPath = join(specDir, fileNames.spec);
-    const technicalPath = join(specDir, fileNames.technical);
+    const technicalPath = specPath;
     // Generate git branch name
     const gitBranch = generateBranchName(specId, slug, type);
     // SPEC-770: derive idempotency key from sha256(title + projectPath) to prevent duplicate specs

package/dist/tools/decompose-spec.js

@@ -57,7 +57,7 @@ function buildNextSteps(orchestrationReady, taskCount) {
     if (!orchestrationReady) {
         return [
             'Review the warnings above — some tasks have no owned files.',
-            'Add file paths to the technical.md then re-run decompose_spec.',
+            'Add file paths to the inline ## Files section in spec.md, then re-run decompose_spec.',
         ];
     }
     return [

package/dist/tools/git/pr-ops.js

@@ -48,7 +48,7 @@ export async function handleGeneratePr(projectId, specId) {
     }
     const typeLabel = spec.type.charAt(0).toUpperCase() + spec.type.slice(1);
     const prTitle = `[${specId}] ${spec.title}`;
-    // Build acceptance criteria checklist from spec (criteria live in HU.md, not on spec object)
+    // Build acceptance criteria checklist from spec.md.
     const criteriaChecklist = buildCriteriaChecklist();
     const prBody = [
         `## ${typeLabel}: ${spec.title}`,
@@ -135,7 +135,7 @@ export async function handleGeneratePr(projectId, specId) {
     return compactResult(text);
 }
 function buildCriteriaChecklist() {
-    return '- [ ] All acceptance criteria met (see HU.md)';
+    return '- [ ] All acceptance criteria met (see spec.md)';
 }
 function buildLabels(type, risk, scope) {
     const labels = [];

package/dist/tools/git/sync-ops.js

@@ -158,7 +158,7 @@ export async function handleResolveConflict(projectId, files) {
                 specId: s.id,
                 title: s.title,
                 status: s.status,
-                context: `Resolve keeping spec ${s.id} (${s.title}) intent. Check HU.md acceptance criteria for guidance.`,
+                context: `Resolve keeping spec ${s.id} (${s.title}) intent. Check spec.md acceptance criteria for guidance.`,
             })),
         };
     });

package/dist/tools/reconcile-spec-living-handler.js

@@ -36,7 +36,7 @@ export async function handleReconcileSpecLiving(input) {
                 lines.push(`- ${icon} ${cr.criterion} — _${cr.evidence}_`);
             }
         }
-        lines.push('', '_progress.md updated with auto-reconcile data._');
+        lines.push('', '_spec.md Progress section updated with auto-reconcile data._');
         return {
             content: [{ type: 'text', text: lines.join('\n') }],
         };

package/dist/tools/reconcile-spec.js

@@ -91,7 +91,7 @@ async function autoDetectChanges(spec, _knowledge) {
             section: 'ficha-file',
             originalValue: spec.technicalPath,
             newValue: 'File not found',
-            reason: 'technical.md file is missing or was moved',
+            reason: 'spec.md inline Technical/Files section is missing or incomplete',
             approved: false,
         });
     }

package/dist/tools/registry/install.js

@@ -22,25 +22,6 @@ async function collectExistingSpecIds(specsDir) {
     }
     /* v8 ignore stop */
 }
-/** Generate a clean progress.md for the installed spec. */
-function generateProgressMd(specId, source, version) {
-    const now = new Date().toISOString();
-    return [
-        `# ${specId} — Progress`,
-        '',
-        `> Installed from registry: ${source}@${version}`,
-        `> Installed at: ${now}`,
-        '',
-        '## Status: pendiente',
-        '',
-        '## Acceptance Criteria',
-        '',
-        '- [ ] Review and adapt spec to local project',
-        '- [ ] Implement according to spec',
-        '- [ ] All tests passing',
-        '',
-    ].join('\n');
-}
 /** Inject registry source metadata into spec.md frontmatter. */
 function injectRegistrySource(content, org, name, version) {
     const frontmatterEnd = content.indexOf('\n---', 3);
@@ -50,9 +31,28 @@ function injectRegistrySource(content, org, name, version) {
     const insertion = `\nregistry:\n  source: "${org}/${name}"\n  version: "${version}"`;
     return content.slice(0, frontmatterEnd) + insertion + content.slice(frontmatterEnd);
 }
+function mergeLegacyRegistryFiles(files) {
+    const specContent = files['spec.md'] ?? '';
+    const sections = [specContent.trimEnd()];
+    const technical = files['technical.md'] ?? files['FICHA-TECNICA.md'];
+    if (technical !== undefined && technical.trim().length > 0) {
+        sections.push('## Technical\n\n' + stripLeadingTitleAndFrontmatter(technical).trim());
+    }
+    const progress = files['progress.md'] ?? files['PROGRESS.md'];
+    if (progress !== undefined && progress.trim().length > 0) {
+        sections.push('## Progress\n\n' + stripLeadingTitleAndFrontmatter(progress).trim());
+    }
+    return sections.join('\n\n') + '\n';
+}
+function stripLeadingTitleAndFrontmatter(content) {
+    return content.replace(/^---\n[\s\S]*?\n---\n/, '').replace(/^#\s+.*(?:\r?\n)+/, '');
+}
+function isInstallableRegistrySidecar(filePath) {
+    return filePath === 'planu-registry.json';
+}
 /**
  * Install a spec from raw YAML content (HTTP backend path).
- * Writes spec.md with registry source injected + progress.md, then attempts stack adaptation.
+ * Writes one unified spec.md with registry source injected, then attempts stack adaptation.
  */
 async function installFromYaml(yamlContent, org, name, version, projectPath) {
     const specsDir = join(projectPath, 'planu', 'specs');
@@ -64,7 +64,6 @@ async function installFromYaml(yamlContent, org, name, version, projectPath) {
     const specContent = injectRegistrySource(yamlContent, org, name, version);
     await writeFile(join(specDir, 'spec.md'), specContent, 'utf-8');
     const source = `${org}/${name}`;
-    await writeFile(join(specDir, 'progress.md'), generateProgressMd(specId, source, version), 'utf-8');
     let adapted = false;
     let adaptationsCount = 0;
     try {
@@ -140,17 +139,16 @@ export async function handleRegistryInstall(args) {
         const specDir = join(specsDir, `${specId}-${slug}`);
         // Create spec directory
         await mkdir(specDir, { recursive: true });
-        // Write downloaded files, injecting registry source into spec.md frontmatter
+        // Write a unified spec.md. Legacy registry sidecars are folded into sections
+        // instead of being materialized as standalone files in the spec directory.
+        const source = `${org}/${name}`;
+        const specContent = injectRegistrySource(mergeLegacyRegistryFiles(pkg.files), org, name, version);
+        await writeFile(join(specDir, 'spec.md'), specContent, 'utf-8');
         for (const [filePath, content] of Object.entries(pkg.files)) {
-            let finalContent = content;
-            if (filePath === 'spec.md') {
-                finalContent = injectRegistrySource(content, org, name, version);
+            if (isInstallableRegistrySidecar(filePath)) {
+                await writeFile(join(specDir, filePath), content, 'utf-8');
             }
-            await writeFile(join(specDir, filePath), finalContent, 'utf-8');
         }
-        // Generate local progress.md
-        const source = `${org}/${name}`;
-        await writeFile(join(specDir, 'progress.md'), generateProgressMd(specId, source, version), 'utf-8');
         // Attempt stack detection and spec adaptation (non-blocking on failure)
         let adapted = false;
         let adaptationsCount = 0;

package/dist/tools/reverse-engineer/handler.js

@@ -204,7 +204,7 @@ export async function handleReverseEngineer(args) {
     const specLocation = projectKnowledge?.specLocation ?? 'planu/specs';
     const specDir = resolve(join(projectPath, specLocation, `${specId}-${slug}`));
     const specFilePath = join(specDir, 'spec.md');
-    const technicalFilePath = join(specDir, 'technical.md');
+    const technicalFilePath = specFilePath;
     spec.specPath = specFilePath;
     spec.technicalPath = technicalFilePath;
     try {

package/dist/tools/schemas/registry.js

@@ -24,7 +24,7 @@ export const CheckSpecAccuracySchema = z.object({
         .string()
         .min(1)
         .max(1_000_000)
-        .describe('Contenido de la spec o fragmento a validar (texto de HU.md o criterios de aceptacion)'),
+        .describe('Contenido de la spec o fragmento a validar (texto de spec.md o criterios de aceptacion)'),
     frameworks: z
         .array(z.string().max(500))
         .max(100)

package/dist/tools/spec-coverage.js

@@ -29,7 +29,7 @@ async function analyzeSingleSpec(projectId, specId, projectPath) {
         return errorResult(`Spec "${specId}" not found in project "${projectId}".`);
     }
     if (!spec.specPath) {
-        return errorResult(`Spec "${specId}" has no HU.md path recorded. ` +
+        return errorResult(`Spec "${specId}" has no spec.md path recorded. ` +
             `The spec may have been created before this feature was available.`);
     }
     const huPath = join(projectPath, spec.specPath);
@@ -57,7 +57,7 @@ async function analyzeAllSpecs(projectId, projectPath) {
     const errors = [];
     for (const spec of activeSpecs) {
         if (!spec.specPath) {
-            errors.push(`${spec.id}: no HU.md path`);
+            errors.push(`${spec.id}: no spec.md path`);
             continue;
         }
         const huPath = join(projectPath, spec.specPath);

package/dist/tools/spec-templates.d.ts

@@ -4,7 +4,7 @@ import type { ListTemplatesInput, ApplyTemplateInput, ToolResult } from '../type
  */
 export declare function handleListTemplates(args: ListTemplatesInput): Promise<ToolResult>;
 /**
- * Applies a template to create HU.md + FICHA-TECNICA.md + PROGRESS.md.
+ * Applies a template to create one unified spec.md file.
  */
 export declare function handleApplyTemplate(args: ApplyTemplateInput): Promise<ToolResult>;
 //# sourceMappingURL=spec-templates.d.ts.map

package/dist/tools/spec-templates.js

@@ -62,7 +62,7 @@ export async function handleListTemplates(args) {
     }
 }
 /**
- * Applies a template to create HU.md + FICHA-TECNICA.md + PROGRESS.md.
+ * Applies a template to create one unified spec.md file.
  */
 export async function handleApplyTemplate(args) {
     try {
@@ -93,19 +93,14 @@ export async function handleApplyTemplate(args) {
         const rendered = renderTemplate(template, args.variables, args.includeCriteria);
         const outputDir = resolveOutputDir(args);
         await mkdir(outputDir, { recursive: true });
-        const specPath = join(outputDir, 'HU.md');
-        const fichaTecnicaPath = join(outputDir, 'FICHA-TECNICA.md');
-        const progressPath = join(outputDir, 'PROGRESS.md');
-        await atomicWriteFile(specPath, rendered.hu);
-        await atomicWriteFile(fichaTecnicaPath, rendered.fichaTecnica);
-        await atomicWriteFile(progressPath, rendered.progress);
+        const specPath = join(outputDir, 'spec.md');
+        const specContent = buildUnifiedTemplateSpec(rendered.hu, rendered.fichaTecnica, rendered.progress);
+        await atomicWriteFile(specPath, specContent);
         const result = {
             templateId: template.id,
             templateName: template.name,
             complexityScore: template.complexityScore,
             specPath,
-            fichaTecnicaPath,
-            progressPath,
             variablesApplied: args.variables.length,
             criteriaIncluded: rendered.criteriaIncluded,
             criteriaTotal: rendered.criteriaTotal,
@@ -125,6 +120,19 @@ export async function handleApplyTemplate(args) {
         };
     }
 }
+function buildUnifiedTemplateSpec(hu, technical, progress) {
+    const sections = [hu.trimEnd()];
+    if (technical.trim().length > 0) {
+        sections.push('## Technical\n\n' + stripLeadingTitle(technical).trim());
+    }
+    if (progress.trim().length > 0) {
+        sections.push('## Progress\n\n' + stripLeadingTitle(progress).trim());
+    }
+    return sections.join('\n\n') + '\n';
+}
+function stripLeadingTitle(content) {
+    return content.replace(/^#\s+.*(?:\r?\n)+/, '');
+}
 /**
  * Resolves the output directory for the spec files.
  */

package/dist/tools/tool-registry/group-infra.js

@@ -562,7 +562,7 @@ export function registerInfraGroupTools(server) {
     }, safeLicensed('assign_role', (args) => handleAssignRole(args)));
     // ── Framework registry tools ───────────────────────────────────────────────
     server.registerTool('check_spec_accuracy', {
-        description: 'Validate spec content (HU.md text or acceptance criteria) against the framework registry ' +
+        description: 'Validate spec content (spec.md text or acceptance criteria) against the framework registry ' +
             'to detect hallucinated APIs, deprecated patterns, and common mistakes. ' +
             'Returns a confidence score (0-100) and actionable suggestions.',
         inputSchema: {

package/dist/tools/tool-registry/group-platform.js

@@ -475,7 +475,7 @@ export function registerPlatformGroupTools(s) {
         annotations: { title: 'List Spec Templates', readOnlyHint: true },
     }, safeTracked('list_templates', async (args) => handleListTemplates(args)));
     s.registerTool('apply_template', {
-        description: 'Create HU.md, FICHA-TECNICA.md, and PROGRESS.md from a spec template. ' +
+        description: 'Create a unified spec.md from a spec template. ' +
             'Templates are language-agnostic and cover common feature patterns (auth, CRUD, API, etc.) and industry verticals (fintech, healthtech, e-commerce, SaaS). ' +
             'Use list_templates first to discover available templates and their required variables. ' +
             'Supports partial criteria selection via includeCriteria parameter.',

package/dist/types/spec-templates.d.ts

@@ -62,11 +62,11 @@ export interface SpecTemplateEntry {
     criteria: TemplateCriterion[];
     /** Variables that users need to provide when applying the template. */
     variables: TemplateVariable[];
-    /** Template content for HU.md (Handlebars-style {{VariableKey}} placeholders). */
+    /** Legacy template content for the main spec body. */
     huTemplate: string;
-    /** Template content for FICHA-TECNICA.md. */
+    /** Legacy template content for technical details, now embedded into spec.md. */
     fichaTecnicaTemplate: string;
-    /** Template content for PROGRESS.md. */
+    /** Legacy template content for progress details, now embedded into spec.md. */
     progressTemplate: string;
 }
 /** Result returned by the list_templates tool. */
@@ -115,8 +115,6 @@ export interface ApplyTemplateResult {
     templateName: string;
     complexityScore: TemplateComplexity;
     specPath: string;
-    fichaTecnicaPath: string;
-    progressPath: string;
     variablesApplied: number;
     criteriaIncluded: number;
     criteriaTotal: number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@planu/cli",
-  "version": "3.9.11",
+  "version": "3.9.12",
   "description": "Planu — MCP Server for Spec Driven Development with native Rust acceleration for hot paths. Cross-platform (Linux/macOS/Windows, x64/arm64, glibc/musl).",
   "type": "module",
   "main": "dist/index.js",

package/src/i18n/messages/en.json

@@ -407,10 +407,10 @@
       "missingVarExample": "Example: \"{example}\"",
       "missingVarsHint": "Provide all required variables in the `variables` array and try again.",
       "applySuccess": "Template \"{name}\" applied successfully.",
-      "filesCreated": "Files created in: {dir}",
+      "filesCreated": "spec.md created in: {dir}",
       "nextSteps": "Next steps:",
-      "step1": "1. Review and customize HU.md acceptance criteria",
-      "step2": "2. Update FICHA-TECNICA.md with project-specific details",
+      "step1": "1. Review and customize acceptance criteria in spec.md",
+      "step2": "2. Update the inline Technical section with project-specific details",
       "step3": "3. Run create_spec or update_status once the spec is approved",
       "applyError": "Error applying template: {message}"
     },

package/src/i18n/messages/es.json

@@ -407,10 +407,10 @@
       "missingVarExample": "Ejemplo: \"{example}\"",
       "missingVarsHint": "Proporciona todas las variables requeridas en el array `variables` e intenta de nuevo.",
       "applySuccess": "Plantilla \"{name}\" aplicada exitosamente.",
-      "filesCreated": "Archivos creados en: {dir}",
+      "filesCreated": "spec.md creado en: {dir}",
       "nextSteps": "Próximos pasos:",
-      "step1": "1. Revisar y personalizar los criterios de aceptación en HU.md",
-      "step2": "2. Actualizar FICHA-TECNICA.md con detalles específicos del proyecto",
+      "step1": "1. Revisar y personalizar los criterios de aceptación en spec.md",
+      "step2": "2. Actualizar la sección Technical embebida con detalles específicos del proyecto",
       "step3": "3. Ejecutar create_spec o update_status cuando la spec esté aprobada",
       "applyError": "Error al aplicar plantilla: {message}"
     },

package/src/i18n/messages/pt.json

@@ -407,10 +407,10 @@
       "missingVarExample": "Exemplo: \"{example}\"",
       "missingVarsHint": "Forneça todas as variáveis obrigatórias no array `variables` e tente novamente.",
       "applySuccess": "Modelo \"{name}\" aplicado com sucesso.",
-      "filesCreated": "Arquivos criados em: {dir}",
+      "filesCreated": "spec.md criado em: {dir}",
       "nextSteps": "Próximos passos:",
-      "step1": "1. Revisar e personalizar os critérios de aceitação em HU.md",
-      "step2": "2. Atualizar FICHA-TECNICA.md com detalhes específicos do projeto",
+      "step1": "1. Revisar e personalizar os critérios de aceitação em spec.md",
+      "step2": "2. Atualizar a seção Technical embutida com detalhes específicos do projeto",
       "step3": "3. Executar create_spec ou update_status quando a spec estiver aprovada",
       "applyError": "Erro ao aplicar modelo: {message}"
     },