@planu/cli 3.9.11 → 3.9.12

package/CHANGELOG.md

@@ -1,3 +1,15 @@
+## [3.9.12] - 2026-05-19
+
+**Tarball SHA-256:** `cd07a22fdfc0c982726a918c1e47f147ca300ecad710e8377f1751ef993fea60`
+
+### Bug Fixes
+- fix(specs): purge legacy spec artifact writers
+
+### Chores
+- chore(claude): reconcile typescript skill asset
+- chore(claude): remove unavailable skill artifact
+
+
 ## [3.9.11] - 2026-05-17
 
 **Tarball SHA-256:** `a201430a93ae5f87af8322409c328266c29b340e890eb2fa49c7181da32886d3`

package/dist/config/criteria-injection-rules.json

@@ -3,7 +3,7 @@
   "rules": [
     {
       "id": "eu-ai-act-53-1a",
-      "criterion": "GIVEN the feature uses a foundation model WHEN the spec is implemented THEN technical.md documents: model name, provider, and access date — EU AI Act Article 53(1)(a)",
+      "criterion": "GIVEN the feature uses a foundation model WHEN the spec is implemented THEN spec.md documents in its inline Technical section: model name, provider, and access date — EU AI Act Article 53(1)(a)",
       "requiresTags": ["llm", "foundation-model", "ai-feature"],
       "requiresTargets": [],
       "requiresScopes": []

package/dist/config/dor-dod-items.json

@@ -42,7 +42,7 @@
   {
     "id": "dor-5",
     "kind": "dor",
-    "description": "HU.md file exists and is complete",
+    "description": "spec.md file exists and is complete",
     "category": "spec",
     "required": true,
     "autoCheck": true,
@@ -52,7 +52,7 @@
   {
     "id": "dor-6",
     "kind": "dor",
-    "description": "FICHA-TECNICA.md file exists and is complete",
+    "description": "spec.md inline Technical section is complete",
     "category": "design",
     "required": true,
     "autoCheck": true,
@@ -194,7 +194,7 @@
   {
     "id": "dod-7",
     "kind": "dod",
-    "description": "Documentation updated (HU.md, FICHA-TECNICA.md, PLAN.md)",
+    "description": "Documentation updated in spec.md",
     "category": "docs",
     "required": false,
     "autoCheck": false,

package/dist/config/hook-templates/planu-spec-sanctity.sh

@@ -20,7 +20,6 @@ set -euo pipefail
 # ---------------------------------------------------------------------------
 ALLOWED_FILES=(
   "spec.md"
-  "technical.md"
   "progress.json"
   "implementation-brief.md"
 )
@@ -79,6 +78,18 @@ NORMALISED="${NORMALISED#/*/}"   # strip any leading absolute segment
 if [[ "$NORMALISED" =~ ^(.*/)?planu/specs/SPEC-[^/]+/([^/]+)$ ]]; then
   BASENAME="${BASH_REMATCH[2]}"
 
+  case "$BASENAME" in
+    technical.md|progress.md|HU.md|FICHA-TECNICA.md|PROGRESS.md)
+      cat >&2 <<EOF
+[planu-spec-sanctity] BLOCKED: "$FILE_PATH" is a legacy spec artifact.
+
+Planu specs are unified in spec.md. Put technical planning, file ownership,
+and progress into inline sections: ## Technical, ## Files, and ## Progress.
+EOF
+      exit 2
+      ;;
+  esac
+
   # Check against whitelist
   for allowed in "${ALLOWED_FILES[@]}"; do
     if [[ "$BASENAME" == "$allowed" ]]; then
@@ -92,11 +103,10 @@ if [[ "$NORMALISED" =~ ^(.*/)?planu/specs/SPEC-[^/]+/([^/]+)$ ]]; then
 
 Allowed files inside planu/specs/SPEC-*/ are:
   - spec.md
-  - technical.md
   - progress.json
   - implementation-brief.md
 
-Do NOT create PLAN.md, NOTES.md, ADRs, or other files here.
+Do NOT create technical.md, progress.md, PLAN.md, NOTES.md, ADRs, or other files here.
 Keep implementation notes in conversation context or in src/.
 EOF
   exit 2

package/dist/config/server-instructions.js

@@ -53,7 +53,7 @@ export const SERVER_INSTRUCTIONS = [
     '4. When presenting lists or results, use plain language headers — not jargon.',
     '5. If the user seems confused, offer to explain further. Never assume knowledge.',
     "6. Adapt your language to the user's locale (English, Spanish, or Portuguese).",
-    '   EXCEPTION: spec.md and technical.md files must ALWAYS be written in English regardless of locale.',
+    '   EXCEPTION: spec.md files must ALWAYS be written in English regardless of locale.',
     '   The user-facing narrative (tool response text) is translated; spec docs are always English.',
     '',
     'INTERACTIVE QUESTIONS — HARD GATE enforcement (SPEC-584):',

package/dist/config/server-instructions.ts

@@ -54,7 +54,7 @@ export const SERVER_INSTRUCTIONS = [
   '4. When presenting lists or results, use plain language headers — not jargon.',
   '5. If the user seems confused, offer to explain further. Never assume knowledge.',
   "6. Adapt your language to the user's locale (English, Spanish, or Portuguese).",
-  '   EXCEPTION: spec.md and technical.md files must ALWAYS be written in English regardless of locale.',
+  '   EXCEPTION: spec.md files must ALWAYS be written in English regardless of locale.',
   '   The user-facing narrative (tool response text) is translated; spec docs are always English.',
   '',
   'INTERACTIVE QUESTIONS — HARD GATE enforcement (SPEC-584):',

package/dist/config/skill-templates/planu-new-spec.md

@@ -45,7 +45,7 @@ User: "I want to add Stripe payment support"
 ## What you get
 
 - A complete `spec.md` with GIVEN/WHEN/THEN acceptance criteria
-- A `technical.md` with file-level implementation plan
+- Inline `## Technical` and `## Files` sections with file-level implementation plan
 - Challenge report identifying any gaps found (auto-addressed where possible)
 - Readiness score — must be ≥ 80 before implementation begins
 

package/dist/config/skill-templates/planu-resume-work.md

@@ -25,7 +25,7 @@ Use this skill at the start of a session, or when returning to a project after a
 
 1. **Check status** — calls `planu_status` to see all active specs
 2. **Find in-progress** — identifies specs with status `implementing` or `review`
-3. **Load context** — reads the spec's `spec.md`, `technical.md`, and `progress.json`
+3. **Load context** — reads the spec's `spec.md` and any inline `## Technical`, `## Files`, and `## Progress` sections
 4. **Restore session** — calls `restore_session` or `session_checkpoint` to recover the previous session state
 5. **Report** — summarizes exactly where to resume: which files were being modified, which criteria are still open
 

package/dist/config/subagent-templates/planu-readiness-auditor.md

@@ -23,12 +23,12 @@ You are a readiness gatekeeper. Your job is to verify that a spec is actionable
 
 ## Workflow
 
-1. **Load spec** — call `list_specs` to find the spec. Read both `spec.md` and `technical.md`.
+1. **Load spec** — call `list_specs` to find the spec. Read `spec.md`, including inline `## Technical` and `## Files` sections.
 2. **Check readiness** — call `check_readiness({ specId })`. Record the score and blockers.
 3. **Quality score** — call `spec_quality_score({ specId })` for a structured breakdown.
 4. **Size analysis** — call `analyze_spec_size({ specId })` to detect over/under-specified sections.
 5. **Suggest missing criteria** — call `suggest_criteria({ specId })` for any dimension below threshold.
-6. **Heal docs if needed** — call `heal_spec_docs({ specId })` if `technical.md` has placeholder content.
+6. **Heal docs if needed** — call `heal_spec_docs({ specId })` if the inline `## Technical` section has placeholder content.
 7. **Verdict**:
    - Score ≥ 80 and no blockers → ✅ Ready for approval
    - Score 60–79 → 🟡 Conditional — list specific improvements required
@@ -54,5 +54,5 @@ Score: XX/100
 
 - Never approve a spec with undefined terms in criteria
 - Every criterion must be independently verifiable by an automated test
-- The `technical.md` file must list concrete file paths, not placeholders
+- The inline `## Technical` / `## Files` sections must list concrete file paths, not placeholders
 - Missing error-path criteria always block readiness

package/dist/config/subagent-templates/planu-spec-implementer.md

@@ -26,7 +26,7 @@ You are an autonomous implementation agent for Spec Driven Development. Your job
 
 ## Workflow
 
-1. **Read the spec** — call `list_specs` and find the target spec. Read `spec.md` and `technical.md` for full context.
+1. **Read the spec** — call `list_specs` and find the target spec. Read `spec.md`, including inline `## Technical`, `## Files`, and `## Progress` sections.
 2. **Verify approval** — confirm spec status is `approved`. If not, call `check_readiness` and stop with a note.
 3. **Update status to `implementing`** — call `update_status({ specId, status: "implementing" })`.
 4. **Create a feature branch** — `git checkout -b feat/SPEC-NNN-slug`.

package/dist/config/workflow-conventions-catalog.json

@@ -25,10 +25,10 @@
     },
     "propose-spec-split.sh": {
       "name": "propose-spec-split.sh",
-      "purpose": "Analyze a spec's HU.md and propose a split when it exceeds the 35-criteria threshold for a single implementation context.",
-      "triggerCondition": "When a spec has > 35 acceptance criteria in its HU.md. Must run BEFORE starting implementation — never implement XL specs directly.",
+      "purpose": "Analyze a spec.md and propose a split when it exceeds the 35-criteria threshold for a single implementation context.",
+      "triggerCondition": "When a spec has > 35 acceptance criteria in spec.md. Must run BEFORE starting implementation — never implement XL specs directly.",
       "expectedOutput": "Proposed sub-spec split with suggested groupings, estimated size per sub-spec, and recommended implementation order.",
-      "preConditions": ["SPEC-XXX directory exists with HU.md", "HU.md has acceptance criteria section"],
+      "preConditions": ["SPEC-XXX directory exists with spec.md", "spec.md has acceptance criteria section"],
       "whenToUse": "Proactively at spec planning time. The /implement-spec skill should call this automatically for specs > 35 criteria."
     }
   },

package/dist/core/spec-api.js

@@ -45,7 +45,7 @@ export async function createSpec(input) {
     const specLocation = 'planu/specs';
     const specDir = resolve(join(projectPath, specLocation, `${specId}-${slug}`));
     const specPath = join(specDir, 'spec.md');
-    const technicalPath = join(specDir, 'technical.md');
+    const technicalPath = specPath;
     const now = new Date().toISOString();
     const spec = {
         id: specId,

package/dist/engine/agent-generator/builders.js

@@ -33,7 +33,7 @@ export function buildSystemPrompt(agentName, role, capabilities, knowledge) {
     lines.push('');
     lines.push('## Scope Restrictions');
     lines.push('- NEVER git commit or git push changes — that is handled by the parent skill');
-    lines.push('- NEVER update PROGRESS.md or spec tracking files — delegate to parent skill');
+    lines.push('- NEVER create or update standalone progress.md/PROGRESS.md tracking files — delegate to parent skill');
     lines.push('- NEVER run the full CI/CD pipeline — parent skill manages pipeline execution');
     lines.push('- Focus exclusively on your assigned subtask and report results clearly');
     return lines.join('\n');

package/dist/engine/autopilot/handlers-b2.d.ts

@@ -11,11 +11,11 @@ export declare function injectCriteria(ctx: ActionContext): Promise<ActionResult
 export declare function rewriteCriteriaEars(ctx: ActionContext): Promise<ActionResult>;
 /**
  * verify_spec_compliance: Checks that a spec has spec.md with criteria,
- * technical.md with file references, and that those files exist on disk.
+ * inline file references in spec.md, and that those files exist on disk.
  */
 export declare function verifySpecCompliance(ctx: ActionContext): Promise<ActionResult>;
 /**
- * analyze_code_impact: Counts and categorizes files listed in technical.md.
+ * analyze_code_impact: Counts and categorizes files listed in spec.md.
  * Flags specs with >10 affected files as HIGH IMPACT.
  */
 export declare function analyzeCodeImpact(ctx: ActionContext): Promise<ActionResult>;

package/dist/engine/autopilot/handlers-b2.js

@@ -21,7 +21,7 @@ async function findSpecDir(projectPath, specId) {
     const dir = matches[0];
     return dir !== undefined ? join(specDir, dir) : null;
 }
-/** Extract file path references from technical.md content (backtick-quoted paths with slashes). */
+/** Extract file path references from spec content (backtick-quoted paths with slashes). */
 function extractFileRefs(content) {
     const regex = /`([^`]*\/[^`]+\.[a-zA-Z]+)`/g;
     const seen = new Set();
@@ -149,7 +149,7 @@ export async function rewriteCriteriaEars(ctx) {
 // ---------------------------------------------------------------------------
 /**
  * verify_spec_compliance: Checks that a spec has spec.md with criteria,
- * technical.md with file references, and that those files exist on disk.
+ * inline file references in spec.md, and that those files exist on disk.
  */
 export async function verifySpecCompliance(ctx) {
     if (!ctx.specId) {
@@ -168,29 +168,25 @@ export async function verifySpecCompliance(ctx) {
     }
     const findings = [];
     const specMdPath = join(specDirPath, 'spec.md');
-    const technicalMdPath = join(specDirPath, 'technical.md');
+    let specContent = '';
     // Check 1: spec.md has acceptance criteria
     if (!existsSync(specMdPath)) {
         findings.push('spec.md is missing');
     }
     else {
-        const specContent = await readFile(specMdPath, 'utf-8');
+        specContent = await readFile(specMdPath, 'utf-8');
         const criteriaCount = (specContent.match(/^\s*-\s+\[[ xX]\]\s+.+$/gm) ?? []).length;
         if (criteriaCount === 0) {
             findings.push('spec.md has no acceptance criteria');
         }
     }
-    // Check 2: technical.md with file references
+    // Check 2: spec.md inline file references
     const implementedFiles = [];
-    if (!existsSync(technicalMdPath)) {
-        findings.push('technical.md is missing');
-    }
-    else {
-        const techContent = await readFile(technicalMdPath, 'utf-8');
-        const refs = extractFileRefs(techContent);
+    if (specContent.length > 0) {
+        const refs = extractFileRefs(specContent);
         implementedFiles.push(...refs);
         if (refs.length === 0) {
-            findings.push('technical.md has no file references');
+            findings.push('spec.md inline Technical/Files sections have no file references');
         }
     }
     // Check 3: referenced files exist on disk
@@ -203,7 +199,7 @@ export async function verifySpecCompliance(ctx) {
     }
     if (missingFiles.length > 0) {
         const listed = missingFiles.slice(0, 3).join(', ');
-        findings.push(`${String(missingFiles.length)} file(s) listed in technical.md not found: ${listed}`);
+        findings.push(`${String(missingFiles.length)} file(s) listed in spec.md not found: ${listed}`);
     }
     const passed = findings.length === 0;
     const summary = passed
@@ -215,7 +211,7 @@ export async function verifySpecCompliance(ctx) {
 // analyze_code_impact
 // ---------------------------------------------------------------------------
 /**
- * analyze_code_impact: Counts and categorizes files listed in technical.md.
+ * analyze_code_impact: Counts and categorizes files listed in spec.md.
  * Flags specs with >10 affected files as HIGH IMPACT.
  */
 export async function analyzeCodeImpact(ctx) {
@@ -233,16 +229,16 @@ export async function analyzeCodeImpact(ctx) {
             durationMs: 0,
         };
     }
-    const technicalMdPath = join(specDirPath, 'technical.md');
-    if (!existsSync(technicalMdPath)) {
+    const specMdPath = join(specDirPath, 'spec.md');
+    if (!existsSync(specMdPath)) {
         return {
             success: false,
-            summary: `analyze_code_impact: technical.md not found for ${ctx.specId}`,
+            summary: `analyze_code_impact: spec.md not found for ${ctx.specId}`,
             durationMs: 0,
         };
     }
-    const techContent = await readFile(technicalMdPath, 'utf-8');
-    const allFiles = extractFileRefs(techContent);
+    const specContent = await readFile(specMdPath, 'utf-8');
+    const allFiles = extractFileRefs(specContent);
     // Breakdown by extension — normalize .test.ts/.test.js as separate categories
     const breakdown = {};
     for (const filePath of allFiles) {

package/dist/engine/ci-generator/local-script.js

@@ -60,8 +60,8 @@ function buildValidateSection() {
         '  SPEC_NAME=$(basename "$spec_dir")',
         '  TOTAL=$((TOTAL + 1))',
         '',
-        '  SPEC_FILE=$(ls "$spec_dir"spec.md "$spec_dir"HU.md 2>/dev/null | head -1 || echo "")',
-        '  if [ -z "$SPEC_FILE" ]; then',
+        '  SPEC_FILE="$spec_dir/spec.md"',
+        '  if [ ! -f "$SPEC_FILE" ]; then',
         '    echo -e "  ${RED}x${RESET} $SPEC_NAME - missing spec.md"',
         '    ISSUES=$((ISSUES + 1))',
         '    continue',
@@ -90,8 +90,8 @@ function buildDriftSection() {
         '  echo -e "${BOLD}Drift Detection${RESET}"',
         '  CHANGED_FILES=$(git diff HEAD --name-only 2>/dev/null || echo "")',
         '  for spec_dir in "$SPECS_DIR"/*/; do',
-        '    [ -f "$spec_dir/technical.md" ] || continue',
-        '    SPEC_FILES=$(grep -oE \'src/[a-zA-Z0-9_./-]+\' "$spec_dir/technical.md" 2>/dev/null || echo "")',
+        '    [ -f "$spec_dir/spec.md" ] || continue',
+        '    SPEC_FILES=$(grep -oE \'src/[a-zA-Z0-9_./-]+\' "$spec_dir/spec.md" 2>/dev/null || echo "")',
         '    for sf in $SPEC_FILES; do',
         '      if echo "$CHANGED_FILES" | grep -q "$sf"; then',
         '        SPEC_NAME=$(basename "$spec_dir")',

package/dist/engine/ci-generator/planu-steps.js

@@ -113,9 +113,8 @@ function buildDriftStepLines(indent, specsDir) {
         `${indent}    echo "$CHANGED_FILES"`,
         `${indent}    DRIFT_FOUND="false"`,
         `${indent}    for spec_dir in ${specsDir}/*/; do`,
-        `${indent}      if [ -f "$spec_dir/technical.md" ] || [ -f "$spec_dir/FICHA-TECNICA.md" ]; then`,
-        `${indent}        TECH_FILE=$(ls "$spec_dir"technical.md "$spec_dir"FICHA-TECNICA.md 2>/dev/null | head -1)`,
-        `${indent}        SPEC_FILES=$(grep -oE 'src/[a-zA-Z0-9_./-]+' "$TECH_FILE" 2>/dev/null || echo "")`,
+        `${indent}      if [ -f "$spec_dir/spec.md" ]; then`,
+        `${indent}        SPEC_FILES=$(grep -oE 'src/[a-zA-Z0-9_./-]+' "$spec_dir/spec.md" 2>/dev/null || echo "")`,
         `${indent}        for sf in $SPEC_FILES; do`,
         `${indent}          if echo "$CHANGED_FILES" | grep -q "$sf"; then`,
         `${indent}            SPEC_NAME=$(basename "$spec_dir")`,
@@ -145,8 +144,8 @@ function buildValidateStepLines(indent, specsDir) {
         `${indent}      [ -d "$spec_dir" ] || continue`,
         `${indent}      SPEC_NAME=$(basename "$spec_dir")`,
         `${indent}      TOTAL=$((TOTAL + 1))`,
-        `${indent}      SPEC_FILE=$(ls "$spec_dir"spec.md "$spec_dir"HU.md 2>/dev/null | head -1)`,
-        `${indent}      if [ -z "$SPEC_FILE" ]; then`,
+        `${indent}      SPEC_FILE="$spec_dir/spec.md"`,
+        `${indent}      if [ ! -f "$SPEC_FILE" ]; then`,
         `${indent}        RESULTS+="$SPEC_NAME FAIL missing-spec\\n"`,
         `${indent}        COMMENT+="| $SPEC_NAME | FAIL | missing spec.md |\\n"`,
         `${indent}        ISSUES=$((ISSUES + 1))`,

package/dist/engine/compliance/auto-remediator.js

@@ -48,7 +48,6 @@ async function writeStubSpec(projectPath, specId, title, framework, criteria, dr
         '',
     ].join('\n');
     await writeFile(join(specDir, 'spec.md'), specContent, 'utf-8');
-    await writeFile(join(specDir, 'progress.md'), `# ${specId} — Progress\n\nstatus: draft\n`, 'utf-8');
 }
 // ---------------------------------------------------------------------------
 // Manual action builders

package/dist/engine/drift/violation-resolver.js

@@ -43,7 +43,6 @@ async function createFollowUpSpec(projectPath, parentSpecId, reason, dryRun) {
             '',
         ].join('\n');
         await writeFile(join(specDir, 'spec.md'), specContent, 'utf-8');
-        await writeFile(join(specDir, 'progress.md'), `# ${specId} — Progress\n\nstatus: draft\n`, 'utf-8');
     }
     return specId;
 }

package/dist/engine/health/auto-fixer.js

@@ -1,6 +1,4 @@
 // engine/health/auto-fixer.ts — Auto-fix for health check issues (SPEC-408)
-import { mkdir, writeFile, access } from 'node:fs/promises';
-import { join } from 'node:path';
 import { specStore } from '../../storage/index.js';
 import { computeSpecHealth } from '../validation-loop.js';
 async function collectHealthIssues(projectPath, projectId) {
@@ -31,30 +29,6 @@ async function collectHealthIssues(projectPath, projectId) {
 // ---------------------------------------------------------------------------
 // Fix handlers
 // ---------------------------------------------------------------------------
-async function fixMissingProgress(issue, dryRun) {
-    const specId = issue.specId;
-    const progressPath = join(issue.projectPath, 'planu', 'specs', specId, 'progress.md');
-    try {
-        await access(progressPath);
-        return null; // Already exists
-    }
-    catch {
-        // Does not exist — create it
-        if (!dryRun) {
-            await mkdir(join(issue.projectPath, 'planu', 'specs', specId), { recursive: true });
-            const content = `# ${specId} — Progress\n\nstatus: draft\n\n## Tasks\n\n- [ ] Define acceptance criteria\n`;
-            await writeFile(progressPath, content, 'utf-8');
-        }
-        return {
-            issue: 'missing-progress.md',
-            action: dryRun
-                ? 'would create progress.md from template'
-                : 'created progress.md from template',
-            affectedItem: specId,
-            success: true,
-        };
-    }
-}
 function buildSkipForIncompleteSpec(specId) {
     return {
         issue: `incomplete-spec: ${specId}`,
@@ -96,18 +70,12 @@ function buildSkipForDrift(specId) {
  * When dryRun=true, reports what would be fixed without writing any files.
  */
 export async function autoFixHealth(projectPath, projectId, dryRun = false) {
+    void dryRun;
     const issues = await collectHealthIssues(projectPath, projectId);
     const fixes = [];
     const skipped = [];
     for (const issue of issues) {
         switch (issue.type) {
-            case 'missing-progress': {
-                const fix = await fixMissingProgress(issue, dryRun);
-                if (fix) {
-                    fixes.push(fix);
-                }
-                break;
-            }
             case 'incomplete-spec':
                 skipped.push(buildSkipForIncompleteSpec(issue.specId));
                 break;

package/dist/engine/living-spec-analyzer.js

@@ -1,7 +1,7 @@
 // engine/living-spec-analyzer.ts — Heuristic analysis of spec criteria vs codebase
 // Compares acceptance criteria against actual code to produce a living spec report.
 // No LLM calls — purely file-existence and pattern-matching heuristics.
-import { readFile, writeFile, stat } from 'node:fs/promises';
+import { readFile, stat } from 'node:fs/promises';
 import { replaceSectionInSpec } from './spec-format/replace-section.js';
 import { join } from 'node:path';
 import { glob } from 'glob';
@@ -34,8 +34,8 @@ export async function analyzeLivingSpec(spec, projectPath) {
         progressUpdated = await updateProgressInSpec(spec.specPath, assessments, completionPercent);
     }
     else if (spec.progressPath) {
-        // Legacy fallback: spec.md path unknown but progress.md path set
-        progressUpdated = await updateProgressFile(spec.progressPath, assessments, completionPercent);
+        // Legacy progress.md paths are read-only compatibility metadata in unified spec mode.
+        progressUpdated = false;
     }
     return {
         specId: spec.id,
@@ -362,37 +362,6 @@ function extractSectionBodyLocal(content, sectionName) {
     const end = next ? next.index : normalized.length;
     return normalized.slice(afterHeading, end).trim();
 }
-/**
- * Update the spec's progress.md with living spec analysis results.
- * Legacy fallback: only called when specPath is unknown but progressPath exists.
- */
-async function updateProgressFile(progressPath, assessments, completionPercent) {
-    try {
-        let content;
-        try {
-            content = await readFile(progressPath, 'utf-8');
-        }
-        catch {
-            content = '';
-        }
-        const timestamp = new Date().toISOString();
-        const sectionHeader = '### Living Spec Analysis';
-        const newSection = buildProgressSection(assessments, completionPercent, timestamp);
-        if (content.includes(sectionHeader)) {
-            // Replace existing section (up to next ## or end of file)
-            content = content.replace(/### Living Spec Analysis[\s\S]*?(?=\n### |\n## |\n---\n|$)/, newSection);
-        }
-        else {
-            // Append new section
-            content = content.trimEnd() + '\n\n---\n\n' + newSection + '\n';
-        }
-        await writeFile(progressPath, content, 'utf-8');
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
 /**
  * Build the markdown section for living spec progress.
  */

package/dist/engine/planu-config-writer.js

@@ -57,7 +57,7 @@ export function getSpecFileNames(naming) {
     if (naming === 'legacy') {
         return { spec: 'HU.md', technical: 'FICHA-TECNICA.md', progress: 'PROGRESS.md' };
     }
-    return { spec: 'spec.md', technical: 'technical.md', progress: 'progress.md' };
+    return { spec: 'spec.md', technical: 'spec.md', progress: 'spec.md' };
 }
 /**
  * Check if a specLocation uses legacy naming.

package/dist/engine/scan-project/index.js

@@ -101,7 +101,7 @@ async function generateSpecs(input, modules, moduleResults, crossAnalysis, healt
         });
         const specDir = join(input.path, SPEC_LOCATION, `${specId}-${slug}`);
         spec.specPath = join(specDir, 'spec.md');
-        spec.technicalPath = join(specDir, 'technical.md');
+        spec.technicalPath = spec.specPath;
         const body = `# ${spec.title}\n\nAuto-generated by scan_project.\n`;
         await writeSpecFiles(specDir, spec, body);
         await createSpec(input.projectId, spec);
@@ -127,7 +127,7 @@ async function generateSpecs(input, modules, moduleResults, crossAnalysis, healt
     });
     const overviewDir = join(input.path, SPEC_LOCATION, `${overviewSpecId}-${overviewSlug}`);
     overviewSpec.specPath = join(overviewDir, 'spec.md');
-    overviewSpec.technicalPath = join(overviewDir, 'technical.md');
+    overviewSpec.technicalPath = overviewSpec.specPath;
     const overviewBody = overviewContent
         ? `# Project Overview — Automated Scan\n\n${overviewContent}\n`
         : `# Project Overview — Automated Scan\n\nAuto-generated by scan_project.\n`;

package/dist/engine/skill-generator/skills-content.js

@@ -43,7 +43,7 @@ export function generateDomainSkill(config, name, description, knowledge, specCo
         '1. **Understand** — Read spec criteria, review existing code, identify affected modules',
         '2. **Implement** — Write code following architecture patterns and project conventions',
         '3. **Validate** — Run tests, typecheck, lint; verify all spec criteria pass',
-        '4. **Track** — Update PROGRESS.md or spec status with session results',
+        '4. **Track** — Update spec status or the inline ## Progress section with session results',
         '5. **Commit** — Commit with conventional commit message (feat/fix/refactor)',
         '',
         '## Guidelines',

package/dist/engine/spec-migrator/drift-detector.js

@@ -11,7 +11,7 @@ const CANONICAL_ROOT_FILES = new Set([
     'roadmap.html',
 ]);
 const CANONICAL_ROOT_DIRS = new Set(['specs']);
-const CANONICAL_SPEC_FILES = new Set(['spec.md', 'technical.md']);
+const CANONICAL_SPEC_FILES = new Set(['spec.md']);
 async function scanPlanuRoot(projectPath) {
     const rootFiles = [];
     const planuDir = join(projectPath, 'planu');

package/dist/engine/spec-migrator/lean-migration.js

@@ -7,8 +7,10 @@ import { safeUnlink } from './git-aware-fs.js';
 import { parseFrontmatterLocal } from './frontmatter-parser.js';
 import { generateLeanSpecContent } from '../spec-format/lean-spec-generator.js';
 import { generateLeanTechnicalContent } from '../spec-format/lean-technical-generator.js';
+import { buildUnifiedSpecContent } from '../spec-format/unified-spec-builder.js';
 /** Files to delete from old-format specs. */
 const OBSOLETE_FILES = [
+    'technical.md',
     'progress.md',
     'executive-report.html',
     'technical-report.html',
@@ -380,7 +382,7 @@ export async function migrateSpecToLean(specDir, projectPath) {
         const leanSpecLines = generateLeanSpecContent({ spec, description, estimation });
         // Inject real criteria (replace the default one)
         const leanSpecWithCriteria = replaceCriteria(leanSpecLines, criteria);
-        // Generate lean technical.md (estimation only in spec.md — SPEC-462)
+        // Generate the legacy technical body, then fold it into unified spec.md.
         const leanTech = generateLeanTechnicalContent({
             specId: id,
             filesToCreate: files.create.map((p) => ({ path: p, status: 'pending' })),
@@ -394,9 +396,8 @@ export async function migrateSpecToLean(specDir, projectPath) {
         catch (backupErr) {
             return `backup failed: ${backupErr instanceof Error ? backupErr.message : String(backupErr)}`;
         }
-        // Write lean files
-        await atomicWriteFile(specPath, leanSpecWithCriteria);
-        await atomicWriteFile(techPath, leanTech);
+        // Write one unified spec.md.
+        await atomicWriteFile(specPath, buildUnifiedSpecContent(leanSpecWithCriteria, leanTech));
         // Delete obsolete files
         for (const file of OBSOLETE_FILES) {
             const filePath = join(specDir, file);

package/dist/engine/spec-migrator/planu-root-cleaner.js

@@ -14,7 +14,7 @@ const CANONICAL_ROOT_FILES = new Set([
 /** Directories allowed in planu/ root. */
 const CANONICAL_ROOT_DIRS = new Set(['specs']);
 /** Files allowed inside each planu/specs/SPEC-XXX/ directory. */
-const CANONICAL_SPEC_FILES = new Set(['spec.md', 'technical.md']);
+const CANONICAL_SPEC_FILES = new Set(['spec.md']);
 /** Remove a file from git tracking (best-effort, silent if not a git repo or file not tracked). */
 function gitRmCached(absolutePath, cwd) {
     try {

package/dist/engine/spec-registry/packager.d.ts

@@ -1,6 +1,6 @@
 /**
  * Pack a spec directory into a gzipped archive buffer.
- * Only includes recognized spec files (spec.md, technical.md, progress.md, planu-registry.json).
+ * Only includes recognized spec files (spec.md, planu-registry.json).
  * @param specDir - Absolute path to the spec directory.
  * @returns Gzipped buffer containing the archived spec files.
  */

package/dist/engine/spec-registry/packager.js

@@ -10,10 +10,10 @@ const gunzipAsync = promisify(gunzip);
 /** Maximum package size in bytes (500 KB). */
 const MAX_PACKAGE_SIZE = 500 * 1024;
 /** Files that may be included in a spec package. */
-const ALLOWED_FILES = ['spec.md', 'technical.md', 'progress.md', 'planu-registry.json'];
+const ALLOWED_FILES = ['spec.md', 'planu-registry.json'];
 /**
  * Pack a spec directory into a gzipped archive buffer.
- * Only includes recognized spec files (spec.md, technical.md, progress.md, planu-registry.json).
+ * Only includes recognized spec files (spec.md, planu-registry.json).
  * @param specDir - Absolute path to the spec directory.
  * @returns Gzipped buffer containing the archived spec files.
  */

package/dist/engine/spec-registry/validator.js

@@ -7,8 +7,7 @@ const MAX_TOTAL_SIZE = 500 * 1024;
 /** Semver regex (simplified: major.minor.patch with optional pre-release). */
 const SEMVER_RE = /^\d+\.\d+\.\d+(-[\w.]+)?$/;
 /** Required files in a publishable spec directory. */
-// SPEC-461: Lean format — only 2 required files (no progress.md)
-const REQUIRED_FILES = ['spec.md', 'technical.md'];
+const REQUIRED_FILES = ['spec.md'];
 /** Required fields in the planu-registry.json manifest. */
 const REQUIRED_MANIFEST_FIELDS = [
     'name',