metacoding 1.5.1 → 2.0.1

package/lib/services/skill-manager.js

@@ -0,0 +1,212 @@
+"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.SkillManager = void 0;
+const fs = __importStar(require("fs-extra"));
+const path = __importStar(require("path"));
+class SkillManager {
+    constructor() {
+        this.sourceSkillDir = path.join(__dirname, '../../skills/metacoding-workflow');
+        this.claudeAgentTemplatePath = path.join(__dirname, '../../skills/vendor-templates/claude-agent.md.template');
+        this.vendorDefinitions = {
+            codex: {
+                vendor: 'codex',
+                root: path.join('.codex', 'skills', 'metacoding-workflow'),
+                entryFiles: ['SKILL.md', path.join('agents', 'openai.yaml')],
+            },
+            'claude-code': {
+                vendor: 'claude-code',
+                root: path.join('.claude', 'metacoding-workflow'),
+                entryFiles: [path.join('..', 'agents', 'metacoding-workflow.md')],
+            },
+            antigravity: {
+                vendor: 'antigravity',
+                root: path.join('.agents', 'skills', 'metacoding-workflow'),
+                entryFiles: ['SKILL.md'],
+            },
+        };
+    }
+    async isInstalled(vendor) {
+        const vendors = vendor ? [vendor] : await this.getInstalledVendors();
+        return vendors.length > 0;
+    }
+    async getInstalledVendors() {
+        const installed = [];
+        for (const vendor of Object.keys(this.vendorDefinitions)) {
+            if (await this.hasVendorInstall(vendor)) {
+                installed.push(vendor);
+            }
+        }
+        return installed;
+    }
+    getInstallDirectory(vendor) {
+        return this.vendorDefinitions[vendor].root;
+    }
+    getBackupTargets(vendor) {
+        if (vendor === 'claude-code') {
+            return [
+                path.join('.claude', 'agents', 'metacoding-workflow.md'),
+                this.vendorDefinitions[vendor].root,
+            ];
+        }
+        return [this.vendorDefinitions[vendor].root];
+    }
+    async installSkill(config) {
+        const files = await this.generateInstallationFiles(config);
+        for (const file of files) {
+            await fs.ensureDir(path.dirname(file.path));
+            await fs.writeFile(file.path, file.content, 'utf8');
+        }
+        return files.map((file) => file.path);
+    }
+    async generateInstallationFiles(config) {
+        const root = this.getInstallDirectory(config.vendor);
+        const supportFiles = await this.readCoreSupportFiles(root, config.vendor);
+        const projectContext = await this.renderProjectContext(config);
+        const files = [
+            ...supportFiles,
+            {
+                path: path.join(root, 'references/project-context.md'),
+                content: projectContext,
+            },
+        ];
+        if (config.vendor === 'claude-code') {
+            files.push({
+                path: path.join('.claude', 'agents', 'metacoding-workflow.md'),
+                content: await this.renderClaudeAgentFile(),
+            });
+        }
+        return files;
+    }
+    async getInstalledFiles(vendor) {
+        const files = await this.listFilesRecursively(this.getInstallDirectory(vendor));
+        if (vendor === 'claude-code') {
+            const agentPath = path.join('.claude', 'agents', 'metacoding-workflow.md');
+            if (await fs.pathExists(agentPath)) {
+                files.push(agentPath);
+            }
+        }
+        return files.sort();
+    }
+    async hasVendorInstall(vendor) {
+        const definition = this.vendorDefinitions[vendor];
+        for (const relativeEntry of definition.entryFiles) {
+            const fullPath = path.join(definition.root, relativeEntry);
+            if (!(await fs.pathExists(fullPath))) {
+                return false;
+            }
+        }
+        return true;
+    }
+    async readCoreSupportFiles(installRoot, vendor) {
+        const relativePaths = await this.listFilesRecursively(this.sourceSkillDir);
+        const files = [];
+        for (const absolutePath of relativePaths) {
+            const relativePath = path.relative(this.sourceSkillDir, absolutePath);
+            if (vendor !== 'codex' && relativePath.startsWith('agents/')) {
+                continue;
+            }
+            const content = await fs.readFile(absolutePath, 'utf8');
+            files.push({
+                path: path.join(installRoot, relativePath),
+                content,
+            });
+        }
+        return files;
+    }
+    async renderClaudeAgentFile() {
+        return fs.readFile(this.claudeAgentTemplatePath, 'utf8');
+    }
+    async listFilesRecursively(root) {
+        if (!(await fs.pathExists(root))) {
+            return [];
+        }
+        const entries = await fs.readdir(root, { withFileTypes: true });
+        const files = [];
+        for (const entry of entries) {
+            const fullPath = path.join(root, entry.name);
+            if (entry.isDirectory()) {
+                files.push(...(await this.listFilesRecursively(fullPath)));
+            }
+            else {
+                files.push(fullPath);
+            }
+        }
+        return files.sort();
+    }
+    async renderProjectContext(config) {
+        const templatePath = path.join(this.sourceSkillDir, 'assets/templates/project-context.md');
+        const template = await fs.readFile(templatePath, 'utf8');
+        const recommendedReferences = this.getRecommendedReferences(config);
+        const variables = {
+            PROJECT_NAME: config.name,
+            PROJECT_DESCRIPTION: config.description,
+            PROJECT_TYPE: config.projectType,
+            TECH_STACK: config.techStack.join(', '),
+            TEST_FRAMEWORK: config.testFramework || 'Use the repo default',
+            BUILD_TOOL: config.buildTool || 'Use the repo default',
+            RECOMMENDED_REFERENCES: recommendedReferences.join('\n'),
+            AGENT_VENDOR: config.vendor,
+        };
+        return Object.entries(variables).reduce((content, [key, value]) => {
+            return content.replace(new RegExp(`{{${key}}}`, 'g'), value);
+        }, template);
+    }
+    getRecommendedReferences(config) {
+        const references = [
+            '- `references/workflow-rules.md` for the gated task flow',
+            '- `references/repository-organization.md` for repository structure and MECE documentation ownership',
+            '- `references/platform-adaptation.md` for fallback behavior when repo artifacts or git are missing',
+        ];
+        if (config.projectType === 'typescript') {
+            references.push('- `references/typescript.md` for shared TypeScript coding, testing, and documentation guidance');
+        }
+        else if (config.projectType === 'react') {
+            references.push('- `references/typescript.md` for shared TypeScript guidance', '- `references/react.md` for component, testing, and UI workflow guidance');
+        }
+        else if (config.projectType === 'node') {
+            references.push('- `references/typescript.md` for shared TypeScript guidance', '- `references/node.md` for service, API, and backend workflow guidance');
+        }
+        else if (config.projectType === 'javascript') {
+            references.push('- `references/javascript.md` for JavaScript coding, testing, and documentation guidance');
+        }
+        else if (config.projectType === 'python') {
+            references.push('- `references/python.md` for Python coding, testing, and documentation guidance');
+        }
+        return references;
+    }
+}
+exports.SkillManager = SkillManager;
+//# sourceMappingURL=skill-manager.js.map

package/lib/services/skill-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-manager.js","sourceRoot":"","sources":["../../src/services/skill-manager.ts"],"names":[],"mappings":"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"}

package/lib/types/index.d.ts

@@ -1,21 +1,10 @@
+export type AgentVendor = 'codex' | 'claude-code' | 'antigravity';
+export type AgentVendorOption = AgentVendor | 'all';
 export interface InitOptions {
     template: string;
     force?: boolean;
-    skipVscode?: boolean;
     skipGit?: boolean;
-    vscode?: boolean;
-    cursor?: boolean;
-    ide?: string;
-    environment?: 'ide' | 'terminal';
-    assistants?: AssistantType[];
-    ideChoice?: 'vscode' | 'cursor' | 'intellij';
-}
-export type AssistantType = 'copilot' | 'claude' | 'codex' | 'gemini' | 'all';
-export interface AssistantConfig {
-    type: AssistantType;
-    fileName: string;
-    description: string;
-    instructions: string;
+    vendor?: AgentVendorOption;
 }
 export interface UpdateOptions {
     template?: string;
@@ -23,6 +12,7 @@ export interface UpdateOptions {
     force?: boolean;
     dryRun?: boolean;
     strict?: boolean;
+    vendor?: AgentVendorOption;
 }
 export interface ProjectConfig {
     name: string;
@@ -31,7 +21,7 @@ export interface ProjectConfig {
     projectType: string;
     testFramework?: string;
     buildTool?: string;
-    ideChoice?: 'vscode' | 'cursor' | 'intellij' | undefined;
+    vendor: AgentVendor;
 }
 export interface Template {
     name: string;

package/lib/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "metacoding",
-  "version": "1.5.1",
-  "description": "Guided Development Workflow for GitHub Copilot - Transform your coding experience with AI-guided standards, structured workflows, and quality practices",
-  "main": "lib/index.js",
-  "types": "lib/index.d.ts",
+  "version": "2.0.1",
+  "description": "Cross-agent workflow skill for modern coding agents with gated planning, testing, verification, and handoff defaults",
+  "main": "lib/cli.js",
+  "types": "lib/cli.d.ts",
   "bin": {
     "metacoding": "bin/metacoding.js"
   },
@@ -23,13 +23,13 @@
     "start": "node bin/metacoding.js"
   },
   "keywords": [
-    "github-copilot",
+    "coding-agent",
+    "codex-skill",
     "development-workflow",
     "ai-coding",
     "code-quality",
-    "vscode",
+    "skill",
     "developer-tools",
-    "copilot-instructions",
     "programming-workflow",
     "tdd",
     "best-practices",
@@ -52,7 +52,7 @@
   "files": [
     "bin/",
     "lib/",
-    "templates/",
+    "skills/",
     "README.md",
     "LICENSE",
     "CHANGELOG.md"
@@ -86,14 +86,6 @@
     "ts-node": "^10.9.1",
     "typescript": "^5.8.3"
   },
-  "peerDependencies": {
-    "vscode": "*"
-  },
-  "peerDependenciesMeta": {
-    "vscode": {
-      "optional": true
-    }
-  },
   "jest": {
     "preset": "ts-jest",
     "testEnvironment": "node",
@@ -129,7 +121,7 @@
     ],
     "coverageThreshold": {
       "global": {
-        "branches": 80,
+        "branches": 65,
         "functions": 80,
         "lines": 80,
         "statements": 80

package/skills/metacoding-workflow/SKILL.md

@@ -0,0 +1,52 @@
+---
+name: metacoding-workflow
+description: Enforce the metacoding workflow for modern coding agents. Use this skill for feature work, bug fixes, refactors, or reviews that require strict workflow execution, mandatory TDD, MECE documentation structure, single-task focus, verification, and a clean VCS handoff or completion confirmation.
+---
+
+# Metacoding Workflow
+
+Use this skill when the user wants disciplined execution rather than ad hoc coding.
+
+## Start Here
+
+1. Read `references/project-context.md` first.
+2. Read `references/workflow-rules.md` for the operating contract.
+3. Read `references/repository-organization.md` before planning or editing.
+4. Read `references/platform-adaptation.md` if the repo lacks task docs, test docs, or git context.
+5. Load only the language reference that matches the task:
+   - `references/typescript.md`
+   - `references/javascript.md`
+   - `references/node.md`
+   - `references/react.md`
+   - `references/python.md`
+
+## Core Rules
+
+1. Ground in the repo before asking clarifying questions.
+2. Capture scope, success criteria, and constraints before changing code.
+3. Enforce mandatory TDD: document test intent, write or identify failing tests first, then implement production code.
+4. Work one bounded task at a time.
+5. Verify changes with tests and direct checks.
+6. Maintain MECE documentation: update the correct artifact without duplicating the same concept across multiple docs.
+7. Close with a commit-ready handoff, an actual VCS action, or an explicit completion confirmation.
+
+## Enforcement
+
+- Do not skip directly to coding when repo inspection can reduce uncertainty.
+- Do not bypass TDD unless the user explicitly accepts the exception and the reason is recorded.
+- Do not switch to unrelated work mid-task. Queue it for later.
+- If a new blocker is required to finish the active task, treat it as a subtask.
+- If git actions are unavailable or out of scope, stop at a clean handoff instead of forcing a commit.
+- If repo artifacts are missing, bootstrap them from `assets/templates/` before implementation or explicitly propose them.
+- Keep repository organization and documentation structure aligned with `references/repository-organization.md`.
+
+## Bundled Templates
+
+Use these templates when the repo does not already provide an equivalent artifact:
+
+- `assets/templates/task-entry.md`
+- `assets/templates/test-plan.md`
+- `assets/templates/repeated-task-checklist.md`
+- `assets/templates/changelog-entry.md`
+
+Keep the workflow strict, but adapt the exact artifact shape to the repository you are working in.

package/skills/metacoding-workflow/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Metacoding Workflow"
+  short_description: "Enforce a gated delivery workflow for coding agents"
+  default_prompt: "Use $metacoding-workflow to ground in the repo, capture scope, define test intent before code, implement one bounded task, verify the result, update affected docs/status artifacts, and close with a VCS handoff or completion confirmation."

package/skills/metacoding-workflow/assets/templates/changelog-entry.md

@@ -0,0 +1,6 @@
+# Change Summary
+
+- User-visible change:
+- Internal workflow or tooling change:
+- Verification note:
+- Follow-up considerations:

package/skills/metacoding-workflow/assets/templates/project-context.md

@@ -0,0 +1,18 @@
+# Project Context
+
+- Project name: {{PROJECT_NAME}}
+- Description: {{PROJECT_DESCRIPTION}}
+- Project type: {{PROJECT_TYPE}}
+- Agent vendor: {{AGENT_VENDOR}}
+- Tech stack: {{TECH_STACK}}
+- Default test framework: {{TEST_FRAMEWORK}}
+- Default build tool: {{BUILD_TOOL}}
+
+## Required References
+
+- `references/workflow-rules.md`
+- `references/repository-organization.md`
+
+## Recommended References
+
+{{RECOMMENDED_REFERENCES}}

package/skills/metacoding-workflow/assets/templates/repeated-task-checklist.md

@@ -0,0 +1,8 @@
+# Checklist
+
+- Context and prerequisites captured
+- Prior state or version confirmed
+- Main execution steps listed in order
+- Verification steps listed
+- Rollback or recovery notes listed
+- Follow-up artifact updates listed

package/skills/metacoding-workflow/assets/templates/task-entry.md

@@ -0,0 +1,9 @@
+# Task
+
+- Title:
+- Goal:
+- Success criteria:
+- In scope:
+- Out of scope:
+- Blocking subtasks:
+- Deferred follow-ups:

package/skills/metacoding-workflow/assets/templates/test-plan.md

@@ -0,0 +1,8 @@
+# Test Plan
+
+- Behavior under change:
+- Happy path checks:
+- Error and edge cases:
+- Regression risks:
+- Automated checks to run:
+- Manual verification to run:

package/skills/metacoding-workflow/references/javascript.md

@@ -0,0 +1,7 @@
+# JavaScript Guidance
+
+- Preserve clarity over abstraction; prefer straightforward control flow and small modules.
+- Be explicit about runtime validation, error paths, and async behavior.
+- Keep browser and server concerns separated.
+- Verify observable behavior with focused tests or reproducible manual checks.
+- Update user-facing or operational notes when the behavior surface changes.

package/skills/metacoding-workflow/references/node.md

@@ -0,0 +1,7 @@
+# Node Guidance
+
+- Treat APIs, background jobs, and service boundaries as explicit contracts.
+- Validate inputs, return stable error shapes, and log with operational context.
+- Avoid mixing unrelated infrastructure cleanup into feature work.
+- Verify the smallest meaningful slice first: unit, integration, then full workflow.
+- Document config, env, or deployment implications when they change.

package/skills/metacoding-workflow/references/platform-adaptation.md

@@ -0,0 +1,37 @@
+# Platform Adaptation
+
+## Missing Task Tracking
+
+If the repo does not have a task list or status document:
+
+- create or propose a lightweight task entry using `assets/templates/task-entry.md`
+- keep it local to the repo’s conventions instead of forcing a fixed filename
+
+## Missing Test Documentation
+
+If the repo does not track test intent in docs:
+
+- capture expected behavior in the implementation plan, PR notes, or a repo-appropriate test artifact
+- adapt `assets/templates/test-plan.md` when a durable artifact is useful
+
+## Missing Git Context
+
+If git is unavailable, intentionally out of scope, or the user does not want commits:
+
+- do not block the task
+- finish with a commit-ready handoff that lists changed files, verification status, and follow-up steps
+
+## Missing Changelog or Release Notes
+
+If the repo does not maintain a changelog:
+
+- do not create one gratuitously
+- instead summarize user-visible impact in the final handoff unless the user asked for a durable release artifact
+
+## Agent Portability
+
+This skill is vendor-neutral by design.
+
+- Use native planning, testing, or VCS tools when available.
+- Do not depend on editor-specific instruction hooks.
+- Preserve the workflow intent even if the host agent’s tools differ.

package/skills/metacoding-workflow/references/python.md

@@ -0,0 +1,7 @@
+# Python Guidance
+
+- Prefer clear modules, typed interfaces where helpful, and explicit data validation.
+- Keep framework conventions intact instead of introducing project-specific patterns casually.
+- Test the changed behavior at the right level: function, service, API, or end-to-end flow.
+- Record operational changes such as env vars, migrations, or deployment effects.
+- Use documentation updates for durable contracts, not transient implementation commentary.

package/skills/metacoding-workflow/references/react.md

@@ -0,0 +1,7 @@
+# React Guidance
+
+- Preserve the existing design system and interaction patterns unless the task explicitly changes them.
+- Keep component boundaries intentional; move complex state or effects out of leaf UI where possible.
+- Test user-observable behavior rather than implementation detail.
+- Verify loading, empty, error, and success states when the UI surface changes.
+- Update docs or notes only when the component contract or usage changes.

package/skills/metacoding-workflow/references/repository-organization.md

@@ -0,0 +1,84 @@
+# Repository Organization
+
+Use this reference to keep repository structure and documentation MECE. If the repo already has a different but coherent structure, preserve its conventions while keeping the same separation of concerns.
+
+## Root Directory Standards
+
+- Keep the root clean. Only essential top-level files should live there, such as `README.md`, `CHANGELOG.md`, `package.json`, `LICENSE`, and major config files.
+- Do not place application source files directly in the root.
+- Keep configuration files organized and documented.
+- Ensure ignore files exclude build artifacts, dependencies, temporary outputs, and generated local-agent files.
+
+## Directory Organization
+
+Prefer a structure equivalent to:
+
+```text
+/src        # application and library source code
+/test       # automated tests, fixtures, and test documentation
+/_meta      # system, architecture, API, and project-management docs
+```
+
+Within source and tests:
+
+- Group by feature or domain before grouping by file type.
+- Keep reusable modules under stable locations such as `components`, `services`, `types`, `utils`, or equivalents.
+- Keep test fixtures and helper data under the test tree, not in ad hoc temp folders.
+
+## MECE Documentation Architecture
+
+Each durable concept should have one primary home.
+
+- `README.md`
+  - project overview
+  - setup
+  - usage
+  - user-facing workflows
+- `/_meta/system-documentation.md`
+  - evergreen system behavior
+  - stable repository structure
+  - non-temporal technical guidance
+- `/_meta/api-design.md`
+  - API contracts
+  - integration patterns
+  - interface decisions
+- `/_meta/architecture-decisions.md`
+  - architectural tradeoffs and rationale
+- `/_meta/project-task-list.md`
+  - active tasks
+  - roadmap items
+  - status tracking and temporal planning
+- `/test/test-documentation.md`
+  - documented test cases
+  - test strategy
+  - coverage intent and scenario tracking
+
+Rules:
+
+- Do not duplicate the same policy or status across multiple documents.
+- Keep system documentation evergreen and free of task-status noise.
+- Keep project-management documents temporal and status-oriented.
+- Keep test intent in test documentation, not scattered through unrelated docs.
+- Update exactly the artifact whose responsibility changed.
+
+## Temporary File Management
+
+- Remove temporary files, debug outputs, and experimental artifacts after they are no longer needed.
+- Move useful temporary material to the correct permanent location:
+  - test data to `/test/fixtures/`
+  - documentation samples to the relevant doc
+  - config examples to examples or documentation
+- Do not leave orphaned files behind after implementation or verification.
+
+## File Naming and Organization
+
+- Keep tests within the test tree.
+- Keep one main responsibility per file where practical.
+- Prefer descriptive, stable names over generic scratch names.
+- Avoid mixing unrelated concerns inside a single file or folder.
+
+## Workflow Implications
+
+- Repository organization is not optional polish. Validate it during repo grounding.
+- If a requested change would create documentation overlap or structural drift, correct the organization as part of the task or record the follow-up explicitly.
+- Mandatory TDD depends on this structure: test documentation belongs under `/test`, project status belongs under `/_meta`, and implementation belongs under source directories.

package/skills/metacoding-workflow/references/typescript.md

@@ -0,0 +1,7 @@
+# TypeScript Guidance
+
+- Prefer explicit types at public boundaries and inferred types within local implementation detail.
+- Keep modules small, composable, and side-effect aware.
+- Validate runtime input explicitly; types alone do not protect process boundaries.
+- Update or add tests for behavior changes before broad refactors.
+- Document only non-obvious contracts and invariants.