@planu/cli 3.9.11 → 3.9.13

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,9 +20,7 @@ set -euo pipefail
 # ---------------------------------------------------------------------------
 ALLOWED_FILES=(
   "spec.md"
-  "technical.md"
   "progress.json"
-  "implementation-brief.md"
 )
 
 # ---------------------------------------------------------------------------
@@ -79,6 +77,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 +102,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, implementation-brief.md, prompt.md,
+risk-register.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/bootstrap.js

@@ -24,140 +24,6 @@ function registerSessionContextFreshnessListener() {
         })();
     });
 }
-/**
- * SPEC-586: Fire-and-forget implementation-brief generation + impact detector
- * on spec:status:approved. Errors are silently logged and never block the parent tool.
- */
-function registerImplementationReadyListener() {
-    onAutopilotEvent('spec:status:approved', (event) => {
-        if (!event.specId) {
-            return;
-        }
-        const { specId, projectPath, projectId } = event;
-        void (async () => {
-            try {
-                const { glob } = await import('glob');
-                const [specFiles, techFiles] = await Promise.all([
-                    glob(`planu/specs/${specId}-*/spec.md`, { cwd: projectPath, absolute: true }),
-                    glob(`planu/specs/${specId}-*/technical.md`, { cwd: projectPath, absolute: true }),
-                ]);
-                const specPath = specFiles[0];
-                const technicalPath = techFiles[0];
-                if (!specPath) {
-                    return;
-                }
-                const { readFile } = await import('node:fs/promises');
-                const specBody = await readFile(specPath, 'utf-8').catch(() => '');
-                const tagsMatch = /^tags:\s*\[([^\]]*)\]/m.exec(specBody);
-                const targetMatch = /^target:\s*(.+)$/m.exec(specBody);
-                const scopeMatch = /^scope:\s*(.+)$/m.exec(specBody);
-                const tags = tagsMatch?.[1] !== undefined
-                    ? tagsMatch[1].split(',').map((t) => t.trim().replace(/^["']|["']$/g, ''))
-                    : [];
-                const target = targetMatch?.[1]?.trim() ?? 'backend';
-                const scope = scopeMatch?.[1]?.trim() ?? 'cross-module';
-                void projectId;
-                const { generateImplementationBrief } = await import('../implementation-brief/generator.js');
-                generateImplementationBrief({
-                    specId,
-                    specPath,
-                    projectPath,
-                    description: specBody,
-                    tags,
-                    target,
-                    scope,
-                }).catch((err) => {
-                    const msg = err instanceof Error ? err.message : String(err);
-                    console.error(`[autopilot] implementation-brief failed for ${specId}: ${msg}`);
-                });
-                if (technicalPath) {
-                    const { runImpactDetector } = await import('../impact-detector/index.js');
-                    runImpactDetector({
-                        specId,
-                        specPath,
-                        technicalPath,
-                        projectPath,
-                    }).catch((err) => {
-                        const msg = err instanceof Error ? err.message : String(err);
-                        console.error(`[autopilot] impact-detector failed for ${specId}: ${msg}`);
-                    });
-                }
-            }
-            catch {
-                /* best-effort — never surface to user */
-            }
-        })();
-    });
-}
-/**
- * SPEC-627: Fire-and-forget risk-register generation on spec:status:approved.
- * Writes planu/specs/SPEC-XXX/risk-register.md from spec metadata.
- */
-function registerRiskAnalyzerListener() {
-    onAutopilotEvent('spec:status:approved', (event) => {
-        if (!event.specId) {
-            return;
-        }
-        const { specId, projectPath } = event;
-        void (async () => {
-            try {
-                const { glob } = await import('glob');
-                const specFiles = await glob(`planu/specs/${specId}-*/spec.md`, { cwd: projectPath, absolute: true });
-                const specPath = specFiles[0];
-                if (!specPath) {
-                    return;
-                }
-                const { readFile, writeFile } = await import('node:fs/promises');
-                const specBody = await readFile(specPath, 'utf-8');
-                const typeMatch = /^type:\s*(.+)$/m.exec(specBody);
-                const scopeMatch = /^scope:\s*(.+)$/m.exec(specBody);
-                const difficultyMatch = /^difficulty:\s*(\d+)/m.exec(specBody);
-                const riskMatch = /^risk:\s*(.+)$/m.exec(specBody);
-                const tagsMatch = /^tags:\s*\[([^\]]*)\]/m.exec(specBody);
-                const tags = tagsMatch?.[1] !== undefined
-                    ? tagsMatch[1].split(',').map((t) => t.trim().replace(/^["']|["']$/g, ''))
-                    : [];
-                const { generateRiskRegister } = await import('../risk-analyzer/risk-generator.js');
-                const rawDifficulty = parseInt(difficultyMatch?.[1] ?? '2', 10);
-                const difficulty = (rawDifficulty >= 1 && rawDifficulty <= 5 ? rawDifficulty : 2);
-                const rawRisk = riskMatch?.[1]?.trim() ?? 'low';
-                const riskLevel = (['low', 'medium', 'high', 'critical'].includes(rawRisk) ? rawRisk : 'low');
-                const ctx = {
-                    specId,
-                    title: specId,
-                    type: (typeMatch?.[1]?.trim() ?? 'feature'),
-                    scope: (scopeMatch?.[1]?.trim() ?? 'feature'),
-                    difficulty,
-                    risk: riskLevel,
-                    tags,
-                    language: 'TypeScript',
-                    framework: null,
-                    dependencyCount: 0,
-                    fileCount: 0,
-                };
-                const register = generateRiskRegister(ctx);
-                const lines = [
-                    `# Risk Register — ${specId}`,
-                    `_Generated ${new Date().toISOString()}_`,
-                    '',
-                    `**Aggregate score:** ${register.aggregateRiskScore}/100`,
-                    '',
-                    '## Risks',
-                ];
-                for (const r of register.risks) {
-                    lines.push(`- **${r.category}** (${r.probability}% probability, ${r.impactDays}d impact): ${r.description}`);
-                    lines.push(`  Mitigation: ${r.mitigationPlan}`);
-                }
-                const { dirname, join } = await import('node:path');
-                const registerPath = join(dirname(specPath), 'risk-register.md');
-                await writeFile(registerPath, lines.join('\n'), 'utf-8');
-            }
-            catch {
-                /* best-effort — never surface to user */
-            }
-        })();
-    });
-}
 /**
  * SPEC-600: Fire-and-forget cascade on approved→implementing.
  * Auto-recommends model + generates orchestration plan for complex specs.
@@ -260,10 +126,6 @@ export function bootstrapAutopilotHandlers() {
     }
     // SPEC-585: Register session-context freshness listener
     registerSessionContextFreshnessListener();
-    // SPEC-586: Register implementation-brief + impact-detector on spec:status:approved
-    registerImplementationReadyListener();
-    // SPEC-627: Register risk-register generator on spec:status:approved
-    registerRiskAnalyzerListener();
     // SPEC-600: Register cascade listener for implementing transition
     // SPEC-649: registerDoneCascadeListener removed — optimize_context no longer auto-runs on done
     registerImplementingCascadeListener();

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/housekeeping/ephemeral-artifacts-cleaner.d.ts

@@ -1,7 +1,7 @@
 import type { EphemeralArtifactsResult, CleanEphemeralArtifactsInput } from '../../types/housekeeping.js';
 /**
- * Scan all planu/specs/SPEC-* directories. For each spec whose status is
- * `done` or `discarded`, delete (or report) the ephemeral artifact files.
+ * Scan all planu/specs/SPEC-* directories and delete (or report) obsolete
+ * sidecar artifact files.
  */
 export declare function cleanEphemeralArtifacts(input: CleanEphemeralArtifactsInput): Promise<EphemeralArtifactsResult>;
 //# sourceMappingURL=ephemeral-artifacts-cleaner.d.ts.map