{
  "markdown": "# Wukong Code\n\n<p align=\"center\">\n  <img src=\"./assets/readme/hero.png\" width=\"100%\" alt=\"Wukong Code: a complete software development methodology for coding agents. Design first, TDD, and evidence before claims.\">\n</p>\n\n**A complete software development methodology for coding agents**\n\nDesign first · Test-driven development · Evidence before claims\n\n[License: MIT](LICENSE)\n[Version](https://github.com/wukongnotnull/wukong-code/tags)\n[Plugin](https://github.com/wukongnotnull/wukong-code)\n[Stars](https://github.com/wukongnotnull/wukong-code/stargazers)\n\n**Languages:** [English](README.md) · [简体中文](README.zh-CN.md) · [繁體中文](README.zh-TW.md) · [日本語](README.ja.md) · [한국어](README.ko.md)\n\n> Wukong Code gives your coding agent a set of composable skills and the startup instructions that make those skills activate at the right moment—from brainstorming and planning to TDD, review, and verification.\n\n<p align=\"center\">\n  <img src=\"./assets/readme/workflow.svg\" width=\"100%\" alt=\"Development path: design, plan, RED, GREEN, then verify.\">\n</p>\n\n---\n\n**Quick nav**\n\n[Why Wukong Code](#why-wukong-code) · [How it works](#how-it-works) · [Install](#supported-agents--installation) · [Workflow](#the-basic-workflow) · [Skills](#whats-inside) · [Language guidance](#language-guidance) · [FAQ](#faq) · [Contributing](#contributing) · [License](#license)\n\n---\n\n## Why Wukong Code\n\n| Capability | What you get |\n| --- | --- |\n| **Design before code** | The agent clarifies intent, explores alternatives, and gets approval before implementation |\n| **Executable plans** | Approved designs become small tasks with exact files and verification steps |\n| **True TDD** | RED–GREEN–REFACTOR is enforced instead of tests being added after the code |\n| **Systematic debugging** | Root causes are investigated before fixes are proposed |\n| **Review in the loop** | Work is checked for spec compliance and code quality as it progresses |\n| **Evidence before claims** | Completion requires fresh verification output, not assumptions |\n| **Automatic activation** | Skills trigger from the task context; no special per-task prompt is required |\n\nFor developers who want coding agents to follow a repeatable engineering process—not just generate code quickly.\n\n---\n\n## How it works\n\nWukong Code starts working when an agent session begins. It routes the request into the relevant development or Product Design workflow, then loads only the focused skills needed for that task.\n\n### Software development\n\nWhen the agent detects a build or behavior-change request, it pauses implementation and first works out what you are actually trying to accomplish.\n\nAfter you approve the design, the agent creates a concrete implementation plan, follows true red/green TDD, delegates isolated tasks when appropriate, reviews the result, and verifies the complete change before calling it done.\n\n```text\nYour idea\n   ↓\nBrainstorm → Approved design → Implementation plan\n   ↓\nRED → GREEN → REFACTOR → Review → Verification\n   ↓\nMerge / PR / keep the branch\n```\n\n### Product Design\n\nProduct Design closes the gap between product ideas and working software. It uses saved product context—such as brand assets, design systems, screenshots, components, and preferred tools—when available, then follows the path that matches your goal:\n\n```text\nResearch or audit\nProduct / flow → Capture current evidence → UX, visual, and accessibility findings\n\nExplore a new direction\nDesign brief → 3 visual options → You choose → Responsive prototype\n\nClone or implement\nLive URL or selected visual → Frontend build → Design QA → Preview / share\n```\n\nResearch and audits remain evidence-based and do not modify source code. New designs require a selected visual direction before implementation. Prototype handoff is blocked until the rendered result has been compared with its visual source and Design QA passes.\n\nBecause the skills activate automatically, you work with your coding agent normally. The appropriate development or Product Design process is built into the session and adapts to the browser, image-generation, local-build, and sharing capabilities that are actually available.\n\n---\n\n## Supported agents & installation\n\nInstallation differs by harness. If you use more than one, install Wukong Code separately for each one.\n\n**Supported:** [Antigravity](#antigravity) · [Claude Code](#claude-code) · [Codex App](#codex-app) · [Codex CLI](#codex-cli) · [Cursor](#cursor) · [Factory Droid](#factory-droid) · [GitHub Copilot CLI](#github-copilot-cli) · [Kimi Code](#kimi-code) · [OpenCode](#opencode) · [Pi](#pi)\n\n### Antigravity\n\nInstall the plugin from this repository:\n\n```bash\nagy plugin install https://github.com/wukongnotnull/wukong-code\n```\n\nAntigravity runs the session-start hook, so Wukong Code is active from the first message. Reinstall with the same command to update.\n\n### Claude Code\n\nInstall from this repository:\n\n```bash\n/plugin marketplace add wukongnotnull/wukong-code\n/plugin install wukong-code@wukong-code\n```\n\n### Codex App\n\nWukong Code is not listed in the official Codex plugin marketplace. Install it directly from this repository:\n\n1. Click **Plugins** in the Codex sidebar.\n2. Choose the option to install a plugin from a repository URL.\n3. Enter `https://github.com/wukongnotnull/wukong-code` and follow the prompts.\n\n### Codex CLI\n\nAdd this repository as a marketplace source, then install Wukong Code:\n\n```bash\n/plugin marketplace add wukongnotnull/wukong-code\n/plugin install wukong-code@wukong-code\n```\n\n### Cursor\n\nIn Cursor Agent chat:\n\n```text\n/add-plugin wukong-code\n```\n\nOr search for `wukong-code` in the plugin marketplace.\n\n### Factory Droid\n\n```bash\ndroid plugin marketplace add https://github.com/wukongnotnull/wukong-code\ndroid plugin install wukong-code@wukong-code\n```\n\n### GitHub Copilot CLI\n\n```bash\ncopilot plugin marketplace add wukongnotnull/wukong-code\ncopilot plugin install wukong-code@wukong-code\n```\n\n### Kimi Code\n\nOpen `/plugins`, go to **Marketplace → Wukong Code**, and install it. You can also install directly:\n\n```text\n/plugins install https://github.com/wukongnotnull/wukong-code\n```\n\nSee the [Kimi Code installation guide](docs/README.kimi.md) for details.\n\n### OpenCode\n\nTell OpenCode:\n\n```text\nFetch and follow instructions from https://raw.githubusercontent.com/wukongnotnull/wukong-code/refs/heads/main/.opencode/INSTALL.md\n```\n\nSee the [OpenCode installation guide](docs/README.opencode.md) for details.\n\n### Pi\n\nInstall as a Pi package:\n\n```bash\npi install git:github.com/wukongnotnull/wukong-code\n```\n\nFor local development:\n\n```bash\npi -e /path/to/wukong-code\n```\n\nThe Pi package loads the skills and injects the `using-wukong-code` bootstrap at startup and after compaction. Pi has native skills; subagent and task-list tools remain optional companion packages.\n\n---\n\n## The basic workflow\n\n### Software development workflow\n\n1. **using-wukong-code** — Checks the task before any action and selects the smallest applicable workflow.\n2. **brainstorming**, **systematic-debugging**, or a direct path — Routes feature work through design, unclear bugs through root-cause investigation, and exact mechanical edits directly.\n3. **writing-plans** — Turns an approved multi-step design into small tasks with exact file paths and verification steps.\n4. **using-git-worktrees** — Creates an isolated workspace and verifies a clean test baseline when the execution needs isolation.\n5. **subagent-driven-development** or **executing-plans** — Executes the plan with task-level review or human checkpoints; implementation uses RED–GREEN–REFACTOR when TDD applies.\n6. **verification-before-completion** and code review — Requires fresh evidence and checks the whole result before completion claims.\n7. **finishing-a-development-branch** — Honors an existing integration intent or offers merge, PR, keep, and discard options.\n\n**The agent checks for relevant skills before every task. These workflows are requirements, not suggestions.**\n\n### Product Design workflow\n\n1. **product-design** — Identifies the goal and routes the request to the appropriate focused Product Design skill.\n2. **product-design-user-context** — Loads saved brand assets, design systems, screenshots, references, and preferences when they can ground the task.\n3. **product-design-context** — Clarifies the design target, intended user, and desired outcome before visual exploration or implementation.\n4. **product-design-research**, **product-design-audit**, or **product-design-ideate** — Researches current user pain, audits captured product evidence, or generates three visual directions for selection.\n5. **product-design-url-to-code** or **product-design-image-to-code** — Faithfully recreates a live URL or implements the selected visual target as a responsive frontend.\n6. **product-design-design-qa** — Compares the rendered prototype with its visual source and blocks handoff until the comparison passes.\n7. **product-design-share** — Publishes the runnable prototype and returns a shareable link when the user asks to deploy or share it.\n\n**These skills do not run as one fixed sequence on every request. Product Design selects the shortest applicable path for research, audit, ideation, cloning, implementation, QA, or sharing.**\n\n---\n\n## What's inside\n\n**26 top-level skills**: 16 general development skills and 10 Product Design skills.\n\n| Area | Skills and guidance |\n| --- | --- |\n| **Testing** | `test-driven-development`, testing anti-patterns |\n| **Debugging** | `systematic-debugging`, root-cause tracing, defense in depth, condition-based waiting |\n| **Verification** | `verification-before-completion` |\n| **Planning** | `brainstorming`, `grilling`, `writing-plans`, `executing-plans` |\n| **Collaboration** | `dispatching-parallel-agents`, `subagent-driven-development`, `requesting-code-review`, `receiving-code-review` |\n| **Workspace** | `using-git-worktrees`, `finishing-a-development-branch` |\n| **Language implementation** | Experimental evidence-based `language-guidance` packs |\n| **Meta** | `writing-skills`, `using-wukong-code` |\n\n### Product Design\n\nVersion `6.3.0` bundles these ten Product Design skills:\n\n| Skill | Purpose |\n| --- | --- |\n| `product-design` | Routes Product Design requests to the appropriate focused workflow |\n| `product-design-user-context` | Saves or loads brand assets, design systems, screenshots, references, and preferences |\n| `product-design-context` | Clarifies the design target, intended user, and desired outcome |\n| `product-design-research` | Researches current user pain points and product opportunities from fresh sources |\n| `product-design-audit` | Audits product flows for UX, visual-design, and accessibility issues using captured evidence |\n| `product-design-ideate` | Generates three subject-grounded, intentional visual directions with an anti-template critique |\n| `product-design-url-to-code` | Faithfully recreates a live URL as a runnable local frontend prototype |\n| `product-design-image-to-code` | Implements a selected visual source as a responsive, interactive frontend |\n| `product-design-design-qa` | Compares the rendered implementation with its visual source and gates handoff |\n| `product-design-share` | Publishes a runnable prototype and returns a shareable link when requested |\n\nThey are imported from Product Design `0.1.52`. Their MIT provenance is\nrecorded in [`product-design.lock.json`](product-design.lock.json) and\n[`THIRD_PARTY_NOTICES.md`](THIRD_PARTY_NOTICES.md).\n\n---\n\n## Language Guidance\n\nWukong Code remains language-agnostic at the methodology level. When repository evidence identifies a supported language and phase, the agent loads only the relevant implementation guidance. Packs do not install tools or override repository commands.\n\n| Language | Status | Implementation | Testing | Debugging | Review | Verification | Evidence |\n| --- | --- | --- | --- | --- | --- | --- | --- |\n| Go | Experimental | ✓ | ✓ | ✓ | ✓ | ✓ | [Eval report](docs/wukong-code/evals/2026-07-22-go-language-guidance.md) |\n| Java | Experimental | ✓ | ✓ | ✓ | ✓ | ✓ | [Eval report](docs/wukong-code/evals/2026-08-02-java-language-guidance.md) |\n| TypeScript | Experimental | ✓ | ✓ | ✓ | ✓ | ✓ | [Cursor recapture-15 draft](docs/wukong-code/evals/2026-09-01-typescript-language-guidance-cursor-recapture-15.md) — publication eval pending |\n| JavaScript | Experimental | ✓ | ✓ | ✓ | ✓ | ✓ | [Cursor recapture-15 draft](docs/wukong-code/evals/2026-09-01-javascript-language-guidance-cursor-recapture-15.md) — publication eval pending |\n| Swift | Experimental | ✓ | ✓ | ✓ | ✓ | ✓ | [Eval report](docs/wukong-code/evals/2026-07-29-swift-language-guidance.md) |\n| Rust | Experimental | ✓ | ✓ | ✓ | ✓ | ✓ | [Eval report](docs/wukong-code/evals/2026-07-29-rust-language-guidance.md) |\n\n**Experimental** means the pack is published in core while real-project evidence is still accumulating. The Evidence column lists a report when one exists; drafts marked *publication eval pending* have not cleared every behavior family or human reviewer gate. Framework, cloud-service, database, and team-specific guidance stays outside core.\n\n---\n\n## Philosophy\n\n| Principle | Meaning |\n| --- | --- |\n| **Test-driven development** | Write the failing test first |\n| **Systematic over ad hoc** | Follow a repeatable process instead of guessing |\n| **Complexity reduction** | Prefer the smallest clear solution |\n| **Evidence over claims** | Verify before declaring success |\n\n---\n\n## FAQ\n\n**Do I need to invoke skills manually?**\n\nNo. A working harness integration loads the bootstrap at session start, and the agent selects relevant skills from the task context.\n\n**Can I install Wukong Code in more than one coding agent?**\n\nYes. Install it separately in each harness because their plugin systems are independent.\n\n**How do I update it?**\n\nUse the update flow provided by your harness. Repository-based installs can generally be refreshed by repeating the installation command.\n\n**Does Wukong Code install project dependencies?**\n\nNo. Core is zero-dependency and its language packs do not install tools or replace repository-defined commands.\n\n**Where do the behavior evals live?**\n\nSkill-behavior evals live in [wukong-code-evals](https://github.com/wukongnotnull/wukong-code-evals), cloned locally into `evals/`. Plugin-infrastructure tests remain in `tests/`.\n\n---\n\n## Contributing\n\nWukong Code accepts new skills after maintainer review when they solve a\nconcrete problem, have a clear intended audience, and can be maintained safely\nacross supported harnesses. Domain-specific and externally sourced skills are eligible\nfor core review; contributors must disclose the source, license, dependency impact,\ntests or evaluations, and maintenance or update strategy. Core skills remain\nzero-dependency unless a separately documented harness-support exception applies.\n\n1. Fork the repository and create a focused branch from `main`.\n2. Read and complete every section of `.github/PULL_REQUEST_TEMPLATE.md`.\n3. Use `writing-skills` when creating or changing behavior-shaping skill content.\n4. Run the relevant infrastructure tests and behavior evaluations.\n5. Show a human the complete proposed diff and obtain approval before submission.\n6. Submit one focused PR targeting `main`.\n\nSee `skills/writing-skills/SKILL.md` for the complete skill-development guide.\n\n---\n\n## About\n\n**悟空非空也 (Wukong)** — Founder of Way to AI, indie developer, content creator.\n\n| Platform | Link |\n| --- | --- |\n| 🌐 Website | [waytoai.cn](https://waytoai.cn) |\n| 𝕏 Twitter | [悟空非空也](https://x.com/wukongnotnull) |\n| 📺 Bilibili | [悟空非空也](https://space.bilibili.com/456634391) |\n| ▶️ YouTube | [悟空非空也](https://www.youtube.com/@wukongnotnull) |\n| 📕 Xiaohongshu | [悟空非空也](https://www.xiaohongshu.com/user/profile/5ca89c2f000000001100952b) |\n| 💬 WeChat | Search「悟空非空也」 |\n\n---\n\n## Acknowledgements\n\nThanks to the following open-source projects and skill collections for their inspiration and foundational work:\n\n- [Superpowers](https://github.com/obra/superpowers)\n- [Frontend Design](https://github.com/anthropics/skills/tree/main/skills/frontend-design)\n- [Product Design](https://github.com/openai/role-specific-plugins/tree/main/plugins/product-design)\n\n---\n\n## License\n\nWukong Code is released under the [MIT License](LICENSE). Third-party notices are recorded in [`THIRD_PARTY_NOTICES.md`](THIRD_PARTY_NOTICES.md).\n\nMIT License © [悟空非空也](https://github.com/wukongnotnull)\n",
  "bytes": 16419,
  "sha": "4c60398d22e3cf85c2a0a9c66b53c027e8c1d42457e2e19cbd57208aa691f4de",
  "repo_slug": "wukongnotnull/wukong-code",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_wukongnotnull_wukong_code_5b2f24f9/readme"
}