devflow-agent-cli 0.1.0

package/dist/install.js

@@ -0,0 +1,176 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isManaged = void 0;
+exports.collectFiles = collectFiles;
+exports.buildInstallList = buildInstallList;
+exports.parseAdapterList = parseAdapterList;
+exports.resolveTarget = resolveTarget;
+exports.exists = exists;
+exports.copyItem = copyItem;
+exports.hasAnyPath = hasAnyPath;
+exports.validate = validate;
+exports.detectDefaultAdapters = detectDefaultAdapters;
+exports.resolveAdapters = resolveAdapters;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const constants_1 = require("./constants");
+Object.defineProperty(exports, "isManaged", { enumerable: true, get: function () { return constants_1.isManaged; } });
+function collectFiles(dir, base = '') {
+    const entries = fs.readdirSync(dir, { withFileTypes: true });
+    const files = [];
+    for (const entry of entries) {
+        const rel = base ? path.join(base, entry.name) : entry.name;
+        if (entry.isDirectory()) {
+            files.push(...collectFiles(path.join(dir, entry.name), rel));
+        }
+        else {
+            files.push(rel);
+        }
+    }
+    return files;
+}
+// Returns [{ src: absolutePath, dest: relPathInTarget }].
+// core/ root files (AGENTS.md, DEVFLOW.md) go to target root.
+// prompts/ goes to target/devflow/prompts/ (namespaced to avoid clashes).
+// Each adapter's srcDir is mapped to its destDir.
+function buildInstallList(adapters) {
+    const sources = [
+        { srcDir: path.join(constants_1.TEMPLATES_ROOT, 'core'), destPrefix: '' },
+        { srcDir: path.join(constants_1.TEMPLATES_ROOT, 'prompts'), destPrefix: path.join('devflow', 'prompts') },
+    ];
+    for (const adapter of adapters) {
+        const { srcDir, destDir } = constants_1.ADAPTER_CONFIG[adapter];
+        sources.push({ srcDir: path.join(constants_1.TEMPLATES_ROOT, srcDir), destPrefix: destDir });
+    }
+    const items = [];
+    for (const { srcDir, destPrefix } of sources) {
+        if (!fs.existsSync(srcDir))
+            continue;
+        for (const rel of collectFiles(srcDir)) {
+            const dest = destPrefix ? path.join(destPrefix, rel) : rel;
+            items.push({ src: path.join(srcDir, rel), dest });
+        }
+    }
+    return items;
+}
+function parseAdapterList(raw) {
+    if (!raw)
+        return [];
+    const adapters = raw
+        .split(',')
+        .map((tool) => tool.trim().toLowerCase())
+        .filter(Boolean);
+    if (adapters.includes('all') && adapters.length > 1) {
+        console.error('Error: "all" cannot be combined with other adapters.');
+        process.exit(1);
+    }
+    if (adapters.includes('none') && adapters.length > 1) {
+        console.error('Error: "none" cannot be combined with other adapters.');
+        process.exit(1);
+    }
+    if (adapters.length === 1 && adapters[0] === 'all') {
+        return constants_1.ALL_ADAPTERS;
+    }
+    if (adapters.length === 1 && adapters[0] === 'none') {
+        return [];
+    }
+    const invalid = adapters.filter((adapter) => !Object.prototype.hasOwnProperty.call(constants_1.ADAPTER_CONFIG, adapter));
+    if (invalid.length > 0) {
+        console.error(`Error: unknown adapter(s): ${invalid.join(', ')}`);
+        console.error(`Valid values: ${constants_1.ALL_ADAPTERS.join(', ')}, none, all`);
+        process.exit(1);
+    }
+    return [...new Set(adapters)];
+}
+function resolveTarget(raw) {
+    const resolved = path.resolve(raw);
+    if (!fs.existsSync(resolved)) {
+        console.error(`Error: target path does not exist: ${resolved}`);
+        process.exit(1);
+    }
+    if (!fs.statSync(resolved).isDirectory()) {
+        console.error(`Error: target is not a directory: ${resolved}`);
+        process.exit(1);
+    }
+    return resolved;
+}
+function exists(dest, targetDir) {
+    return fs.existsSync(path.join(targetDir, dest));
+}
+function copyItem(item, targetDir) {
+    const destPath = path.join(targetDir, item.dest);
+    fs.mkdirSync(path.dirname(destPath), { recursive: true });
+    fs.copyFileSync(item.src, destPath);
+}
+function hasAnyPath(targetDir, paths) {
+    return paths.some((rel) => exists(rel, targetDir));
+}
+// Checks core files (always) + one key file per selected adapter.
+function validate(adapters, targetDir) {
+    const failures = [];
+    for (const file of constants_1.CORE_KEY_FILES) {
+        if (!exists(file, targetDir)) {
+            failures.push(`${file} (from core)`);
+        }
+    }
+    for (const adapter of adapters) {
+        const { keyFile } = constants_1.ADAPTER_CONFIG[adapter];
+        if (keyFile && !exists(keyFile, targetDir)) {
+            failures.push(`${keyFile} (${adapter})`);
+        }
+    }
+    return failures;
+}
+function detectDefaultAdapters(targetDir) {
+    if (fs.existsSync(path.join(targetDir, constants_1.DEFAULT_CURSOR_MARKER))) {
+        return ['cursor'];
+    }
+    if (fs.existsSync(path.join(targetDir, constants_1.DEFAULT_CLAUDE_MARKER))) {
+        return ['claude'];
+    }
+    return ['generic'];
+}
+function resolveAdapters(options, targetDir) {
+    const adapterArg = options.adapters ?? options.adapter ?? options.tool;
+    if (options.adapters && (options.adapter || options.tool)) {
+        console.error('Error: use either --adapter/--tool or --adapters, not both.');
+        process.exit(1);
+    }
+    if (!adapterArg) {
+        return detectDefaultAdapters(targetDir);
+    }
+    return parseAdapterList(adapterArg);
+}

package/dist/plugins.js

@@ -0,0 +1,184 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readPluginsFile = readPluginsFile;
+exports.writePluginsFile = writePluginsFile;
+exports.isNpmPackage = isNpmPackage;
+exports.resolvePluginSource = resolvePluginSource;
+exports.loadPluginManifest = loadPluginManifest;
+exports.resolvePluginPaths = resolvePluginPaths;
+exports.buildPluginInstallList = buildPluginInstallList;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const child_process_1 = require("child_process");
+const constants_1 = require("./constants");
+const install_1 = require("./install");
+// ─── plugins.yml I/O ────────────────────────────────────────────────────────
+function readPluginsFile(targetDir) {
+    const filePath = path.join(targetDir, constants_1.PLUGINS_FILE);
+    if (!fs.existsSync(filePath)) {
+        return { plugins: [] };
+    }
+    const raw = fs.readFileSync(filePath, 'utf8').trim();
+    if (!raw)
+        return { plugins: [] };
+    // Minimal YAML parser for our simple format (no dependency required)
+    const plugins = [];
+    let current = null;
+    for (const line of raw.split('\n')) {
+        const trimmed = line.trim();
+        if (trimmed === 'plugins:')
+            continue;
+        if (trimmed.startsWith('- name:')) {
+            if (current)
+                plugins.push(current);
+            current = { name: trimmed.replace('- name:', '').trim() };
+        }
+        else if (current && trimmed.startsWith('source:')) {
+            current.source = trimmed.replace('source:', '').trim();
+        }
+        else if (current && trimmed.startsWith('version:')) {
+            current.version = trimmed.replace('version:', '').trim();
+        }
+        else if (current && trimmed.startsWith('destDir:')) {
+            current.destDir = trimmed.replace('destDir:', '').trim();
+        }
+        else if (current && trimmed.startsWith('keyFile:')) {
+            current.keyFile = trimmed.replace('keyFile:', '').trim();
+        }
+    }
+    if (current)
+        plugins.push(current);
+    return { plugins };
+}
+function writePluginsFile(targetDir, data) {
+    const filePath = path.join(targetDir, constants_1.PLUGINS_FILE);
+    fs.mkdirSync(path.dirname(filePath), { recursive: true });
+    const lines = ['plugins:'];
+    for (const p of data.plugins) {
+        lines.push(`  - name: ${p.name}`);
+        lines.push(`    source: ${p.source}`);
+        lines.push(`    version: ${p.version}`);
+        lines.push(`    destDir: ${p.destDir}`);
+        lines.push(`    keyFile: ${p.keyFile}`);
+    }
+    fs.writeFileSync(filePath, lines.join('\n') + '\n', 'utf8');
+}
+// ─── source resolution ───────────────────────────────────────────────────────
+function isNpmPackage(source) {
+    // Not a path — doesn't start with . / ~
+    return !source.startsWith('.') && !source.startsWith('/') && !source.startsWith('~');
+}
+function resolvePluginSource(source) {
+    if (!isNpmPackage(source)) {
+        // Local path
+        const resolved = path.resolve(source);
+        if (!fs.existsSync(resolved)) {
+            console.error(`Error: plugin source does not exist: ${resolved}`);
+            process.exit(1);
+        }
+        return { pluginDir: resolved, cleanup: null };
+    }
+    // npm package — install into temp dir
+    const tmp = fs.mkdtempSync(path.join(os.tmpdir(), 'devflow-plugin-'));
+    try {
+        console.log(`  …  fetching ${source} from npm`);
+        (0, child_process_1.execSync)(`npm install --prefix "${tmp}" "${source}" --no-save --silent`, { stdio: 'pipe' });
+    }
+    catch (err) {
+        fs.rmSync(tmp, { recursive: true, force: true });
+        const msg = err instanceof Error ? err.message : String(err);
+        console.error(`Error: failed to install npm package "${source}".\n${msg}`);
+        process.exit(1);
+    }
+    // Resolve the package name (strip scope for directory lookup)
+    const pkgName = source.split('@').filter(Boolean)[0];
+    const pluginDir = path.join(tmp, 'node_modules', pkgName);
+    if (!fs.existsSync(pluginDir)) {
+        fs.rmSync(tmp, { recursive: true, force: true });
+        console.error(`Error: could not locate package "${pkgName}" after install.`);
+        process.exit(1);
+    }
+    return {
+        pluginDir,
+        cleanup: () => fs.rmSync(tmp, { recursive: true, force: true }),
+    };
+}
+// ─── manifest loading ────────────────────────────────────────────────────────
+function loadPluginManifest(pluginDir) {
+    const manifestPath = path.join(pluginDir, 'devflow-plugin.json');
+    if (!fs.existsSync(manifestPath)) {
+        console.error(`Error: no devflow-plugin.json found in ${pluginDir}`);
+        console.error('       Every Devflow plugin must have a devflow-plugin.json manifest.');
+        process.exit(1);
+    }
+    let manifest;
+    try {
+        manifest = JSON.parse(fs.readFileSync(manifestPath, 'utf8'));
+    }
+    catch {
+        console.error(`Error: devflow-plugin.json in ${pluginDir} is not valid JSON.`);
+        process.exit(1);
+    }
+    if (!manifest.name || typeof manifest.name !== 'string') {
+        console.error('Error: devflow-plugin.json must have a "name" string field.');
+        process.exit(1);
+    }
+    if (!manifest.version || typeof manifest.version !== 'string') {
+        console.error('Error: devflow-plugin.json must have a "version" string field.');
+        process.exit(1);
+    }
+    return manifest;
+}
+// ─── install helpers ─────────────────────────────────────────────────────────
+function resolvePluginPaths(manifest) {
+    const destDir = manifest.destDir ?? path.join('.devflow', 'plugins', manifest.name);
+    const keyFile = manifest.keyFile ?? path.join(destDir, 'README.md');
+    return { destDir, keyFile };
+}
+function buildPluginInstallList(pluginDir) {
+    const templatesDir = path.join(pluginDir, 'templates');
+    if (!fs.existsSync(templatesDir)) {
+        console.error(`Error: plugin has no templates/ directory in ${pluginDir}`);
+        process.exit(1);
+    }
+    // templates/ mirrors the project root layout — each file's relative path
+    // is its destination path in the target project.
+    return (0, install_1.collectFiles)(templatesDir).map((rel) => ({
+        src: path.join(templatesDir, rel),
+        dest: rel,
+    }));
+}

package/dist/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "devflow-agent-cli",
+  "version": "0.1.0",
+  "description": "Portable AI development workflow kit with a universal core and optional adapters",
+  "main": "dist/cli.js",
+  "bin": {
+    "devflow": "bin/devflow.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc && node dist/cli.js",
+    "test:ci-smoke": "node scripts/ci-smoke-test.mjs",
+    "test:doctor": "node scripts/doctor-test.mjs",
+    "test:explain": "node scripts/explain-test.mjs",
+    "test:unit": "node scripts/unit-test.mjs",
+    "validate": "node scripts/validate-templates.mjs",
+    "test": "tsc && node scripts/unit-test.mjs && node scripts/validate-templates.mjs && node scripts/smoke-test.mjs && node scripts/doctor-test.mjs && node scripts/explain-test.mjs"
+  },
+  "files": [
+    "bin",
+    "dist",
+    "templates",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "cursor",
+    "claude",
+    "codex",
+    "gemini",
+    "anthropic",
+    "ai",
+    "workflow",
+    "cli",
+    "agents",
+    "prompts",
+    "developer-tools"
+  ],
+  "author": "mayordomoespejo",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "commander": "^12.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.0.0"
+  }
+}

package/templates/adapters/claude/.claude/commands/build.md

@@ -0,0 +1,15 @@
+# Devflow Build
+
+Implement the agreed plan for this task.
+
+If the user provided inline command text, treat it as the task description and any accepted plan details. Otherwise use the current conversation context.
+
+Requirements:
+
+1. Make the smallest working change that satisfies the plan
+2. Modify existing code before adding new abstractions
+3. Keep functions small and explicit
+4. Preserve existing behavior outside the requested change
+5. Note any follow-up risks or tradeoffs if they remain
+
+Return the implementation and briefly explain what changed.

package/templates/adapters/claude/.claude/commands/commit.md

@@ -0,0 +1,74 @@
+# Devflow Commit
+
+Propose a commit (or commits) for the current changes. Always propose before executing — never commit automatically.
+
+If the user provided inline text, treat it as a hint about scope or message style.
+
+---
+
+## Step 1 — Detect changes
+
+Run: `git status --porcelain`
+
+If there are no changes: respond "No changes to commit." and stop.
+
+## Step 2 — Scan for secrets
+
+Run `git diff` and `git diff --staged`. Before proposing anything, scan the output for obvious secret patterns:
+
+- `API_KEY=`, `SECRET=`, `TOKEN=`, `PASSWORD=`
+- `BEGIN PRIVATE KEY`, `BEGIN RSA PRIVATE KEY`
+- `Authorization: Bearer <long-string>`
+- Random 32+ character strings in sensitive variable names
+
+If a likely secret is found:
+- **Stop. Do not continue with the commit proposal.**
+- Warn the user: describe the exact file and line.
+- Suggest: remove, rotate, use an env var, add the file to `.gitignore`.
+
+## Step 3 — Analyze and propose
+
+Read the full diff. Group logically related changes.
+
+- **1 commit** if the changes form a single coherent unit.
+- **2–4 commits** if there are clearly separable concerns (implementation / tests / docs / config).
+
+Use Conventional Commits format:
+
+```
+<type>(<scope>): <subject>
+```
+
+Types: `feat` | `fix` | `refactor` | `test` | `docs` | `chore` | `perf` | `ci`
+Subject: imperative mood, lowercase, no period, max 72 characters.
+
+## Step 4 — Present the proposal
+
+Show each commit clearly:
+
+```
+Commit 1
+  Message: feat(auth): add OAuth2 token refresh
+  Files:   src/auth/token.ts, src/auth/refresh.ts
+  Command:
+    git add src/auth/token.ts src/auth/refresh.ts
+    git commit -m "feat(auth): add OAuth2 token refresh"
+```
+
+Do not execute any git commands yet.
+
+## Step 5 — Ask for confirmation
+
+Ask: **"Execute these git commands? (y/n)"**
+
+- **y / yes / sí** → run the exact commands shown.
+- **n / no** → do not execute. Leave the proposal available to copy.
+
+## Always
+
+- Never run `git push`.
+- Never run `git commit --amend` or `git rebase` unless explicitly requested.
+- Never use `--no-verify`.
+- Never use `git add -A` or `git add .` unless the user explicitly requests it.
+- Stage only the specific files listed in each commit's proposal.
+- If a commit hook fails, report the error and stop.

package/templates/adapters/claude/.claude/commands/plan.md

@@ -0,0 +1,15 @@
+# Devflow Plan
+
+Create a step-by-step implementation plan for this task.
+
+If the user provided inline command text, treat it as the task description. Otherwise use the active conversation context.
+
+The response must include:
+
+1. What needs to be built or changed
+2. Which files will be affected
+3. Functions, components, or types to create or modify
+4. Tests that should pass when done
+5. Edge cases and risks to address
+
+Do not write code yet.

package/templates/adapters/claude/.claude/commands/review.md

@@ -0,0 +1,16 @@
+# Devflow Review
+
+Review the current implementation as a senior engineer.
+
+If the user provided inline command text, treat it as additional focus for the review.
+
+Check for:
+
+- Bugs and logic errors
+- Unhandled edge cases
+- Security issues
+- Duplicated logic
+- Unnecessary complexity
+- Material performance issues
+
+List concrete findings first and suggest fixes.

package/templates/adapters/claude/.claude/commands/tests.md

@@ -0,0 +1,14 @@
+# Devflow Tests
+
+Generate tests for the current implementation.
+
+If the user provided inline command text, treat it as extra scope. Otherwise use the current conversation context and repository state.
+
+Cover:
+
+- The happy path
+- Edge cases from planning
+- Error states and invalid input
+- Boundary conditions
+
+Prefer higher-value tests with minimal mocking.

package/templates/adapters/claude/.claude/commands/verify.md

@@ -0,0 +1,16 @@
+# Devflow Verify
+
+Verify the implementation against the agreed plan before it is considered done.
+
+If the user provided inline command text, treat it as additional context.
+
+Check:
+
+1. Compilation or runtime correctness
+2. Tests passing
+3. Planned edge cases handled
+4. No unnecessary duplication
+5. Simplicity of the solution
+6. No exposed sensitive data
+
+If issues remain, list them clearly. Otherwise confirm it is ready to ship.

package/templates/adapters/codex/README.md

@@ -0,0 +1,14 @@
+# Codex Adapter
+
+Devflow does not install a Codex-specific adapter configuration in this step.
+
+Reason:
+
+- the core workflow already lives in `AGENTS.md`, `DEVFLOW.md`, and `devflow/prompts/`
+- this step avoids inventing extra Codex integration files without a clear contract
+
+Use Devflow with Codex by:
+
+1. Installing the core files
+2. Running Codex from the project root so it can read `AGENTS.md`
+3. Reusing the prompts in `devflow/prompts/` when you want explicit PLAN, BUILD, TEST, REVIEW, or VERIFY phases

package/templates/adapters/cursor/.cursor/commands/build.md

@@ -0,0 +1,15 @@
+# Devflow Build
+
+Implement the agreed plan for this task.
+
+If the user provided inline command text, treat it as the task description and any accepted plan details. Otherwise use the current conversation context.
+
+Requirements:
+
+1. Make the smallest working change that satisfies the plan
+2. Modify existing code before adding new abstractions
+3. Keep functions small and explicit
+4. Preserve existing behavior outside the requested change
+5. Note any follow-up risks or tradeoffs if they remain
+
+Return the implementation and briefly explain what changed.

package/templates/adapters/cursor/.cursor/commands/plan.md

@@ -0,0 +1,15 @@
+# Devflow Plan
+
+Create a step-by-step implementation plan for this task.
+
+If the user provided inline command text, treat it as the task description. Otherwise use the active conversation context.
+
+The response must include:
+
+1. What needs to be built or changed
+2. Which files will be affected
+3. Functions, components, or types to create or modify
+4. Tests that should pass when done
+5. Edge cases and risks to address
+
+Do not write code yet.

package/templates/adapters/cursor/.cursor/commands/review.md

@@ -0,0 +1,16 @@
+# Devflow Review
+
+Review the current implementation as a senior engineer.
+
+If the user provided inline command text, treat it as additional focus for the review.
+
+Check for:
+
+- Bugs and logic errors
+- Unhandled edge cases
+- Security issues
+- Duplicated logic
+- Unnecessary complexity
+- Material performance issues
+
+List concrete findings first and suggest fixes.

package/templates/adapters/cursor/.cursor/commands/tests.md

@@ -0,0 +1,14 @@
+# Devflow Tests
+
+Generate tests for the current implementation.
+
+If the user provided inline command text, treat it as extra scope. Otherwise use the current conversation context and repository state.
+
+Cover:
+
+- The happy path
+- Edge cases from planning
+- Error states and invalid input
+- Boundary conditions
+
+Prefer higher-value tests with minimal mocking.

package/templates/adapters/cursor/.cursor/commands/verify.md

@@ -0,0 +1,16 @@
+# Devflow Verify
+
+Verify the implementation against the agreed plan before it is considered done.
+
+If the user provided inline command text, treat it as additional context.
+
+Check:
+
+1. Compilation or runtime correctness
+2. Tests passing
+3. Planned edge cases handled
+4. No unnecessary duplication
+5. Simplicity of the solution
+6. No exposed sensitive data
+
+If issues remain, list them clearly. Otherwise confirm it is ready to ship.