create-agentic-pdlc 2.0.3 → 2.0.5

package/SETUP.md

@@ -114,24 +114,18 @@ git push
 
 ---
 
-## Step 7 — Populate the Initial Backlog
+## Step 7 — Ignite the Backlog
 
-For each known idea or feature, create an issue using the convention:
+Forget heavy templates and CLI commands. Just drop your raw idea and let the AI do the heavy lifting:
 
-```bash
-gh issue create \
-  --repo owner/repo \
-  --title "👤 US: [short description]" \
-  --body "**As** [user],
-**I want** [action],
-**so that** [benefit].
-
----
-
-Initial idea issue. Spec to be detailed."
-```
+1. Open your **GitHub Project** board.
+2. Under the **Idea** column, click **`+ Add item`**.
+3. Type your feature title and hit **Enter**.
+4. Select **Blank issue**.
+5. In the right sidebar, add a brief description of what you want.
+6. Ask your AI Assistant to read the issue and write the full specification!
 
-Move the issues to the `Idea` column on the board matching your setup.
+Your AI will handle the refinement and automatically move it to the `Specification` stage.
 
 ---
 

package/adapters/claude-code/skill.md

@@ -19,8 +19,9 @@ Specifically, check for:
 - `.github/workflows/pdlc-health-check.yml`
 
 If any of these files are missing, you are in **Setup Mode**. Do not proceed with feature requests until setup is complete.
-1. Acknowledge that the framework is not yet set up.
-2. Interactively ask the user for required values **one group at a time**:
+1. **Language Detection:** Analyze the user's previous prompts and preferred language. Conduct this entire Setup Mode and ask all your interactive questions in that same language.
+2. Acknowledge that the framework is not yet set up.
+3. Interactively ask the user for required values **one group at a time**:
    - **Project basics:** Project Name, Description, Technical Stack (Structure), and GitHub Username (for CODEOWNERS security).
    - **Commands:** Test command, Lint command, Build command.
    - **Invariants:** Critical business rules agents must never violate (e.g. Human-in-the-loop).
@@ -31,7 +32,8 @@ If any of these files are missing, you are in **Setup Mode**. Do not proceed wit
 3. Generate and write the missing files replacing the `{{SCREAMING_SNAKE_CASE}}` placeholders using the templates logic you know (usually they reside in standard Agentic PDLC templates).
 4. Offer to run the `gh` commands for labels (`spec:approved`, `pr:in-review`, `pr:approved`, `architecture-violation`).
 5. Commit everything with the message: `chore: setup agentic-pdlc framework`.
-6. Conclude Setup Mode.
+6. **IMPORTANT:** Delete this setup prompt file (e.g., `.agentic-setup.md`, `.agentic-setup-prompt.md`, or `.agentic-pdlc/SETUP_PROMPT.md`) from the root or `.agentic-pdlc/` directory to clean up the workspace.
+7. Conclude Setup Mode.
 
 ---
 

package/bin/cli.js

@@ -3,6 +3,7 @@
 const fs = require('fs');
 const path = require('path');
 const readline = require('readline');
+const { execSync, execFileSync } = require('child_process');
 
 // The directory where CLI is executed
 const targetDir = process.cwd();
@@ -14,13 +15,72 @@ const rl = readline.createInterface({
   output: process.stdout
 });
 
+function askQuestion(query) {
+  return new Promise(resolve => rl.question(query, resolve));
+}
+
+// Detect language
+const locale = Intl.DateTimeFormat().resolvedOptions().locale || 'en-US';
+const isPt = locale.toLowerCase().startsWith('pt');
+const isEs = locale.toLowerCase().startsWith('es');
+
+function t(en, pt, es) {
+  if (isPt) return pt;
+  if (isEs) return es || en; // Fallback para inglês se faltar espanhol
+  return en;
+}
+
+const i18n = {
+  welcome: t('🤖 Welcome to Agentic PDLC Boilerplate Bootstrap! 🤖', '🤖 Bem-vindo ao Agentic PDLC Boilerplate Bootstrap! 🤖', '🤖 ¡Bienvenido a Agentic PDLC Boilerplate Bootstrap! 🤖'),
+  checking_gh: t('Checking GitHub CLI (gh) installation...', 'Verificando instalação do GitHub CLI (gh)...', 'Verificando la instalación de GitHub CLI (gh)...'),
+  gh_ok: t('✅ GitHub CLI is authenticated.', '✅ GitHub CLI está autenticado.', '✅ GitHub CLI está autenticado.'),
+  gh_error: t('❌ GitHub CLI (gh) is not installed or not authenticated.', '❌ GitHub CLI (gh) não está instalado ou não autenticado.', '❌ GitHub CLI (gh) no está instalado o no está autenticado.'),
+  gh_install: t('Please install it from https://cli.github.com/ and run "gh auth login" before continuing.\n', 'Por favor, instale em https://cli.github.com/ e rode "gh auth login" antes de continuar.\n', 'Por favor, instálalo desde https://cli.github.com/ y ejecuta "gh auth login" antes de continuar.\n'),
+  ask_agent: t('Which AI Agent will you use for the setup? (e.g. claude, cursor, copilot, antigravity, or other): ', 'Qual Agente de IA você usará para o setup? (ex: claude, cursor, copilot, antigravity, ou outro): ', '¿Qué Agente de IA usarás para la configuración? (ej: claude, cursor, copilot, antigravity, u otro): '),
+  ask_repo: t('What is your GitHub repository URL? (e.g., https://github.com/YOUR_USER/repo_name): ', 'Qual é a URL do seu repositório no GitHub? (ex: https://github.com/SEU_USUARIO/repo_name): ', '¿Cuál es la URL de tu repositorio en GitHub? (ej: https://github.com/TU_USUARIO/repo_name): '),
+  invalid_repo: t('❌ Invalid repository URL. Expected format: https://github.com/OWNER/REPO', '❌ URL de repositório inválida. Formato esperado: https://github.com/OWNER/REPO', '❌ URL de repositorio inválida. Formato esperado: https://github.com/OWNER/REPO'),
+  ask_org: t('Does this repository belong to a personal User account (e.g., github.com/rafaeltcosta86) or an Organization (e.g., github.com/google-labs)? (user/org): ', 'Esse repositório pertence a um Usuário pessoal (ex: github.com/rafaeltcosta86) ou a uma Organização (ex: github.com/google-labs)? (user/org): ', '¿Este repositorio pertenece a un Usuario personal (ej: github.com/rafaeltcosta86) o a una Organización (ej: github.com/google-labs)? (user/org): '),
+  ask_branch: t('What is your main branch name? (default: main): ', 'Qual o nome da sua branch principal? (padrão: main): ', '¿Cuál es el nombre de tu rama principal? (por defecto: main): '),
+  starting_setup: t('Starting automated repository setup...', 'Iniciando o setup automatizado do repositório...', 'Iniciando la configuración automatizada del repositorio...'),
+  creating_labels: t('[1/2] Creating repository labels...', '[1/2] Criando labels no repositório...', '[1/2] Creando etiquetas (labels) en el repositorio...'),
+  label_ok: t('✅ Label created: ', '✅ Label criada: ', '✅ Etiqueta creada: '),
+  label_warn: t('⚠️ Failed to create label (might already exist): ', '⚠️ Falha ao criar label (talvez já exista): ', '⚠️ Fallo al crear etiqueta (quizás ya exista): '),
+  applying_protection: t('[2/3] Applying branch protection on ', '[2/3] Aplicando proteção de branch em ', '[2/3] Aplicando protección de rama en '),
+  protection_ok: t('✅ Branch protection applied to ', '✅ Proteção de branch aplicada em ', '✅ Protección de rama aplicada a '),
+  protection_warn: t('⚠️ Failed to apply branch protection. (Do you have GitHub Pro or is the repo Public?)', '⚠️ Falha ao aplicar proteção de branch. (Você tem GitHub Pro ou o repo é Público?)', '⚠️ Fallo al aplicar protección de rama. (¿Tienes GitHub Pro o el repositorio es Público?)'),
+  creating_project: t('[2/2] Creating Project V2 Board...', '[2/2] Criando Project V2 Board...', '[2/2] Creando Project V2 Board...'),
+  project_ok: t('✅ Project created (ID: ', '✅ Projeto criado (ID: ', '✅ Proyecto creado (ID: '),
+  project_err: t('❌ Failed to create project. Error: ', '❌ Falha ao criar o projeto. Erro: ', '❌ Fallo al crear el proyecto. Error: '),
+  config_columns: t('Configuring Project Columns...', 'Configurando colunas do Projeto...', 'Configurando columnas del Proyecto...'),
+  columns_ok: t('✅ Project columns configured successfully.', '✅ Colunas do projeto configuradas com sucesso.', '✅ Columnas del proyecto configuradas con éxito.'),
+  columns_warn: t('⚠️ Failed to configure project columns. You may need to add them manually.', '⚠️ Falha ao configurar colunas. Você pode precisar adicioná-las manualmente.', '⚠️ Fallo al configurar columnas. Es posible que debas agregarlas manualmente.'),
+  scaffolding: t('Scaffolding Agentic PDLC into your project...', 'Injetando Agentic PDLC no seu projeto...', 'Inyectando Agentic PDLC en tu proyecto...'),
+  templates_copied: t('✅ Templates copied to .agentic-pdlc/templates/', '✅ Templates copiados para .agentic-pdlc/templates/', '✅ Plantillas copiadas a .agentic-pdlc/templates/'),
+  pdlc_prefilled: t('✅ Pre-filled pdlc.md with Project ID, Status Field ID, and Column Option IDs.', '✅ pdlc.md preenchido com Project ID, Status Field ID, e Column Option IDs.', '✅ pdlc.md completado con Project ID, Status Field ID y Column Option IDs.'),
+  setup_written: t('✅ Setup agent profile written to .agentic-setup.md\n', '✅ Perfil de setup do agente salvo em .agentic-setup.md\n', '✅ Perfil de configuración del agente guardado en .agentic-setup.md\n'),
+  framework_scaffolded: t('🎉 Framework files scaffolded to .agentic-pdlc/templates/', '🎉 Arquivos do framework injetados em .agentic-pdlc/templates/', '🎉 Archivos del framework inyectados en .agentic-pdlc/templates/'),
+  next_steps: t('👉 NEXT STEPS:', '👉 PRÓXIMOS PASSOS:', '👉 PRÓXIMOS PASOS:'),
+  step_1: t('1. Open your AI Assistant (Claude, Cursor, Copilot, etc).', '1. Abra o seu Assistente de IA (Claude, Cursor, Copilot, etc).', '1. Abre tu Asistente de IA (Claude, Cursor, Copilot, etc).'),
+  step_2: t('2. Ask it to read the .agentic-setup.md and start Setup Mode in any language you prefer. Example 👇', '2. Peça para ele ler o .agentic-setup.md e iniciar o Setup Mode. Exemplo 👇', '2. Pídele que lea .agentic-setup.md e inicie el Setup Mode. Ejemplo 👇'),
+  note_cleanup: t('Note: The agent will clean up the .agentic-setup.md file automatically when finished.\n', 'Nota: O agente irá limpar o arquivo .agentic-setup.md automaticamente quando terminar.\n', 'Nota: El agente limpiará el archivo .agentic-setup.md automáticamente cuando termine.\n'),
+  missing_claude: t('❌ Could not find instruction file at ', '❌ Não foi possível encontrar o arquivo de instrução em ', '❌ No se pudo encontrar el archivo de instrucción en '),
+  cursor_rules_written: t('✅ Default cursor rules written to .cursorrules', '✅ Regras padrão do cursor salvas em .cursorrules', '✅ Reglas por defecto de cursor guardadas en .cursorrules'),
+  cursor_setup_written: t('✅ Framework Setup Instructions written to .agentic-pdlc/SETUP_PROMPT.md', '✅ Instruções de Setup do Framework salvas em .agentic-pdlc/SETUP_PROMPT.md', '✅ Instrucciones de Setup del Framework guardadas en .agentic-pdlc/SETUP_PROMPT.md'),
+  cursor_done: t('🎉 Done! To start the conversational setup:', '🎉 Pronto! Para iniciar o setup conversacional:', '🎉 ¡Listo! Para iniciar la configuración conversacional:'),
+  cursor_step_1: t('\t1. Open Cursor', '\t1. Abra o Cursor', '\t1. Abre Cursor'),
+  cursor_step_2: t('\t2. Open Composer (Cmd+I or Cmd+L) and type: "@.agentic-pdlc/SETUP_PROMPT.md execute Setup Mode"\n', '\t2. Abra o Composer (Cmd+I ou Cmd+L) e digite: "@.agentic-pdlc/SETUP_PROMPT.md execute Setup Mode"\n', '\t2. Abre Composer (Cmd+I o Cmd+L) y escribe: "@.agentic-pdlc/SETUP_PROMPT.md execute Setup Mode"\n'),
+  generic_written: t('✅ Agent generic setup instructions written to .agentic-setup.md', '✅ Instruções genéricas salvas em .agentic-setup.md', '✅ Instrucciones genéricas guardadas en .agentic-setup.md'),
+  generic_done: t('Tell your AI agent to read and execute the .agentic-setup.md file!\n', 'Diga ao seu agente para ler e executar o arquivo .agentic-setup.md!\n', '¡Dile a tu agente de IA que lea y ejecute el archivo .agentic-setup.md!\n')
+};
+
 const cyan = '\x1b[36m';
 const reset = '\x1b[0m';
 const green = '\x1b[32m';
 const yellow = '\x1b[33m';
+const red = '\x1b[31m';
 
 console.log(`${cyan}================================================================${reset}`);
-console.log(`${cyan}🤖 Welcome to Agentic PDLC Boilerplate Bootstrap! 🤖${reset}`);
+console.log(`${cyan}${i18n.welcome}${reset}`);
 console.log(`${cyan}================================================================${reset}\n`);
 
 // Helper function to recursively copy directories
@@ -39,10 +99,167 @@ function copyDirSync(src, dest) {
   }
 }
 
-rl.question('Which AI Agent will you use for the setup? (e.g. claude, cursor, copilot, or other): ', (answer) => {
-  const agent = answer.trim().toLowerCase();
-  
-  console.log(`\n${yellow}Scaffolding Agentic PDLC into your project...${reset}`);
+async function runSetup() {
+  console.log(`${yellow}${i18n.checking_gh}${reset}`);
+  try {
+    execSync('gh auth status', { stdio: 'ignore' });
+    console.log(`${green}${i18n.gh_ok}${reset}\n`);
+  } catch (error) {
+    console.error(`${red}${i18n.gh_error}${reset}`);
+    console.error(`${i18n.gh_install}`);
+    process.exit(1);
+  }
+
+  const agentAnswer = await askQuestion(i18n.ask_agent);
+  const agent = agentAnswer.trim().toLowerCase();
+  if (!['claude', 'cursor', 'copilot'].includes(agent)) {
+    console.log(t(`ℹ️ Generating Universal Setup for '${agent}' (Compatible with any Markdown-reading agent).`, `ℹ️ Gerando Setup Universal para '${agent}' (Compatível com qualquer agente que leia Markdown).`, `ℹ️ Generando Setup Universal para '${agent}' (Compatible con cualquier agente que lea Markdown).`));
+  }
+
+  let repoOwner, repoName, repo;
+  while (true) {
+    let repoUrl = (await askQuestion(i18n.ask_repo)).trim();
+    if (repoUrl.endsWith('/')) repoUrl = repoUrl.slice(0, -1);
+    if (repoUrl.endsWith('.git')) repoUrl = repoUrl.slice(0, -4);
+    const repoParts = repoUrl.split('/');
+    if (repoParts.length >= 2) {
+      repoOwner = repoParts[repoParts.length - 2];
+      repoName = repoParts[repoParts.length - 1];
+      repo = `${repoOwner}/${repoName}`;
+      break;
+    }
+    console.log(`${red}${i18n.invalid_repo}${reset}`);
+  }
+
+  const askProjectName = t(`What is the project name for the board? (default: ${repoName.toUpperCase()}): `, `Qual o nome do projeto em que o board será configurado? (padrão: ${repoName.toUpperCase()}): `, `¿Cuál es el nombre del proyecto en el que se configurará el board? (por defecto: ${repoName.toUpperCase()}): `);
+  const projectNameAnswer = await askQuestion(askProjectName);
+  const projectName = projectNameAnswer.trim() ? projectNameAnswer.trim().toUpperCase() : repoName.toUpperCase();
+  const boardName = `BOARD - ${projectName}`;
+
+  let isOrg = false;
+  try {
+    const ownerType = execFileSync('gh', ['api', `repos/${repo}`, '--jq', '.owner.type']).toString().trim();
+    isOrg = ownerType === 'Organization';
+  } catch (err) {
+    const accountTypeAnswer = await askQuestion(i18n.ask_org);
+    isOrg = accountTypeAnswer.trim().toLowerCase() === 'org' || accountTypeAnswer.trim().toLowerCase() === 'organization';
+  }
+
+  let branchName = 'main';
+  try {
+    branchName = execFileSync('gh', ['api', `repos/${repo}`, '--jq', '.default_branch']).toString().trim() || 'main';
+  } catch (err) {
+    const branchAnswer = await askQuestion(i18n.ask_branch);
+    if (branchAnswer.trim()) branchName = branchAnswer.trim();
+  }
+
+  console.log(`\n${yellow}${i18n.starting_setup}${reset}`);
+
+  // Labels
+  const labels = [
+    { name: 'stage:exploration', color: '9b59b6', description: 'Issue is being evaluated' },
+    { name: 'stage:brainstorming', color: 'e84393', description: 'Proposed approaches awaiting PM gate' },
+    { name: 'stage:detailing', color: '3498db', description: 'Technical spec is being written' },
+    { name: 'stage:development', color: 'e67e22', description: 'Agent is implementing the spec' },
+    { name: 'stage:testing', color: '8e44ad', description: 'Agent is testing the implementation' },
+    { name: 'spec:approved', color: '0e8a16', description: 'Spec approved — agent can implement' },
+    { name: 'pr:in-review', color: 'e4e669', description: 'PR awaiting code review' },
+    { name: 'pr:approved', color: '0e8a16', description: 'PR approved, ready for merge' },
+    { name: 'architecture-violation', color: 'd93f0b', description: 'Invariant violation detected by CI' },
+    { name: 'qa:approved', color: '0e8a16', description: 'QA Agent approved the implementation' },
+    { name: 'qa:needs-work', color: 'd93f0b', description: 'QA Agent found issues' },
+    { name: 'jules', color: '5319e7', description: 'Jules AI Agent' }
+  ];
+
+  console.log(`\n${cyan}${i18n.creating_labels}${reset}`);
+  for (const label of labels) {
+    try {
+      execFileSync('gh', ['label', 'create', label.name, '--color', label.color, '--description', label.description, '--repo', repo, '--force'], { stdio: 'ignore' });
+      console.log(`  ${i18n.label_ok}${label.name}`);
+    } catch (err) {
+      console.log(`  ${i18n.label_warn}${label.name}`);
+    }
+  }
+
+  // Project V2
+  console.log(`\n${cyan}${i18n.creating_project}${reset}`);
+  let ownerId, projectId;
+  try {
+    if (isOrg) {
+      const orgOutput = execFileSync('gh', ['api', 'graphql', '-f', 'query=query($login: String!) { organization(login: $login) { id } }', '-f', `login=${repoOwner}`, '--jq', '.data.organization.id']).toString().trim();
+      ownerId = orgOutput;
+    } else {
+      const userOutput = execFileSync('gh', ['api', 'graphql', '-f', 'query={ viewer { id } }', '--jq', '.data.viewer.id']).toString().trim();
+      ownerId = userOutput;
+    }
+
+    const projectCreateOutput = execFileSync('gh', ['api', 'graphql', '-f', 'query=mutation($owner: ID!, $title: String!) { createProjectV2(input: {ownerId: $owner, title: $title}) { projectV2 { id } } }', '-f', `owner=${ownerId}`, '-f', `title=${boardName}`, '--jq', '.data.createProjectV2.projectV2.id']).toString().trim();
+    projectId = projectCreateOutput;
+
+    console.log(`  ${i18n.project_ok}${projectId})`);
+  } catch (err) {
+    console.log(`  ${i18n.project_err}${err.message}`);
+  }
+
+  let statusFieldId;
+  let optionMap = {};
+
+  if (projectId) {
+    console.log(`  ${cyan}${i18n.config_columns}${reset}`);
+    try {
+      const fieldsOutput = execFileSync('gh', ['api', 'graphql', '-f', 'query=query($projectId: ID!) { node(id: $projectId) { ... on ProjectV2 { fields(first: 20) { nodes { ... on ProjectV2SingleSelectField { id name } } } } } }', '-f', `projectId=${projectId}`, '--jq', '.data.node.fields.nodes[] | select(.name == "Status") | .id']).toString().trim();
+      statusFieldId = fieldsOutput;
+
+      if (statusFieldId) {
+        const columns = [
+          { name: "💡 Idea", description: "Backlog", color: "GRAY" },
+          { name: "🔍 Exploration", description: "Claude is analyzing", color: "PURPLE" },
+          { name: "🧠 Brainstorming", description: "Awaiting PM gate", color: "PINK" },
+          { name: "📐 Detail Solution", description: "Technical spec", color: "BLUE" },
+          { name: "✅ Approval", description: "Spec ready", color: "GREEN" },
+          { name: "⚙️ Development", description: "Agent implementing", color: "ORANGE" },
+          { name: "🧪 Testing", description: "QA testing", color: "RED" },
+          { name: "👁 Code Review / PR", description: "PR opened", color: "YELLOW" },
+          { name: "🚀 Production", description: "Merged", color: "GREEN" }
+        ];
+
+        const updateFieldQuery = `mutation($fieldId: ID!, $options: [ProjectV2SingleSelectFieldOptionInput!]) {
+          updateProjectV2Field(input: {
+            fieldId: $fieldId,
+            singleSelectOptions: $options
+          }) {
+            projectV2Field {
+              ... on ProjectV2SingleSelectField {
+                options { id name }
+              }
+            }
+          }
+        }`;
+
+        const queryPayload = JSON.stringify({
+          query: updateFieldQuery,
+          variables: {
+            fieldId: statusFieldId,
+            options: columns
+          }
+        });
+
+        const updateOutput = execFileSync('gh', ['api', 'graphql', '--input', '-'], { input: queryPayload }).toString().trim();
+        const jsonResponse = updateOutput ? JSON.parse(updateOutput) : null;
+        const returnedOptions = jsonResponse?.data?.updateProjectV2Field?.projectV2Field?.options || [];
+        
+        for (const opt of returnedOptions) {
+          optionMap[opt.name] = opt.id;
+        }
+
+        console.log(`  ${i18n.columns_ok}`);
+      }
+    } catch (err) {
+      console.log(`  ${i18n.columns_warn}`);
+    }
+  }
+
+  console.log(`\n${yellow}${i18n.scaffolding}${reset}`);
 
   // We copy the templates folder so the agent has the real text logic to replace and rename
   const sourceTemplates = path.join(sourceDir, 'templates');
@@ -50,7 +267,33 @@ rl.question('Which AI Agent will you use for the setup? (e.g. claude, cursor, co
   
   if (fs.existsSync(sourceTemplates)) {
     copyDirSync(sourceTemplates, targetTemplates);
-    console.log(`✅ Templates copied to .agentic-pdlc/templates/`);
+    console.log(`${i18n.templates_copied}`);
+
+    // Substitute values in docs/pdlc.md automatically
+    const pdlcDest = path.join(targetTemplates, 'docs', 'pdlc.md');
+    if (fs.existsSync(pdlcDest)) {
+      let pdlcContent = fs.readFileSync(pdlcDest, 'utf8');
+      
+      if (projectId) pdlcContent = pdlcContent.replace(/\\{\\{PROJECT_ID\\}\\}/g, () => projectId);
+      if (statusFieldId) pdlcContent = pdlcContent.replace(/\\{\\{STATUS_FIELD_ID\\}\\}/g, () => statusFieldId);
+      pdlcContent = pdlcContent.replace(/\\{\\{REPO_OWNER\\}\\}/g, () => repoOwner);
+      pdlcContent = pdlcContent.replace(/\\{\\{REPO_NAME\\}\\}/g, () => repoName);
+
+      if (Object.keys(optionMap).length > 0) {
+        pdlcContent = pdlcContent.replace(/\{\{ID_IDEA\}\}/g, optionMap["💡 Idea"] || 'MISSING_ID');
+        pdlcContent = pdlcContent.replace(/\{\{ID_EXPLORATION\}\}/g, optionMap["🔍 Exploration"] || 'MISSING_ID');
+        pdlcContent = pdlcContent.replace(/\{\{ID_BRAINSTORMING\}\}/g, optionMap["🧠 Brainstorming"] || 'MISSING_ID');
+        pdlcContent = pdlcContent.replace(/\{\{ID_DETAIL\}\}/g, optionMap["📐 Detail Solution"] || 'MISSING_ID');
+        pdlcContent = pdlcContent.replace(/\{\{ID_APPROVAL\}\}/g, optionMap["✅ Approval"] || 'MISSING_ID');
+        pdlcContent = pdlcContent.replace(/\{\{ID_DEVELOPMENT\}\}/g, optionMap["⚙️ Development"] || 'MISSING_ID');
+        pdlcContent = pdlcContent.replace(/\{\{ID_TESTING\}\}/g, optionMap["🧪 Testing"] || 'MISSING_ID');
+        pdlcContent = pdlcContent.replace(/\{\{ID_CODE_REVIEW_PR\}\}/g, optionMap["👁 Code Review / PR"] || 'MISSING_ID');
+        pdlcContent = pdlcContent.replace(/\{\{ID_PRODUCTION\}\}/g, optionMap["🚀 Production"] || 'MISSING_ID');
+      }
+
+      fs.writeFileSync(pdlcDest, pdlcContent);
+      console.log(`${i18n.pdlc_prefilled}`);
+    }
   }
 
   // Handle the specific setup instructions target
@@ -61,15 +304,19 @@ rl.question('Which AI Agent will you use for the setup? (e.g. claude, cursor, co
     if (fs.existsSync(claudeSetupSrc)) {
       const dest = path.join(targetDir, '.agentic-setup.md');
       fs.copyFileSync(claudeSetupSrc, dest);
-      console.log(`✅ Setup agent profile written to .agentic-setup.md`);
-      console.log(`\n${green}🎉 Done! To start the conversational setup:${reset}`);
-      console.log(`${cyan}\tStep 1: Open the Claude Code CLI in your terminal (type 'claude')${reset}`);
-      console.log(`${cyan}\t        [Or open your preferred IDE Agent chat, like Antigravity, Cursor, Codex, GitHub Copilot, etc]${reset}`);
-      console.log(`${cyan}\tStep 2: Paste this exact prompt:${reset}`);
-      console.log(`${yellow}\t        "read .agentic-setup.md to enter Setup Mode."${reset}`);
-      console.log(`\nNote: Once setup is completed, the agent will typically delete .agentic-setup.md to keep your root clean.\n`);
+      console.log(`${i18n.setup_written}`);
+      console.log(`${green}============================================================${reset}`);
+      console.log(`${green}${i18n.framework_scaffolded}${reset}`);
+      console.log(`${green}============================================================${reset}\n`);
+      console.log(`${yellow}${i18n.next_steps}${reset}`);
+      console.log(`${cyan}${i18n.step_1}${reset}`);
+      console.log(`${cyan}${i18n.step_2}${reset}`);
+      console.log(`${cyan}>>> English: "Read .agentic-setup.md and guide me through the setup."${reset}`);
+      console.log(`${cyan}>>> Español: "Lea el archivo .agentic-setup.md e inicie el Setup Mode"${reset}`);
+      console.log(`${cyan}>>> Português: "Leia o arquivo .agentic-setup.md e inicie o Setup Mode."${reset}\n`);
+      console.log(`${i18n.note_cleanup}`);
     } else {
-      console.error(`❌ Could not find claude instruction file at ${claudeSetupSrc}`);
+      console.error(`${i18n.missing_claude}${claudeSetupSrc}`);
     }
   } else if (agent === 'cursor') {
     if (fs.existsSync(cursorSetupSrc)) {
@@ -81,22 +328,24 @@ rl.question('Which AI Agent will you use for the setup? (e.g. claude, cursor, co
       const setupPromptDest = path.join(targetDir, '.agentic-pdlc', 'SETUP_PROMPT.md');
       if (fs.existsSync(claudeSetupSrc)) fs.copyFileSync(claudeSetupSrc, setupPromptDest);
 
-      console.log(`✅ Default cursor rules written to .cursorrules`);
-      console.log(`✅ Framework Setup Instructions written to .agentic-pdlc/SETUP_PROMPT.md`);
-      console.log(`\n${green}🎉 Done! To start the conversational setup:${reset}`);
-      console.log(`${cyan}\t1. Open Cursor${reset}`);
-      console.log(`${cyan}\t2. Open Composer (Cmd+I or Cmd+L) and type: "@.agentic-pdlc/SETUP_PROMPT.md execute Setup Mode"${reset}\n`);
+      console.log(`${i18n.cursor_rules_written}`);
+      console.log(`${i18n.cursor_setup_written}`);
+      console.log(`\n${green}${i18n.cursor_done}${reset}`);
+      console.log(`${cyan}${i18n.cursor_step_1}${reset}`);
+      console.log(`${cyan}${i18n.cursor_step_2}${reset}`);
     } else {
-      console.error(`❌ Could not find cursor instruction file at ${cursorSetupSrc}`);
+      console.error(`${i18n.missing_claude}${cursorSetupSrc}`);
     }
   } else {
     // Generic fallback mapping
-    const dest = path.join(targetDir, '.agentic-setup-prompt.md');
+    const dest = path.join(targetDir, '.agentic-setup.md');
     fs.copyFileSync(claudeSetupSrc, dest);
-    console.log(`✅ Agent generic setup instructions written to .agentic-setup-prompt.md`);
-    console.log(`\n${green}🎉 Done! To start the conversational setup:${reset}`);
-    console.log(`${cyan}Provide the .agentic-setup-prompt.md file to your AI agent and ask it to execute Setup Mode!${reset}\n`);
+    console.log(`${i18n.generic_written}`);
+    console.log(`\n${green}${i18n.cursor_done}${reset}`);
+    console.log(`${cyan}>>> ${i18n.generic_done}${reset}`);
   }
 
   rl.close();
-});
+}
+
+runSetup();

package/docs/pdlc.md

@@ -5,11 +5,11 @@
 | Column | Meaning | Who moves the card |
 |---|---|---|
 | 💡 Idea | Backlog — every new issue lands here | Manual |
-| 🔍 Exploration | Claude is analyzing code and context | Label `stage:exploration` |
-| 🧠 Brainstorming | Claude proposed approaches, awaiting PM gate | Label `stage:brainstorming` |
-| 📐 Detail Solution | Claude is writing the technical spec | Label `stage:detailing` |
-| ✅ Approval | Spec ready, awaiting `spec:approved` label | Label `spec:approved` |
-| ⚙️ Development | Agent implementing the spec | Label `stage:development` |
+| 🔍 Exploration | AI is analyzing code and context | Label `stage:exploration` |
+| 🧠 Brainstorming | AI proposed approaches and trade-offs | Label `stage:brainstorming` |
+| 📐 Detail Solution | AI is writing the technical spec | Label `stage:detailing` |
+| ✅ Approval | Your turn, awaiting `spec:approved` label | Label `spec:approved` |
+| ⚙️ Development | AI implementing the spec | Label `stage:development` |
 | 🧪 Testing | CI pipeline running | GitHub Actions |
 | 👁 Code Review / PR | PR opened, awaiting human review | GitHub Actions |
 | 🚀 Production | Merged | GitHub Actions |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-agentic-pdlc",
-  "version": "2.0.3",
+  "version": "2.0.5",
   "description": "Agentic PDLC Framework - Conversational setup for your AI coding assistants",
   "type": "commonjs",
   "bin": {