mddd-cli 4.1.2 → 4.2.0

package/bin/cli.js

@@ -17,7 +17,7 @@ const program = new Command();
 program
   .name('md')
   .description('Manager for co-located specifications for Mermaid Diagram Driven Development (MDDD)')
-  .version('4.1.2');
+  .version('4.2.0');
 
 // ==========================================
 // COMMAND: md init

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mddd-cli",
-  "version": "4.1.2",
+  "version": "4.2.0",
   "description": "Official CLI for modular, co-located, and versioned Mermaid Diagram Driven Development (MDDD).",
   "type": "module",
   "exports": "./bin/cli.js",
@@ -8,7 +8,6 @@
     "md": "./bin/cli.js"
   },
   "files": [
-    "bin",
     "src",
     "system_prompt.md"
   ],
@@ -23,6 +22,8 @@
     "mermaid",
     "md",
     "ai",
+    "sdd",
+    "spec-driven",
     "diagram-driven",
     "architecture",
     "cli",
@@ -39,7 +40,7 @@
   },
   "homepage": "https://github.com/JulioCRFilho/mermaid-diagram-driven-development#readme",
   "dependencies": {
-    "@mermaid-js/parser": "^1.1.1",
+    "@mermaid-js/mermaid-cli": "github:mermaid-js/mermaid-cli",
     "commander": "^12.0.0",
     "picocolors": "^1.0.0"
   }

package/src/commands/init.js

@@ -5,23 +5,8 @@ import { fileURLToPath } from 'node:url';
 import path from 'node:path';
 import pc from 'picocolors';
 
-import mdNewContent from '../skills/md-new/content.js';
-import mdEditContent from '../skills/md-edit/content.js';
-import mdAuditContent from '../skills/md-audit/content.js';
-import mdImplContent from '../skills/md-impl/content.js';
 import { GITHUB_WORKFLOW_CONTENT } from '../workflows/mddd-preview.yml.js';
 
-/**
- * Build the SKILLS map from co-located modules.
- * @type {Record<string, string>}
- */
-const SKILLS = {
-  'md-new': mdNewContent,
-  'md-edit': mdEditContent,
-  'md-audit': mdAuditContent,
-  'md-impl': mdImplContent,
-};
-
 /**
  * Resolve and read system_prompt.md from the project root.
  * @returns {string}
@@ -41,8 +26,15 @@ function readSystemPrompt() {
 export async function execute(initService) {
   const systemPrompt = readSystemPrompt();
 
+  // Descobre o caminho absoluto real da pasta interna de templates de skills da CLI
+  const currentFile = fileURLToPath(import.meta.url);
+  const cliSkillsSourceDir = path.resolve(path.dirname(currentFile), '..', 'skills');
+
   await initService.createSystemPrompt(systemPrompt);
-  await initService.createSkills(SKILLS, (msg) => console.log(msg));
+  
+  // Passa o caminho da pasta de origem em vez do mapa de strings antigas
+  await initService.createSkills(cliSkillsSourceDir, (msg) => console.log(msg));
+  
   await initService.createGitHubWorkflow(GITHUB_WORKFLOW_CONTENT, (msg) => console.log(msg));
 
   console.log(pc.green('\n🚀 Universal [system_prompt.md] and SKILLS generated successfully in the project root!'));

package/src/commands/validator.js

@@ -1,56 +1,22 @@
-import { parse } from '@mermaid-js/parser';
+import { exec } from 'node:child_process';
 import fs from 'node:fs';
+import path from 'node:path';
+import { promisify } from 'node:util';
+
+const execAsync = promisify(exec);
 
 function extractMermaidBlocks(text) {
   const regex = /```mermaid\s*([\s\S]*?)\s*```/g;
   const blocks = [];
   let match;
-  
   while ((match = regex.exec(text)) !== null) {
     if (match[1].trim()) {
       blocks.push(match[1].trim());
     }
   }
-  
   return blocks;
 }
 
-/**
- * Normaliza quebras de linha, remove TODOS os tipos de espaços Unicode fantasmas
- * e elimina comentários/linhas vazias do topo antes do tipo de diagrama.
- * @param {string} code 
- * @returns {string}
- */
-function cleanDiagramCode(code) {
-  // 1. Unifica todas as quebras de linha possíveis (\r\n ou \r isolado) para \n
-  const uniformLines = code.replace(/\r\n|\r/g, '\n');
-
-  // 2. Divide em linhas para processar o topo do arquivo
-  const lines = uniformLines.split('\n');
-  const cleanedLines = [];
-  let foundTypeDeclaration = false;
-
-  for (const line of lines) {
-    // Substitui todos os tipos conhecidos de espaços em branco Unicode invisíveis por espaços comuns
-    // (\u00A0 é o NBSP, \u2000-\u200A são variantes de espaçamento tipográfico)
-    let normalizedLine = line.replace(/[\u00A0\u2000-\u200A\u202F\u205F\u3000]/g, ' ');
-    
-    const trimmed = normalizedLine.trim();
-    
-    // Ignora linhas vazias ou comentários iniciais até achar a declaração do diagrama
-    if (!foundTypeDeclaration && (trimmed === '' || trimmed.startsWith('%%'))) {
-      continue; 
-    }
-    
-    foundTypeDeclaration = true;
-    
-    // Mantém a linha com os espaços normais restaurados (importante para a indentação dos blocos do Mermaid)
-    cleanedLines.push(normalizedLine);
-  }
-
-  return cleanedLines.join('\n').trim();
-}
-
 export async function validateMermaidSyntax(input) {
   let content = input;
 
@@ -65,28 +31,49 @@ export async function validateMermaidSyntax(input) {
     if (diagramsToValidate.length === 0) {
       return {
         valid: false,
-        error: "Nenhum bloco de código '```mermaid' estruturado foi encontrado."
+        error: "Nenhum bloco '```mermaid' encontrado no arquivo."
       };
     }
   }
 
+  const tempInputPath = path.join(process.cwd(), `.temp_validate_${Date.now()}.mmd`);
+  const tempOutputPath = path.join(process.cwd(), `.temp_validate_${Date.now()}.svg`);
+
   try {
-    const cleanedDiagrams = [];
-    
+    const validatedDiagrams = [];
+
     for (const diagramCode of diagramsToValidate) {
-      const readyCode = cleanDiagramCode(diagramCode);
-      await parse(readyCode); // Se tiver espaço fantasma aqui, o parser agora aceita!
-      cleanedDiagrams.push(readyCode);
+      fs.writeFileSync(tempInputPath, diagramCode, 'utf-8');
+
+      // AJUSTE AQUI: Explicitamos o pacote (-p) e chamamos o executável real (mmdc)
+      await execAsync(`npx -p @mermaid-js/mermaid-cli mmdc -i "${tempInputPath}" -o "${tempOutputPath}"`);
+
+      if (fs.existsSync(tempOutputPath)) {
+        fs.unlinkSync(tempOutputPath);
+      }
+      
+      validatedDiagrams.push(diagramCode);
     }
-    
+
+    if (fs.existsSync(tempInputPath)) {
+      fs.unlinkSync(tempInputPath);
+    }
+
     return { 
       valid: true, 
-      diagrams: cleanedDiagrams 
+      diagrams: validatedDiagrams 
     };
+
   } catch (error) {
+    if (fs.existsSync(tempInputPath)) fs.unlinkSync(tempInputPath);
+    if (fs.existsSync(tempOutputPath)) fs.unlinkSync(tempOutputPath);
+
+    // Captura o erro real de compilação enviado pelo compilador do Mermaid
+    const errorMessage = error.stderr || error.message || 'Erro de validação desconhecido no Mermaid.';
+
     return {
       valid: false,
-      error: error.message || 'Erro de sintaxe desconhecido no Mermaid.'
+      error: errorMessage.trim()
     };
   }
 }

package/src/services/InitService.js

@@ -1,3 +1,4 @@
+import fs from 'node:fs';
 import path from 'node:path';
 
 /**
@@ -24,31 +25,37 @@ export class InitService {
   }
 
   /**
-   * Creates all skill folders and SKILL.md files.
-   * @param {Record<string, string>} skills - Map of skill name to skill content
+   * Copies all real skill folders and files to .agents/skills/.
+   * @param {string} sourceSkillsDir - Absolute path to the CLI source skills template folder
    * @param {(message: string) => void} logger
-   * @returns {Promise<string[]>} Array of file paths created
+   * @returns {Promise<void>}
    */
-  async createSkills(skills, logger) {
+  async createSkills(sourceSkillsDir, logger) {
     const agentsDir = '.agents';
-    const skillsDir = path.join(agentsDir, 'skills');
+    const targetSkillsDir = path.join(agentsDir, 'skills');
 
+    // Garante a existência da árvore de diretórios base no destino
     this.#fs.ensureDir(agentsDir);
-    this.#fs.ensureDir(skillsDir);
+    this.#fs.ensureDir(targetSkillsDir);
 
-    const created = [];
+    if (!fs.existsSync(sourceSkillsDir)) {
+      throw new Error(`Source skills template directory not found at: ${sourceSkillsDir}`);
+    }
 
-    for (const [skillName, content] of Object.entries(skills)) {
-      const skillFolder = path.join(skillsDir, skillName);
-      this.#fs.ensureDir(skillFolder);
+    // Copia de forma real, recursiva e idêntica todas as pastas de skills
+    // Mantém estruturas complexas como a da sua skill 'mermaid-diagrams' (com subpastas references/, readme.md, etc)
+    fs.cpSync(sourceSkillsDir, targetSkillsDir, {
+      recursive: true,
+      force: true
+    });
 
-      const skillFile = path.join(skillFolder, 'SKILL.md');
-      await this.#fs.writeFile(skillFile, content);
-      created.push(skillFile);
-      logger(`✅ Skill successfully encapsulated: ${skillFile}`);
+    // Lista as pastas copiadas apenas para dar um feedback limpo no console
+    const copiedSkills = fs.readdirSync(targetSkillsDir);
+    for (const skillName of copiedSkills) {
+      if (fs.statSync(path.join(targetSkillsDir, skillName)).isDirectory()) {
+        logger(`✅ Skill successfully encapsulated: ${path.join(targetSkillsDir, skillName)}`);
+      }
     }
-
-    return created;
   }
 
   /**

package/system_prompt.md

@@ -1,6 +1,7 @@
 # Mermaid Diagram Driven Development (MDDD) Protocol
 
 You are a Mermaid Diagram processing system. Your cognitive processing is guided by visual topologies and truth tables, eliminating text-based specification ambiguity.
+Consume the mermaid-diagrams skill to learn how to produce it.
 
 ```mermaid
 %% @spec-version v2.0.0

package/bin/cli.spec.md

@@ -1,73 +0,0 @@
-# CLI Module | v4.2.1 (Stable)
-
-## 1. Flow Contract (Mermaid)
-
-### 1.1 Topologia Atual (As-Is)
-
-```mermaid
-%% @spec-version v4.2.1
-graph TD
-    subgraph "CLI Entry (bin/cli.js)"
-        A[bin/cli.js: Commander Router] --> B[delegate to ./commands/init.js]
-    end
-
-    subgraph "Commands Layer"
-        B --> C[InitService.createSystemPrompt]
-        B --> D[InitService.createSkills]
-    end
-
-    subgraph "Shared Services"
-        C --> E[FileSystemService.writeFile]
-        D --> E
-        E --> F[fs/promises]
-    end
-
-    subgraph "External Dependencies"
-        F --> G["@mermaid-js/mermaid-cli"]
-    end
-```
-
-O diagrama acima reflete a arquitetura final e estável pós-refatoração: separação clara entre CLI Entry, Commands Layer e Shared Services, com injeção de dependência do `FileSystemService`. O `@mermaid-js/mermaid-cli` é uma dependência externa instalada junto com o pacote para renderização de diagramas Mermaid.
-
-## 2. Decision Matrix
-
-| Código Atual | Co-located `.spec.md` Exists? | Design Assessment | Ação de Implementação | Manipulação de Código Permitida? | Versão Inicial |
-| :--- | :---: | :---: | :--- | :---: | :---: |
-| `bin/cli.js` (37 linhas) | ✅ YES | Clean / CLI Entry | Delega para `src/commands/init.js` | ✅ **ALLOW** | `v1.0.0` |
-| `src/commands/init.js` | ✅ YES | Modular / Co-located | Contém prompts + delega para `InitService` | ✅ **ALLOW** | `v3.0.0` |
-| `src/services/InitService.js` | ✅ YES | Clean / Service | Orquestra criação de system_prompt e skills | ✅ **ALLOW** | `v3.0.0` |
-| `src/services/FileSystemService.js` | ✅ YES | Clean / Service | Abstrai `fs/promises` com DI | ✅ **ALLOW** | `v3.0.0` |
-| `@mermaid-js/mermaid-cli` | N/A | External Dependency | Renderização de diagramas Mermaid via CLI | ✅ **ALLOW** | `v4.2.0` |
-
-### Fatores Primitivos de Qualidade
-
-| Fator | Valor | Impacto |
-| :--- | :---: | :--- |
-| CLI Entry desacoplado? | ✅ YES | `bin/cli.js` com 37 linhas, apenas Commander + delegação |
-| Lógica de template co-localizada? | ✅ YES | `SYSTEM_PROMPT_CONTENT` e `SKILLS` em `src/commands/init.js` |
-| Separação CLI/Business? | ✅ YES | Camadas bem definidas: CLI → Commands → Services |
-| Serviços com injeção de dependência? | ✅ YES | `FileSystemService` aceita mock no construtor |
-| Código testável? | ⚠️ PARCIAL | Serviços são testáveis; `bin/cli.js` não exporta funções |
-| Escopo reduzido? | ✅ YES | Apenas comando `init` — comandos removidos foram eliminados |
-
-## 3. Audit History
-
-<details>
-<summary>Click to expand</summary>
-
-| Data | Auditor | Versão | Resumo das Mudanças |
-| :--- | :--- | :---: | :--- |
-| 2026-05-27 | MDDD-Audit Agent (Cline) | v1.0.0 | Auditoria inicial. Código classificado como **Caótico/Acoplado**. Diagrama As-Is documenta a topologia real (monolítica). Diagrama To-Be propõe separação em Commands Layer + Shared Services + Template Engine + Testes. Decisão de imutabilidade: código de produção não foi modificado. |
-| 2026-05-27 | Cline (Agent-Actor) | v2.0.0 | **MAJOR Mutation (v1.0.0 → v2.0.0):** Aprovada refatoração estrutural do monolito `bin/cli.js` (421 linhas) para arquitetura modular: Commands Layer (`src/commands/*.js`) + Shared Services (`src/services/*.js`) + Template Engine (`src/services/TemplateFactory.js`) + Unit Tests. Removida restrição FORBIDDEN (Immutability). Diagrama To-Be promovido a alvo de implementação oficial. |
-| 2026-05-27 | Cline (Agent-Actor) | v3.0.0 | **MAJOR Mutation (v2.0.0 → v3.0.0):** Removidos comandos `new`, `edit`, `audit` e `impl` do escopo do CLI. Diagramas As-Is e To-Be simplificados para refletir apenas o comando `init` restante. Matriz de decisão e fatores de acoplamento atualizados. |
-| 2026-05-28 | Cline (Agent-Actor) | v4.0.0 | **MAJOR Mutation (v3.0.0 → v4.0.0):** Refatoração concluída e estabilizada. Diagrama As-Is e To-Be unificados em um único diagrama estável refletindo a arquitetura real: `bin/cli.js` (37 linhas) → `src/commands/init.js` → `src/services/InitService.js` + `src/services/FileSystemService.js`. Título alterado de "Refactoring Plan" para "CLI Module (Stable)". Matriz de decisão e fatores de qualidade atualizados para refletir o estado modular final. |
-| 2026-05-28 | Cline (md-audit) | v4.1.0 | **MINOR Mutation (v4.0.0 → v4.1.0):** Criados specs faltantes `src/services/FileSystemService.spec.md` e `src/services/InitService.spec.md` via `md-audit`. A Matriz de Decisão, que já declarava ✅ `YES` para ambos, agora reflete a realidade do filesystem. Nenhuma alteração em código de produção. |
-| 2026-05-30 | Cline (Agent-Actor) | v4.2.0 | **MINOR Mutation (v4.1.0 → v4.2.0):** Adicionado `@mermaid-js/mermaid-cli@^11.15.0` como dependência no `package.json`. Diagrama atualizado para incluir o subgraph "External Dependencies" com referência ao mermaid-cli. Matriz de decisão estendida com linha para a dependência externa. |
-| 2026-05-30 | Cline (Agent-Actor) | v4.2.1 | **PATCH Mutation (v4.2.0 → v4.2.1):** Adicionado `system_prompt.md` ao campo `"files"` no `package.json` para resolver erro `ENOENT` ao executar `md init` com instalação global via npm. |
-
-### Análise de Qualidade
-
-- **Acoplamento**: ✅ **BAIXO** — CLI Entry com 37 linhas delega para Commands Layer; Services são independentes com DI.
-- **Coesão**: ✅ **ALTA** — Cada módulo tem responsabilidade única e bem definida.
-- **Testabilidade**: ⚠️ **PARCIAL** — `InitService` e `FileSystemService` são testáveis via injeção de dependência; `bin/cli.js` permanece sem exportações para teste unitário.
-- **Manutenibilidade**: ✅ **ALTA** — Arquitetura limpa com 3 camadas claras e escopo reduzido a apenas `init`.

package/src/skills/md-audit/content.js

@@ -1,54 +0,0 @@
-export default `[ROLE: SECURITY & QUALITY AUDITOR] [STRICT CONTRACT]
-
-\`\`\`mermaid
-%% @spec-version v1.3.2
-stateDiagram-v2
-    [*] --> Evaluation: Quality Assessment.
-    Evaluation --> MakeSpec: Co-located .spec.md.
-
-    state MakeSpec {
-        [*] --> SpecExists: Check for existing .spec.md.
-        SpecNotFound --> CreateSpec: Create .spec.md from "src/templates/spec-template.md".
-        SpecExists --> Break: Audit only.
-        Break --> [*]
-    }
-    
-    CreateSpec --> RenderTopology: Create new co-located .spec.md.
-    
-    state RenderTopology {
-        [*] --> CheckCode: Analyze current code structure and dependencies
-        CheckCode --> EvaluatedCodeIsClean: Map exact architecture as-is (v1.0.0 - stable)
-        CheckCode --> EvaluatedCodeIsChaotic: Draw BOTH current chaotic logic AND ideal target refactored graph (v1.0.0 - draft)
-    }
-    
-    RenderTopology --> CheckDiagram: Use "npx md validate <path/to/spec.md>" to validate diagram syntax
-
-    state CheckDiagram {
-        [*] --> DiagramValid: Proceed to next step
-        DiagramInvalid --> RenderTopology: Re-render until valid
-    }
-
-    CheckDiagram --> DiscoveryAnalysis: Identify potential vulnerabilities and code quality issues
-    DiscoveryAnalysis --> WriteToAuditTag: Document findings and recommendations in the .spec.md file
-    WriteToAuditTag: Inject payloads inside <details> block
-    WriteToAuditTag --> EnforceImmutability: Lock Production Code File
-    EnforceImmutability --> [*]
-\`\`\`
-
-\`\`\`mermaid
-%% @spec-version v1.3.0
-%% Decision Matrix for EvaluatedCodeIsClean vs EvaluatedCodeIsChaotic
-flowchart TD
-    M[Measure Cyclomatic Complexity] --> A{Aggregate Results}
-    C[Measure Module Coupling] --> A
-    H[Measure Module Cohesion LCOM] --> A
-    V[Count Lint/Code Violations] --> A
-
-    A -->|Complexity < 10 AND Coupling < 3 AND Cohesion > 0.9 AND Violations == 0| Clean[EvaluatedCodeIsClean]
-    A -->|Complexity >= 10 OR Coupling >= 3 OR Cohesion <= 0.9 OR Violations > 0| Chaotic[EvaluatedCodeIsChaotic]
-
-    style Clean fill:#1b5e20,color:#fff
-    style Chaotic fill:#b71c1c,color:#fff
-\`\`\`
-
-`;

package/src/skills/md-edit/content.js

@@ -1,74 +0,0 @@
-export default `[ROLE: ARCHITECT] [STRICT CONTRACT]
-
-\`\`\`mermaid
-%% @spec-version v1.3.1
-stateDiagram-v2
-    [*] --> Read TargetSpec: Read Target .spec.md
-    Read TargetSpec --> ParseVersion: Parse Current SPEC_VERSION
-    ParseVersion --> ApplyAdjustments: Apply requested Mermaid/Matrix Adjustments
-    ApplyAdjustments --> EvaluateScope: Evaluate Mutation Scope
-
-    state EvaluateScope {
-        [*] --> TypoFix: Typo / Label Fix
-        [*] --> NewNode: New Node / Flow Path / Factor
-        [*] --> BreakingChange: Breaking Overhaul / Restructure
-    }
-    
-    EvaluateScope --> IncrementVersion: Increment Version Based on Scope
-
-    state IncrementVersion {
-        [*] --> IncrementPatch: Increment Patch: Bump Z in X.Y.Z
-        [*] --> IncrementMinor: Increment Minor: Bump Y in X.Y.Z
-        [*] --> IncrementMajor: Increment Major: Bump X in X.Y.Z
-    }
-
-    IncrementVersion --> CheckDiagram: Use "npx md validate <path/to/spec.md>" to validate diagram syntax
-
-    state CheckDiagram {
-        [*] --> TryRender
-        TryRender --> DiagramValid: Render succeeded
-        TryRender --> IncrementRetry: Render failed
-        IncrementRetry --> TryRender: Retry count < 5
-        IncrementRetry --> RenderFailed: Retry count >= 5
-    }
-        
-    CheckDiagram --> WriteToFile: Write validated .spec.md to target path
-    WriteToFile --> VerifyWrite
-    state VerifyWrite {
-        [*] --> WriteSuccess: File written successfully
-        [*] --> WriteError: File write failed (permissions / disk / path)
-    }
-    WriteError --> AwaitHumanReview: Error: manual intervention required
-
-    WriteSuccess --> DiscoveryAnalysis: Identify potential vulnerabilities and code quality issues
-    DiscoveryAnalysis --> AwaitHumanReview: Flag discovered issues for human review
-    RenderFailed --> AwaitHumanReview: Error: Mermaid CLI validation failed after 5 attempts
-
-    state AwaitHumanReview {
-        [*] --> Approved: Resume CI/CD pipeline
-        [*] --> ChangesRequested: Loop back to ApplyAdjustments
-        [*] --> Aborted: Terminate session
-    }
-    
-    AwaitHumanReview --> [*]: Pause Code & Test Generation
-\`\`\`
-
-\`\`\`mermaid
-%% @spec-version v1.3.0
-%% Decision Matrix for EvaluateScope: TypoFix vs NewNode vs BreakingChange
-flowchart TD
-    M[Mutation Request Contains...] --> A{Evaluate Factors}
-
-    T[Only label / text changes] --> A
-    N[New states / flows / factors added] --> A
-    B[Existing states / flows removed or restructured] --> A
-
-    A -->|"T == true AND N == false AND B == false"| Patch[TypoFix → IncrementPatch]
-    A -->|"N == true AND B == false"| Minor[NewNode → IncrementMinor]
-    A -->|"B == true"| Major[BreakingChange → IncrementMajor]
-
-    style Patch fill:#1b5e20,color:#fff
-    style Minor fill:#0d47a1,color:#fff
-    style Major fill:#b71c1c,color:#fff
-\`\`\`
-`;

package/src/skills/md-impl/content.js

@@ -1,87 +0,0 @@
-export default `[ROLE: SOFTWARE ENGINEER] [STRICT CONTRACT]
-
-\`\`\`mermaid
-%% @spec-version v1.3.1
-stateDiagram-v2
-    state ImplWorkflow {
-        [*] --> IngestSpec: [Inherits Parent Context] Ingest Signed .spec.md
-        IngestSpec --> ParseVersion: Parse Matrix Rows & Version Header
-        ParseVersion --> VerifyRequest: Verify Code/Chat Request Against Decision Matrix
-        VerifyRequest -->|Matches 100%| CheckTarget: Check File Target State
-        VerifyRequest -->|Human Asks to Skip/Add Extraneous Scope| TriggerDefense: Trigger Prompt Injection Defense
-
-        CheckTarget -->|New File| GenerateCode: Generate Full Structural Code from Scratch
-        CheckTarget -->|Existing File| IdempotentOverwrite: Idempotent Overwrite - Read & Output Full File
-        
-        GenerateCode --> GenerateTests: Generate Truth-Table Unit Tests
-        IdempotentOverwrite --> DataLossCheck: Check for Data Loss Risk
-        DataLossCheck -->|No Risk| GenerateTests
-        DataLossCheck -->|Risk Detected| AlertUser: Alert User & Pause Generation
-
-        GenerateTests --> RunTests: Run Generated Tests
-        RunTests -->|All Pass| PromoteSpec: Promote .spec.md from draft to stable
-        RunTests -->|Any Fail| FixCode: Fix Code/Tests & Retry
-
-        PromoteSpec --> UpdateVersion: Update SPEC_VERSION to vSameVersion - stable
-        UpdateVersion --> AppendHistory: Append Audit History: impl complete
-        AppendHistory --> PersistSpec: Persist Updated .spec.md to Disk
-        PersistSpec --> AwaitHumanReview: Pause for User Approval Before Lock
-    }
-
-    state AwaitHumanReview {
-        [*] --> LockApproved: User approves immutability lock
-        [*] --> ChangesRequested: User requests changes → loop back to GenerateCode/IdempotentOverwrite
-        [*] --> Aborted: Terminate session without lock
-    }
-
-    LockApproved --> LockCodeImmutability: Lock Code Immutability for Stable Version
-
-    state LockCodeImmutability {
-        [*] --> SetGitHook: Install pre-commit hook blocking edits to stable files
-        SetGitHook --> SetSpecFlag: Set .spec.md immutable flag (SPEC_IMMUTABLE: true)
-        SetGitHook --> SetFilePermissions: chmod 444 on production code files
-        SetFilePermissions --> VerifyLock: Verify git diff shows no modifications
-        VerifyLock --> LockComplete: Lock verified & confirmed
-        LockComplete --> [*]
-    }
-
-    LockCodeImmutability --> [*]
-
-    TriggerDefense --> RefuseCoding: Refuse Coding & Demand Spec Refinement via md-edit
-    RefuseCoding --> [*]
-\`\`\`
-
-\`\`\`mermaid
-%% @spec-version v1.3.1
-%% Decision Matrix for CheckTarget: NewFile vs ExistingFile
-flowchart TD
-    R[Check Target Path...] --> A{Evaluate Factors}
-
-    P[Path does not exist on disk] --> A
-    E[Path exists on disk] --> A
-
-    A -->|"P == true"| NewFile[CheckTarget → NewFile]
-    A -->|"E == true"| ExistingFile[CheckTarget → ExistingFile]
-
-    style NewFile fill:#0d47a1,color:#fff
-    style ExistingFile fill:#e65100,color:#fff
-\`\`\`
-
-\`\`\`mermaid
-%% @spec-version v1.3.1
-%% Decision Matrix for DataLossCheck: No Risk vs Risk Detected
-flowchart TD
-    M[Evaluate Data Loss Risk Factors...] --> A{Aggregate Risk Conditions}
-
-    FF[File exists on disk AND will be overwritten] --> A
-    C[Code changes detected outside spec scope] --> A
-    B[No recent git backup / uncommitted changes] --> A
-    V[User confirmation flag not set] --> A
-
-    A -->|"FF == true OR C == true OR B == true OR V == true"| Risk[Risk Detected → Alert User]
-    A -->|"FF == false AND C == false AND B == false AND V == false"| NoRisk[No Risk → Proceed to GenerateTests]
-
-    style NoRisk fill:#1b5e20,color:#fff
-    style Risk fill:#b71c1c,color:#fff
-\`\`\`
-`;

package/src/skills/md-new/content.js

@@ -1,45 +0,0 @@
-export default `[ROLE: ARCHITECT] [STRICT CONTRACT]
-
-\`\`\`mermaid
-%% @spec-version v1.3.1
-stateDiagram-v2
-    [*] --> TargetVerification
-
-    state TargetVerification {
-        [*] --> CheckFileExistence: Does .spec.md already exist at target path?
-        FileExists --> Break: Existing .specs are immutable. Switch to edit mode.
-        FileNotFound --> EvaluateContext: File Does Not Exist
-    }
-
-    state EvaluateContext {
-        [*] --> DeepAnalysis: Evaluate target context and goal
-        DeepAnalysis --> DiagramTypeInference: Infer appropriate diagram type and template
-        DiagramTypeInference --> InferNodes: Identify key nodes and relationships to be represented
-    }
-
-    EvaluateContext --> GenerateBlueprint: Create .spec.md from "src/templates/spec-template.md".
-    GenerateBlueprint --> FormatSpecOutput: Format blueprint into target .spec.md structure
-    FormatSpecOutput --> CheckDiagram: Use "npx md validate <path/to/spec.md>" to validate diagram syntax
-
-    state CheckDiagram {
-        [*] --> DiagramValid: Proceed to next step
-        DiagramInvalid --> GenerateBlueprint: Re-generate blueprint with adjustments until valid
-    }
-        
-    CheckDiagram --> WriteToFile: Write validated .spec.md to target path
-    WriteToFile --> InitializeVersion: Set initial SPEC_VERSION
-
-    state InitializeVersion {
-        [*] --> SetDraftVersion: Set SPEC_VERSION to v1.0.0-draft
-    }
-
-    InitializeVersion --> AppendCreationAudit: Record creation metadata
-
-    state AppendCreationAudit {
-        [*] --> LogCreation: Append audit entry: "Created via md-new" with timestamp
-    }
-
-    AppendCreationAudit --> AwaitHumanReview: Pause for user to review and adjust generated diagram
-    AwaitHumanReview --> [*]
-\`\`\`
-`;