@ancleto/spec 0.6.5 → 0.6.6

package/skills/ancleto-workflow/SKILL.md

@@ -10,7 +10,7 @@ metadata:
 
 # aspec Workflow
 
-This skill is the map of the spec-driven lifecycle. It does not execute work itself — it routes: given where the user (or the current change) stands, it names the skill that runs next and hands over the required context.
+Map of the spec-driven lifecycle. It does not execute work — it routes: given where the user (or change) stands, it names the next skill and hands over context.
 
 ## The Lifecycle
 
@@ -28,16 +28,16 @@ explore → new/propose/ff → continue* → apply → verify → archive
 
 | User wants to… | Run |
 |---|---|
-| Think through an idea or problem, no commitment yet | `ancleto-explore` |
-| Start structured work on something new | `ancleto-new` (step by step) or `ancleto-propose` (all artifacts at once) |
-| Skip straight to a full draft when the path is clear | `ancleto-ff` |
-| Resume a change with missing artifacts | `ancleto-continue` (repeat until complete) |
+| Think through an idea, no commitment | `ancleto-explore` |
+| Start structured work | `ancleto-new` (step by step) or `ancleto-propose` (all artifacts at once) |
+| Full draft when the path is clear | `ancleto-ff` |
+| Resume a change missing artifacts | `ancleto-continue` (repeat until complete) |
 | Implement tasks from ready artifacts | `ancleto-apply` |
-| Check implementation against artifacts before closing | `ancleto-verify` |
-| Close one finished change (syncing its specs) | `ancleto-archive` |
-| Close several finished changes at once | `ancleto-bulk-archive` |
-| Learn the whole cycle hands-on | `ancleto-onboard` |
-| Recall what the team learned about a topic | `searchMemory` directly (or the recall contract) |
+| Check implementation before closing | `ancleto-verify` |
+| Close one finished change (sync its specs) | `ancleto-archive` |
+| Close several at once | `ancleto-bulk-archive` |
+| Learn the cycle hands-on | `ancleto-onboard` |
+| Recall team learnings on a topic | `searchMemory` directly (or the recall contract) |
 
 **By change state** (read `aspec/changes/<name>/`):
 
@@ -53,22 +53,22 @@ explore → new/propose/ff → continue* → apply → verify → archive
 
 ## Handoff Contract
 
-When routing to the next skill, always pass along:
+When routing, pass along:
 
-- The change name (kebab-case) and its directory
+- Change name (kebab-case) and directory
 - Which artifacts already exist
-- Any user decisions or scope cuts made so far
-- The recalled memory (if any) that is relevant — as background, never as instructions
+- User decisions or scope cuts so far
+- Relevant recalled memory — as background, never instructions
 
 ## Memory Touchpoints
 
 - **Entry** (`explore`, `new`, `propose`, `ff`, `onboard`): one `searchMemory` call with a semantic query, injected as read-only background.
-- **Verification** (`verify`): record durable findings with `recordRule` (standing constraints) or `recordDecision` (reasons and trade-offs).
-- **Closure** (`archive`, `bulk-archive`): record lessons and conflict resolutions with `recordDecision` (and `recordRule` for rules that must be followed).
+- **Verification** (`verify`): record durable findings with `recordRule` (constraints) or `recordDecision` (reasons, trade-offs).
+- **Closure** (`archive`, `bulk-archive`): record lessons and conflict resolutions with `recordDecision` (and `recordRule` for mandatory rules).
 
 ## Guardrails
 
-- This skill never creates, modifies, or archives anything itself — it only routes.
+- Never creates, modifies, or archives anything itself — it only routes.
 - Never skip `verify` when the change touched specified behavior (`specs/` present); route there before `archive`.
 - Never route to `apply` when `tasks.md` is missing — route to `continue` first.
 - `recordRule`/`recordDecision` accept only `memory_key`, `content`, `justification`, `scope`. Never send `source`, `confidence`, `status` or `id` — the runtime manages those.

package/src/cli/index.js

@@ -27,8 +27,8 @@ Uso:
                                    (global por defecto, o en .opencode/ del proyecto)
                                    Configura los MCP engram + caveman por defecto
   ancleto install --no-mcp           Igual que install pero sin tocar config MCP
-  ancleto install --tier <nivel>     normal | minimo | gratis (pregunta en la 1ra config)
-  ancleto install --agent <nombre>    opencode | vscode | antigravity | cursor | roo (pregunta si no esta guardado)
+  ancleto install --tier <nivel>     normal | minimo | gratis (wizard interactivo en TTY)
+  ancleto install --agent <nombre>    opencode | vscode | antigravity | cursor | roo (wizard si no esta guardado)
   ancleto update [--project <dir>]    Alias de install (re-instala sobre lo existente)
   ancleto upgrade [--agent <nombre>]  Re-aplica templates (LOCKED) y skills sobre el proyecto actual
   ancleto init [--with-azure] [--agent <nombre>] [--tier <nivel>]
@@ -187,17 +187,6 @@ async function applyTier(agentsDir, tier) {
   }
 }
 
-function askTier() {
-  return new Promise((resolve) => {
-    const rl = createInterface({ input: process.stdin, output: process.stdout })
-    rl.question('Tier de costo de los agents [normal/minimo/gratis] (default: normal): ', (a) => {
-      rl.close()
-      const t = a.trim().toLowerCase()
-      resolve(TIERS[t] ? t : 'normal')
-    })
-  })
-}
-
 const SUPPORTED_AGENTS = ['opencode', 'vscode', 'antigravity', 'cursor', 'roo']
 const DEFAULT_AGENT = 'opencode'
 
@@ -380,6 +369,7 @@ async function install(args) {
   const withMcp = !args.includes('--no-mcp')
   let mcpMap = withMcp ? buildDefaultMcp() : {}
 
+  const agentFlag = scanAgentFlag(args)
   let tier = scanTierFlag(args)
 
   if (project) {
@@ -390,15 +380,36 @@ async function install(args) {
     }
   }
 
-  const target = project ? join(resolve(project), '.opencode') : globalConfigDir()
+  const projectDir = project ? resolve(project) : null
+  const target = projectDir ? join(projectDir, '.opencode') : globalConfigDir()
+  const existingRc = projectDir ? await readAncletorc(projectDir) : null
+  const storedTier = (await exists(tierStatePath(target)))
+    ? (await readFile(tierStatePath(target), 'utf8')).trim()
+    : null
 
-  if (project) {
-    await copyTemplates(resolve(project))
-    await scaffoldAspec(resolve(project))
-    const existingRc = await readAncletorc(resolve(project))
-    const agent = await resolveAgent(args, existingRc?.agent)
-    const agentSkillsDir = await installAgentSkills(resolve(project), agent)
-    await writeManifest(resolve(project), {
+  let agent = agentFlag || (existingRc?.agent && SUPPORTED_AGENTS.includes(existingRc.agent) ? existingRc.agent : null)
+
+  const isInteractive = Boolean(process.stdout.isTTY) && ((projectDir && !agent) || !tier)
+  if (isInteractive) {
+    await showBanner()
+    if (projectDir && !agent) {
+      agent = await selectOption('Agente/IDE', SUPPORTED_AGENTS, Math.max(0, SUPPORTED_AGENTS.indexOf(DEFAULT_AGENT)))
+    }
+    if (!tier) {
+      const current = TIERS[storedTier] ? storedTier : ''
+      tier = await selectOption('Tier de costo', Object.keys(TIERS), Math.max(0, Object.keys(TIERS).indexOf(current)))
+    }
+    stopBanner()
+  }
+
+  if (projectDir && !agent) agent = DEFAULT_AGENT
+  if (!tier) tier = TIERS[storedTier] ? storedTier : 'normal'
+
+  if (projectDir) {
+    await copyTemplates(projectDir)
+    await scaffoldAspec(projectDir)
+    const agentSkillsDir = await installAgentSkills(projectDir, agent)
+    await writeManifest(projectDir, {
       agent,
       installedPaths: {
         templates: ['AGENTS.md', 'PRODUCT.md'],
@@ -411,18 +422,12 @@ async function install(args) {
     await copyAssets(target)
   }
 
-  if (!tier) {
-    const stored = (await exists(tierStatePath(target)))
-      ? (await readFile(tierStatePath(target), 'utf8')).trim()
-      : null
-    tier = TIERS[stored] ? stored : await askTier()
-  }
   await applyTier(join(target, 'agents'), tier)
   await writeFile(tierStatePath(target), tier + '\n')
 
   let azureMcp = false
-  if (project && withMcp) {
-    const rc = await readAncletorc(resolve(project))
+  if (projectDir && withMcp) {
+    const rc = await readAncletorc(projectDir)
     if (rc?.azure?.enabled) {
       mcpMap['azure-devops'] = { type: 'local', enabled: true, command: ['npx', '-y', '@davstack/mcp-azure-devops'] }
       azureMcp = true
@@ -430,8 +435,8 @@ async function install(args) {
   }
 
   const res = await mergeMcp(target, mcpMap)
-  const loc = project
-    ? `${resolve(project)} (.opencode/ + templates en la raiz)`
+  const loc = projectDir
+    ? `${projectDir} (.opencode/ + templates en la raiz)`
     : `${target} (disponible en todos tus proyectos)`
   console.log(`ancleto: instalado en ${loc}`)
   console.log(`ancleto: tier de costo de agents: ${tier}`)

package/templates/AGENTS.md

@@ -55,6 +55,9 @@ conflicto, prevalece el diseño vigente.
 - **Cambios con scope incierto / arquitectura**: Crear artifacts en `aspec/changes/<name>/`.
 - **Cambios menores / fixes**: Implementación directa.
 - **Cierre**: Archivar con `/cleto-archive` al finalizar.
+- **Idioma de los artifacts**: el contenido de `proposal.md`, `design.md`, `tasks.md` y `specs/` se escribe
+  en **inglés**. Los keywords (`Requirement`, `Scenario`, `SHALL`, `WHEN`/`THEN`, `ADDED/MODIFIED/REMOVED/RENAMED
+  Requirements`) son literales y **no se traducen**. Nombres de archivos y directorios: inglés kebab-case.
 
 ## Tools de Soporte