@draig/lexis-two 1.0.6 → 1.0.8

package/.opencode/command/lexis.md

@@ -0,0 +1,17 @@
+---
+description: "Manage Lexis senior dev mode, intensity levels, and quality/security tools"
+---
+
+Manage Lexis senior dev mode, intensity levels, and quality/security tools.
+
+Usage:
+- `/lexis` or `/lexis status`: Show current mode and status.
+- `/lexis lite` / `/lexis full` / `/lexis ultra` / `/lexis off`: Switch the intensity level of the ruleset.
+- `/lexis plan` (or `/lexis p`): Plan a feature using the lazy hierarchy before coding.
+- `/lexis review` (or `/lexis r`): Review current changes for over-engineering.
+- `/lexis audit` (or `/lexis a`): Audit the entire repository for over-engineering.
+- `/lexis debt` (or `/lexis d`): Harvest all `// lexis:` comments into a tracked ledger.
+- `/lexis security` (or `/lexis s`): Run a focused security audit on the stack.
+- `/lexis help` (or `/lexis h`): Show the quick reference card.
+
+Respond in Spanish.

package/.opencode/command/specxis.md

@@ -0,0 +1,18 @@
+---
+description: "Manage the Specxis Spec-Driven Development lifecycle (new, plan, implement, review, close, debt, status)"
+---
+
+Manage the Specxis Spec-Driven Development lifecycle.
+
+Usage:
+- `/specxis` or `/specxis status`: Show active specs, tasks progress, and debt.
+- `/specxis new <slug>`: Create a new spec folder and proposal.md.
+- `/specxis plan <slug>`: Generate spec.md and tasks.md from proposal.md.
+- `/specxis implement <slug>`: Implement the next unchecked task.
+- `/specxis review <slug>`: Review the implementation against spec.md and AGENTS.md.
+- `/specxis close <slug>`: Archive the completed spec and sync its debt.
+- `/specxis debt`: Sync all `// lexis:` comments from the codebase to `.specxis/debt.md`.
+
+If `.specxis/` does not exist, suggest running `node node_modules/@draig/lexis-two/scripts/specxis-init.js` (or local script path if in development).
+
+Respond in Spanish.

package/.opencode/plugins/lexis-two-tui.mjs

@@ -1,8 +1,9 @@
 // lexis-two — OpenCode TUI plugin (no-op)
 //
-// This is a dummy TUI entry point to satisfy OpenCode's TUI plugin loader
-// and prevent installation/runtime load failures in the TUI interface.
+// Satisfies OpenCode's TUI target loader. No TUI UI is needed for lexis-two.
 
-export default async () => {
-  return {};
+export default {
+  async tui() {
+    return {};
+  },
 };

package/.opencode/plugins/lexis-two.mjs

@@ -55,7 +55,7 @@ function writeMode(mode) {
   fs.writeFileSync(statePath, mode);
 }
 
-export default async ({ client } = {}) => {
+function createServerHooks({ client } = {}) {
   const log = (level, message) => {
     try {
       client &&
@@ -83,4 +83,11 @@ export default async ({ client } = {}) => {
       log("info", "lexis-two " + mode);
     },
   };
+}
+
+// OpenCode v1 plugin shape: default export is { server(), tui() }.
+export default {
+  async server(input) {
+    return createServerHooks(input);
+  },
 };

package/README.md

@@ -1,7 +1,7 @@
 <p align="center">
   <picture>
   <!--  <source media="(prefers-color-scheme: dark)" srcset="assets/logo-dark.png"> -->
-    <img src="assets/logo.png" width="220" alt="Lexis-two">
+    <img src="https://github.com/nitdraig/lexis-two/assets/logo.png" width="220" alt="Lexis-two">
   </picture>
 </p>
 
@@ -89,7 +89,8 @@ To enable the slash commands globally in any project:
 
 ```bash
 mkdir -p ~/.config/opencode/commands
-cp .opencode/command/lexis-two*.md ~/.config/opencode/commands/
+cp .opencode/command/lexis*.md ~/.config/opencode/commands/
+cp .opencode/command/specxis*.md ~/.config/opencode/commands/
 ```
 
 ### OpenCode (Local development / manual)
@@ -129,15 +130,36 @@ More hosts (Windsurf, Gemini CLI, pi, Copilot): see [docs/portability.md](./docs
 
 ## Commands
 
-Once installed, these slash commands are available in OpenCode:
-
-| Command               | What it does                                                          |
-| --------------------- | --------------------------------------------------------------------- |
-| `/lexis-two-review`   | Reviews recent changes against AGENTS.md rules                        |
-| `/lexis-two-audit`    | Full codebase audit — over-engineering, deps, structure               |
-| `/lexis-two-debt`     | Surfaces all `// lexis:` comments as prioritized debt list            |
-| `/lexis-two-plan`     | Plans a feature using the minimalist decision hierarchy before coding |
-| `/lexis-two-security` | Security audit focused on your stack (Node.js, MongoDB, Next.js)      |
+Once installed, these unifed slash commands are available in OpenCode, Gemini CLI, and pi:
+
+### 1. `/lexis` — Core Lexis Commands
+Manage Lexis senior dev mode, intensity levels, and quality/security tools under a single unifed command.
+
+| Subcommand | Shortcut | What it does |
+| ---------- | -------- | ------------ |
+| `/lexis status` | `/lexis` | Shows current mode (lite/full/ultra/off) and default configuration. |
+| `/lexis lite` / `full` / `ultra` / `off` | - | Switches the intensity level of the ruleset. |
+| `/lexis plan` | `/lexis p` | Plans a feature using the minimalist decision hierarchy before coding. |
+| `/lexis review` | `/lexis r` | Reviews recent changes against `AGENTS.md` rules for over-engineering. |
+| `/lexis audit` | `/lexis a` | Full codebase audit — over-engineering, deps, structure. |
+| `/lexis debt` | `/lexis d` | Surfaces all `// lexis:` comments as a prioritized debt list. |
+| `/lexis security` | `/lexis s` | Security audit focused on your stack (Node.js, MongoDB, Next.js). |
+| `/lexis help` | `/lexis h` | Shows the quick reference card. |
+
+*(Note: The old individual commands like `/lexis-two-review` are fully supported for backward compatibility but will display a deprecation warning guiding you to use `/lexis` instead.)*
+
+### 2. `/specxis` — Spec-Driven Development (v0.5)
+Manage the complete Specxis SDD lifecycle for complex features.
+
+| Subcommand | What it does |
+| ---------- | ------------ |
+| `/specxis` or `/specxis status` | Shows active specs, tasks progress, and debt. |
+| `/specxis new <slug>` | Creates a new spec folder and `proposal.md` applying the lazy check. |
+| `/specxis plan <slug>` | Generates `spec.md` and `tasks.md` from `proposal.md`. |
+| `/specxis implement <slug>` | Implements the next unchecked task in the active spec. |
+| `/specxis review <slug>` | Reviews the implementation against `spec.md` and `AGENTS.md`. |
+| `/specxis close <slug>` | Archives the completed spec and syncs its debt to `.specxis/debt.md`. |
+| `/specxis debt` | Sincroniza todos los comentarios `// lexis:` del código de forma portable. |
 
 ---
 
@@ -166,7 +188,7 @@ Lexis marks intentional simplifications with inline comments:
 // lexis: tech debt — revisit when auth module is stable
 ```
 
-Run `/lexis-two-debt` to collect and prioritize all tagged items across the codebase.
+Run `/lexis debt` (or `/lexis d`) to collect and prioritize all tagged items across the codebase.
 
 ---
 
@@ -250,17 +272,17 @@ The public orchestrator — a generalized pattern extracted from the private Lex
 
 ---
 
-### v0.5 — Specxis (Spec-Driven Development)
+### v0.5 — Specxis (Spec-Driven Development) ✅
 
 Lightweight SDD layer for complex features — inspired by OpenSpec and Spec Kit,
 built for the Lexis philosophy.
 
-- [ ] `.specxis/` folder convention documented
-- [ ] Commands: specxis-new, specxis-plan, specxis-implement, specxis-review, specxis-close, specxis-debt
-- [ ] Skills: specxis, specxis-plan, specxis-review, specxis-close
-- [ ] `scripts/specxis-init.js` — creates .specxis/ structure in any project
-- [ ] `templates/specxis/` — proposal, spec, and tasks templates
-- [ ] `docs/specxis.md` — when to use SDD vs direct implementation
+- [x] `.specxis/` folder convention documented
+- [x] Commands: specxis-new, specxis-plan, specxis-implement, specxis-review, specxis-close, specxis-debt
+- [x] Skills: specxis, specxis-plan, specxis-review, specxis-close
+- [x] `scripts/specxis-init.js` — creates .specxis/ structure in any project
+- [x] `templates/specxis/` — proposal, spec, and tasks templates
+- [x] `docs/specxis.md` — when to use SDD vs direct implementation
 - [ ] Integration guide for Lexis-One private config
 
 ---

package/commands/lexis-two-audit.toml

@@ -0,0 +1,3 @@
+name = "lexis-two-audit"
+description = "Audit the whole repo for over-engineering, what can be deleted"
+skill = "../skills/lexis-two-audit/SKILL.md"

package/commands/lexis-two-debt.toml

@@ -0,0 +1,3 @@
+name = "lexis-two-debt"
+description = "Harvest all lexis: comments into a prioritized debt ledger"
+skill = "../skills/lexis-two-debt/SKILL.md"

package/commands/lexis-two-help.toml

@@ -0,0 +1,3 @@
+name = "lexis-two-help"
+description = "Quick reference for lexis-two levels, skills, and commands"
+prompt = "Show the lexis-two quick reference. One shot, change nothing: do not switch mode, write flag files, or persist anything. Levels: /lexis-two lite, /lexis-two (full, default), /lexis-two ultra. Commands: /lexis-two-review, /lexis-two-audit, /lexis-two-debt, /lexis-two-plan, /lexis-two-security, /lexis-two-help."

package/commands/lexis-two-plan.toml

@@ -0,0 +1,3 @@
+name = "lexis-two-plan"
+description = "Plan a feature using the Lexis-Two lazy decision hierarchy before any code is written"
+skill = "../skills/lexis-two-plan/SKILL.md"

package/commands/lexis-two-review.toml

@@ -0,0 +1,3 @@
+name = "lexis-two-review"
+description = "Review current diff for over-engineering and Lexis-Two rule violations"
+skill = "../skills/lexis-two-review/SKILL.md"

package/commands/lexis-two-security.toml

@@ -0,0 +1,3 @@
+name = "lexis-two-security"
+description = "Security audit focused on Node.js / TypeScript / Next.js / MongoDB stack"
+skill = "../skills/lexis-two-security/SKILL.md"

package/commands/lexis-two.toml

@@ -0,0 +1,3 @@
+name = "lexis-two"
+description = "Switch lexis-two intensity level (lite/full/ultra/off)"
+prompt = "Switch to lexis-two {{args}} mode. If no level specified, use full. Lazy senior dev mode, before any code: does it need to exist at all (YAGNI)? Does the standard library do it? A native platform feature? Can it be one line? Build the minimum that works. No unrequested abstractions, no avoidable dependencies, no boilerplate. Mark intentional simplifications with a lexis: comment."

package/commands/lexis.toml

@@ -0,0 +1,3 @@
+name = "lexis"
+description = "Manage Lexis senior dev mode, intensity levels, and quality/security tools"
+prompt = "Manage Lexis senior dev mode. Handle the requested subcommand: plan (p), review (r), audit (a), debt (d), security (s), help (h), status, or intensity level (lite/full/ultra/off)."

package/commands/specxis.toml

@@ -0,0 +1,3 @@
+name = "specxis"
+description = "Manage the Specxis Spec-Driven Development lifecycle (new, plan, implement, review, close, debt, status)"
+skill = "../skills/specxis/SKILL.md"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@draig/lexis-two",
-  "version": "1.0.6",
+  "version": "1.0.8",
   "description": "The simple way to obtain the best code. Portable rules, skills, and slash commands for AI agents with lowest tokens usage.",
   "main": "./.opencode/plugins/lexis-two.mjs",
   "exports": {
@@ -16,8 +16,11 @@
     ".opencode/plugins/lexis-two.mjs",
     ".opencode/plugins/lexis-two-tui.mjs",
     ".opencode/command/",
+    "commands/",
     "hooks/",
-    "skills/"
+    "skills/",
+    "templates/",
+    "scripts/"
   ],
   "keywords": [
     "pi-package",
@@ -27,6 +30,7 @@
   ],
   "license": "MIT",
   "scripts": {
+    "postinstall": "node scripts/opencode-wrapper-postinstall.mjs",
     "test": "node --test tests/*.test.js && npm test --prefix pi-extension",
     "benchmark:opencode-go": "node benchmarks/benchmark-opencode-go.js --repeat 3 --write-md",
     "benchmark:report": "node benchmarks/render-opencode-go-report.js",

package/scripts/check-rule-copies.js

@@ -0,0 +1,82 @@
+#!/usr/bin/env node
+// lexis-two — rule copy integrity check
+//
+// To avoid runtime overhead, instruction-tier hosts (Windsurf, Cline, Kiro,
+// Cursor) load static copies of the rules. This script acts as a build/CI guard
+// to ensure those copies never drift from the canonical source (AGENTS.md).
+//
+// It asserts that:
+//   1. Every rule copy file exists.
+//   2. Every copy is completely identical to AGENTS.md (ignoring host-specific frontmatter).
+//   3. The canonical AGENTS.md itself contains the load-bearing Lexis-Two rules.
+
+const fs = require('fs');
+const path = require('path');
+
+const root = path.join(__dirname, '..');
+
+// Canonical source of truth
+const SOURCE_FILE = 'AGENTS.md';
+
+// Static copies to validate
+const COPIES = [
+  '.windsurf/rules/lexis-two.md',
+  '.clinerules/lexis-two.md',
+  '.kiro/steering/lexis-two.md',
+  '.cursor/rules/lexis-two.mdc',
+];
+
+// Load-bearing phrases that MUST exist in the source of truth. If these are
+// missing, the source file has been gutted, and the copies are validating
+// against an empty shell.
+const INVARIANTS = [
+  'lazy senior',
+  'Input validation at trust boundaries',
+  'YAGNI',
+];
+
+function read(relPath) {
+  try {
+    return fs.readFileSync(path.join(root, relPath), 'utf8');
+  } catch (e) {
+    console.error(`Error: failed to read ${relPath}`);
+    process.exit(1);
+  }
+}
+
+// 1. Validate canonical source
+const source = read(SOURCE_FILE);
+for (const phrase of INVARIANTS) {
+  if (!source.includes(phrase)) {
+    console.error(`Error: canonical source (${SOURCE_FILE}) is missing load-bearing rule: "${phrase}"`);
+    process.exit(1);
+  }
+}
+
+// Helper to strip frontmatter (metadata blocks between '---' at start of file)
+function stripFrontmatter(content) {
+  return content.replace(/^---[\s\S]*?---\s*/, '');
+}
+
+// 2. Validate copies
+let failed = false;
+const canonicalBody = stripFrontmatter(source).trim();
+
+for (const copyPath of COPIES) {
+  const copyContent = read(copyPath);
+  const copyBody = stripFrontmatter(copyContent).trim();
+
+  if (copyBody !== canonicalBody) {
+    console.error(`Drift detected: ${copyPath} does not match ${SOURCE_FILE}`);
+    failed = true;
+  }
+}
+
+if (failed) {
+  console.error('\nIntegrity check FAILED. Rule copies have drifted from AGENTS.md.');
+  console.error('To fix, copy AGENTS.md content into the drifted files, preserving their frontmatter if any.');
+  process.exit(1);
+}
+
+console.log('Rule copy integrity check PASSED.');
+process.exit(0);

package/scripts/opencode-wrapper-postinstall.mjs

@@ -0,0 +1,50 @@
+#!/usr/bin/env node
+// Patch OpenCode's npm cache wrapper package.json after install.
+//
+// OpenCode installs scoped plugins into ~/.cache/opencode/packages/@scope/pkg@latest/
+// with a wrapper package.json that only lists dependencies. At runtime the loader
+// reads that wrapper (not node_modules/@scope/pkg/package.json), so exports/main
+// are missing and the plugin fails with "runtime load failed".
+
+import fs from "fs";
+import path from "path";
+import { fileURLToPath } from "url";
+
+const pkgRoot = path.dirname(path.join(fileURLToPath(import.meta.url), ".."));
+const pkgJsonPath = path.join(pkgRoot, "package.json");
+
+function isOpenCodeWrapperDir(dir) {
+  const normalized = dir.replace(/\\/g, "/");
+  return normalized.includes("/packages/") && normalized.endsWith("@latest");
+}
+
+function patchWrapperPackageJson(wrapperDir, packageName) {
+  const wrapperPkgPath = path.join(wrapperDir, "package.json");
+  if (!fs.existsSync(wrapperPkgPath)) return false;
+
+  const wrapper = JSON.parse(fs.readFileSync(wrapperPkgPath, "utf8"));
+  const pluginBase = `./node_modules/${packageName}/.opencode/plugins`;
+  const next = {
+    ...wrapper,
+    main: `${pluginBase}/lexis-two.mjs`,
+    exports: {
+      ".": `${pluginBase}/lexis-two.mjs`,
+      "./server": `${pluginBase}/lexis-two.mjs`,
+      "./tui": `${pluginBase}/lexis-two-tui.mjs`,
+    },
+    "oc-plugin": ["server", "tui"],
+  };
+
+  fs.writeFileSync(wrapperPkgPath, `${JSON.stringify(next, null, 2)}\n`);
+  return true;
+}
+
+try {
+  const pkg = JSON.parse(fs.readFileSync(pkgJsonPath, "utf8"));
+  const wrapperDir = path.resolve(pkgRoot, "../..");
+  if (!isOpenCodeWrapperDir(wrapperDir)) process.exit(0);
+  patchWrapperPackageJson(wrapperDir, pkg.name);
+} catch {
+  // lexis: postinstall is best-effort — normal npm installs must not fail
+  process.exit(0);
+}

package/scripts/specxis-debt.js

@@ -0,0 +1,121 @@
+// scripts/specxis-debt.js
+// Portable Node.js script to scan the codebase for "// lexis:" comments
+// and sync them with .specxis/debt.md.
+// Works on Windows, macOS, and Linux.
+
+const fs = require('fs');
+const path = require('path');
+
+const DEBT_FILE = '.specxis/debt.md';
+
+// Recursive directory scan
+function scanDir(dir, fileList = []) {
+  if (!fs.existsSync(dir)) return fileList;
+  const files = fs.readdirSync(dir);
+  for (const file of files) {
+    const filePath = path.join(dir, file);
+    const stat = fs.statSync(filePath);
+    if (stat.isDirectory()) {
+      // Skip common ignore folders
+      if (['node_modules', '.git', '.specxis', '.astro', 'dist', 'build', '.cache'].includes(file)) continue;
+      scanDir(filePath, fileList);
+    } else {
+      // Only scan relevant code files
+      if (['.ts', '.tsx', '.js', '.jsx', '.mjs', '.cjs'].includes(path.extname(file))) {
+        fileList.push(filePath);
+      }
+    }
+  }
+  return fileList;
+}
+
+function findLexisComments() {
+  const files = scanDir('.');
+  const comments = [];
+  const regex = /\/\/\s*lexis:\s*(.*)/gi;
+
+  for (const file of files) {
+    const content = fs.readFileSync(file, 'utf8');
+    const lines = content.split(/\r?\n/);
+    lines.forEach((line, index) => {
+      let match;
+      // Reset regex lastIndex
+      regex.lastIndex = 0;
+      while ((match = regex.exec(line)) !== null) {
+        comments.push({
+          file: file.replace(/\\/g, '/'), // normalize to forward slashes
+          line: index + 1,
+          comment: match[1].trim()
+        });
+      }
+    });
+  }
+  return comments;
+}
+
+function syncDebt() {
+  if (!fs.existsSync(DEBT_FILE)) {
+    console.error(`Error: ${DEBT_FILE} does not exist. Run specxis-init first.`);
+    process.exit(1);
+  }
+
+  const found = findLexisComments();
+  console.log(`Found ${found.length} '// lexis:' comments in codebase.`);
+
+  let debtContent = fs.readFileSync(DEBT_FILE, 'utf8');
+
+  // We want to reconstruct or append to .specxis/debt.md.
+  // Let's create a prioritized ledger as described in SPECXIS.md.
+  // Categories:
+  // - Immediate: shortcuts causing pain or blocking features
+  // - Next sprint: shortcuts with a known ceiling approaching
+  // - Backlog: fine for now, revisit at scale
+  // - Permanent: intentional, no action needed
+  
+  const immediate = [];
+  const nextSprint = [];
+  const backlog = [];
+  const permanent = [];
+
+  found.forEach(item => {
+    const text = item.comment.toLowerCase();
+    const entry = `- [ ] **${item.file}:${item.line}**: ${item.comment}`;
+
+    if (text.includes('immediate') || text.includes('critical') || text.includes('pain') || text.includes('block')) {
+      immediate.push(entry);
+    } else if (text.includes('sprint') || text.includes('soon') || text.includes('ceiling')) {
+      nextSprint.push(entry);
+    } else if (text.includes('permanent') || text.includes('intentional') || text.includes('no action')) {
+      permanent.push(`- **${item.file}:${item.line}**: ${item.comment} (Permanent)`);
+    } else {
+      backlog.push(entry);
+    }
+  });
+
+  const header = `# Specxis Debt Ledger
+
+Consolidated // lexis: comments across all features.
+Updated automatically by /specxis-debt and /specxis-close.
+
+---
+
+## Prioritized Ledger
+
+### Immediate (shortcuts causing pain or blocking features)
+${immediate.length > 0 ? immediate.join('\n') : '*No immediate debt found.*'}
+
+### Next Sprint (shortcuts with a known ceiling approaching)
+${nextSprint.length > 0 ? nextSprint.join('\n') : '*No next sprint debt found.*'}
+
+### Backlog (fine for now, revisit at scale)
+${backlog.length > 0 ? backlog.join('\n') : '*No backlog debt found.*'}
+
+### Permanent (intentional, no action needed)
+${permanent.length > 0 ? permanent.join('\n') : '*No permanent debt found.*'}
+`;
+
+  fs.writeFileSync(DEBT_FILE, header);
+  console.log(`Updated ${DEBT_FILE} with prioritized ledger.`);
+}
+
+syncDebt();

package/scripts/specxis-init.js

@@ -0,0 +1,45 @@
+// scripts/specxis-init.js
+// Initializes .specxis/ folder structure in the current project.
+// Run with: node scripts/specxis-init.js
+
+const fs = require('fs');
+const path = require('path');
+
+const dirs = [
+  '.specxis/active',
+  '.specxis/archive',
+];
+
+const debtTemplate = `# Specxis Debt Ledger
+
+Consolidated // lexis: comments across all features.
+Updated automatically by /specxis-debt and /specxis-close.
+
+---
+
+<!-- Entries added by specxis-close and specxis-debt commands -->
+`;
+
+for (const dir of dirs) {
+  fs.mkdirSync(dir, { recursive: true });
+  console.log(`created ${dir}/`);
+}
+
+const debtPath = '.specxis/debt.md';
+if (!fs.existsSync(debtPath)) {
+  fs.writeFileSync(debtPath, debtTemplate);
+  console.log(`created ${debtPath}`);
+}
+
+// Add .specxis/archive to .gitignore if not already there
+// (active specs stay in git; archive is optional)
+const gitignorePath = '.gitignore';
+if (fs.existsSync(gitignorePath)) {
+  const content = fs.readFileSync(gitignorePath, 'utf8');
+  if (!content.includes('.specxis/archive')) {
+    fs.appendFileSync(gitignorePath, '\n# Specxis archived specs (optional)\n# .specxis/archive\n');
+    console.log('added .specxis/archive comment to .gitignore');
+  }
+}
+
+console.log('\nSpecxis initialized. Run /specxis-new to create your first spec.');

package/skills/specxis/SKILL.md

@@ -0,0 +1,46 @@
+---
+name: specxis
+description: Manage the Specxis Spec-Driven Development lifecycle (new, plan, implement, review, close, debt, status)
+---
+
+You are the Specxis orchestrator. Handle the requested subcommand or action:
+
+### 1. STATUS (default: `/specxis` or `/specxis status`)
+- List folders in `.specxis/active/`. For each, show: slug, status (draft/agreed/implementing/done), task progress (X/Y), and if review.md exists.
+- List count of archived specs in `.specxis/archive/`.
+- Show open items in `.specxis/debt.md` by priority.
+
+### 2. NEW (`/specxis new <slug>`)
+- Ask for slug if not provided (kebab-case, e.g. "user-auth").
+- Create `.specxis/active/[slug]/proposal.md` from the template in `node_modules/@draig/lexis-two/templates/specxis/proposal.md` (or local path).
+- Apply the lazy check: ask "Does this need to exist? What's the minimum?". Fill what you know, leave unknowns blank.
+
+### 3. PLAN (`/specxis plan <slug>`)
+- Read `.specxis/active/[slug]/proposal.md`.
+- Apply the lazy hierarchy to every requirement.
+- Create `.specxis/active/[slug]/spec.md` (MUST/SHOULD/MAY) and `.specxis/active/[slug]/tasks.md` (max 10 tasks, one per file/function).
+- Ask for approval before starting implementation.
+
+### 4. IMPLEMENT (`/specxis implement <slug>`)
+- Read `.specxis/active/[slug]/tasks.md`. Find the first unchecked task (`- [ ]`).
+- Implement it following spec.md MUST requirements and AGENTS.md rules.
+- Mark as done (`- [x]`), add `// lexis:` comments for deviations, and update "Lexis Tags Added" in tasks.md.
+- Implement only one task per run. Stop and report.
+
+### 5. REVIEW (`/specxis review <slug>`)
+- Read `.specxis/active/[slug]/spec.md` and run `git diff HEAD`.
+- Evaluate spec compliance, SHOULD compliance, AGENTS.md rules, and tests.
+- Write findings to `.specxis/active/[slug]/review.md` (Severity: Critical/High/Medium/Low, Location, Issue, Fix).
+
+### 6. CLOSE (`/specxis close <slug>`)
+- Verify all tasks are checked and no Critical/High findings are open.
+- Move `.specxis/active/[slug]/` to `.specxis/archive/[slug]/`.
+- Collect all `// lexis:` comments added during this feature and append them to `.specxis/debt.md`.
+
+### 7. DEBT (`/specxis debt`)
+- Run `node node_modules/@draig/lexis-two/scripts/specxis-debt.js` (or local path) to scan the codebase and update `.specxis/debt.md` with a prioritized ledger.
+
+---
+
+If `.specxis/` does not exist, suggest running `node node_modules/@draig/lexis-two/scripts/specxis-init.js` first.
+Respond in Spanish. All code, comments, JSDoc in English.

package/templates/specxis/proposal.md

@@ -0,0 +1,21 @@
+# Proposal: [feature-slug]
+
+## Goal
+One sentence — what does this feature do for the user?
+
+## Lazy Check
+Answer before writing any code:
+- Does this need to exist? Could the requirement be met another way?
+- Does stdlib, the framework, or an installed dep already cover it?
+- What is the absolute minimum that satisfies the requirement?
+
+## Context
+- Affected domain / feature folder:
+- Related existing files:
+- Dependencies already installed that are relevant:
+
+## Out of Scope (YAGNI)
+Explicitly list what this proposal does NOT include.
+
+## Open Questions
+Anything that needs clarification before planning.

package/templates/specxis/review.md

@@ -0,0 +1,17 @@
+# Review: [feature-slug]
+
+> Generated by /specxis-review on close.
+
+## Summary
+One sentence on overall quality.
+
+## Spec Compliance
+Did the implementation follow spec.md?
+- MUST requirements met: yes / no / partial
+- Deviations: list with // lexis: references
+
+## Debt Registered
+// lexis: comments added during this feature — moved to .specxis/debt.md.
+
+## Next Steps
+Recommended follow-up actions in priority order.

package/templates/specxis/spec.md

@@ -0,0 +1,24 @@
+# Spec: [feature-slug]
+
+> Status: draft | agreed | implementing | done
+
+## Requirements
+
+### MUST (non-negotiable)
+- [ ] 
+
+### SHOULD (strong preference, can deviate with // lexis: comment)
+- [ ] 
+
+### MAY (optional, implement only if trivial)
+- [ ] 
+
+## Constraints
+- Performance:
+- Security:
+- Accessibility:
+- TypeScript: strict — no any, as, or ! without // lexis: explanation
+
+## Acceptance Criteria
+How do we know this is done?
+- [ ] 

package/templates/specxis/tasks.md

@@ -0,0 +1,16 @@
+# Tasks: [feature-slug]
+
+> Generated by /specxis-plan. Each task maps to one file or one function.
+> Do not start implementing until tasks are agreed.
+
+## Tasks
+
+- [ ] task-001: 
+- [ ] task-002: 
+- [ ] task-003: 
+
+## Implementation Notes
+Decisions made during planning that affect implementation.
+
+## Lexis Tags Added
+// lexis: comments added during implementation (updated as work progresses).