metacoding

metacoding: Workflow Skill for Coding Agents

metacoding packages a cross-agent workflow skill that enforces disciplined delivery for modern coding agents. Instead of generating editor-specific instruction files, it installs vendor-specific skills for Codex, Claude Code, or Antigravity from one shared workflow bundle.

What It Installs

Running metacoding init now asks which coding agent you use:

• Codex
• Claude Code
• Antigravity

You can also pass --vendor codex, --vendor claude-code, or --vendor antigravity. For mixed-agent teams, you can use --vendor all to install all workspace-scoped variants.

The installed entrypoint depends on that choice:

Codex:       .codex/skills/metacoding-workflow/SKILL.md
Claude Code: .claude/agents/metacoding-workflow.md
Antigravity: .agents/skills/metacoding-workflow/SKILL.md

The support bundle is installed alongside the entrypoint. The shared content includes:

references/
  project-context.md
  workflow-rules.md
  platform-adaptation.md
  typescript.md
  javascript.md
  node.md
  react.md
  python.md
assets/templates/
  task-entry.md
  test-plan.md
  repeated-task-checklist.md
  changelog-entry.md
  project-context.md

For Codex, the project install looks like:

.codex/skills/metacoding-workflow/
├── SKILL.md
├── agents/openai.yaml
├── references/
│   ├── project-context.md
│   ├── workflow-rules.md
│   ├── platform-adaptation.md
│   ├── typescript.md
│   ├── javascript.md
│   ├── node.md
│   ├── react.md
│   └── python.md
└── assets/templates/
    ├── task-entry.md
    ├── test-plan.md
    ├── repeated-task-checklist.md
    ├── changelog-entry.md
    └── project-context.md

The installed skill preserves the original metacoding workflow intent:

• Ground in the repo before asking questions.
• Capture scope before changing code.
• Define test intent before implementation.
• Execute one bounded task at a time.
• Verify with tests and direct checks.
• Update docs or status artifacts that materially changed.
• Close with a VCS handoff or completion confirmation.

CLI

Install

npm install -g metacoding
cd your-project
metacoding init

init remains interactive for project metadata such as project name, description, and tech stack. Use --vendor and --template to preselect those parts of the setup flow.

Common options:

• metacoding init --vendor codex
• metacoding init --vendor claude-code
• metacoding init --vendor antigravity
• metacoding init --vendor all
• metacoding init --template react
• metacoding init --template typescript
• metacoding init --template node
• metacoding init --template javascript
• metacoding init --template python
• metacoding init --force

Sync or Validate

metacoding update
metacoding update --dry-run
metacoding update --dry-run --strict
metacoding update --force

• update syncs the installed skill with the packaged version.
• update --vendor <vendor> syncs or validates only one installed vendor variant.
• update --vendor all syncs or validates all installed vendor variants explicitly.
• update --dry-run validates the installed skill without changing files.
• update --force overwrites local edits inside the installed skill directory.

Using the Skill

After installation, point your coding agent at the installed vendor entrypoint or ask it to use the metacoding-workflow skill/subagent for the next task.

The skill will:

• inspect the repo before asking clarifying questions
• keep work scoped to one bounded task
• push test intent ahead of production edits
• fall back to bundled templates when the repo lacks workflow artifacts
• produce a commit-ready handoff when git actions are unavailable or out of scope

Migration Note

This package no longer treats GitHub Copilot or Cursor instruction files as the primary product. The canonical content lives under skills/metacoding-workflow/, and the CLI now renders vendor-specific installs for Codex, Claude Code, or Antigravity from that shared bundle.

Development

npm test
npm run build

License

MIT For Antigravity, the CLI currently installs the documented workspace-scoped variant under .agents/skills/. It does not yet install the global variant under ~/.gemini/antigravity/skills/.