[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-82148":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":13,"openIssues":14,"contributorsCount":14,"subscribersCount":14,"size":14,"stars1d":14,"stars7d":14,"stars30d":15,"stars90d":14,"forks30d":14,"starsTrendScore":14,"compositeScore":16,"rankGlobal":10,"rankLanguage":10,"license":10,"archived":17,"fork":17,"defaultBranch":18,"hasWiki":19,"hasPages":17,"topics":20,"createdAt":10,"pushedAt":10,"updatedAt":21,"readmeContent":22,"aiSummary":23,"trendingCount":14,"starSnapshotCount":14,"syncStatus":24,"lastSyncTime":25,"discoverSource":26},82148,"HarnessFlow","HangYu8123\u002FHarnessFlow","HangYu8123","Harness coding workflow for codex, claude, github copilot","",null,"Shell",201,16,0,93,49.99,false,"main",true,[],"2026-06-12 04:01:37","\u003Cdiv align=\"center\">\n\n\u003Cimg src=\"harnessflow.png\" alt=\"AI Agents Workflow\" width=\"100%\">\n\n\n# AI Agents Workflow\n\n**Keep repo-level context in one place once the repo has been initialized.**\n\nThis pack supports **VS Code + Copilot**, **Claude Code CLI**, and **Codex CLI**.\nCopy it into a target repo under `.github\u002Fharness_coding_instructions` so the agent can route requests to the right workflow file and follow a more consistent process.\n\n[VS Code](#vs-code--copilot) · [Claude Code CLI](#claude-code-cli) · [Codex CLI](#codex-cli) · [Setup](#quick-start) · [Architecture](#architecture)\n\n**English** | **简体中文**\n\n\u003C\u002Fdiv>\n\n## What Is This Pack For?\n\n`harness_coding_instructions` is a portable instruction pack for coding agents. Copy it into a target repository so the agent can route requests through consistent workflows for implementation, debugging, questions, correctness checks, refactors, initialization, command execution, and PR breakdowns.\n\n## Architecture\n\nThe source repo stores the pack at the repo root. The installed layout expected by the scripts and CLI entry points is:\n\n```text\n\u003Ctarget-repo>\u002F\n|-- .github\u002F\n|   |-- copilot-instructions.md\n|   `-- harness_coding_instructions\u002F\n|       |-- AGENTS.md\n|       |-- CLAUDE.md\n|       |-- copilot-instructions.md\n|       |-- setup.sh\n|       |-- cli_setup.sh\n|       |-- _lib\u002F\n|       |-- philosophy\u002F\n|       |-- workflow\u002F\n|       |-- agents\u002F\n|       |-- request_template\u002F\n|       |-- skills\u002F\n|       `-- repo_info\u002F\n|-- AGENTS.md\n|-- CLAUDE.md\n`-- .claude\u002F\n    `-- rules\u002F\n```\n\n`AGENTS.md` and `CLAUDE.md` at the target repo root are generated by `cli_setup.sh`. `.github\u002Fcopilot-instructions.md` is generated by `setup.sh` or `cli_setup.sh`.\n\n## Quick Start\n\nCopy this repo's contents into a target repo at `.github\u002Fharness_coding_instructions\u002F`.\n\nExample from a Unix-like shell:\n\n```bash\ncd \u002Fpath\u002Fto\u002Ftarget-repo\nmkdir -p .github\nrsync -a --exclude .git \u002Fpath\u002Fto\u002Fcoding_prompts\u002F .github\u002Fharness_coding_instructions\u002F\n```\n\n\u003Ca id=\"vs-code--copilot\">\u003C\u002Fa>\n\nFor VS Code + Copilot:\n\n```bash\nbash .github\u002Fharness_coding_instructions\u002Fsetup.sh\n```\n\n\u003Ca id=\"claude-code-cli\">\u003C\u002Fa>\n\u003Ca id=\"codex-cli\">\u003C\u002Fa>\n\nFor Claude Code CLI, Codex CLI, or Codex in VS Code:\n\n```bash\nbash .github\u002Fharness_coding_instructions\u002Fcli_setup.sh\n```\n\nThen run the initialize workflow once in the target repo so `repo_info\u002F` contains target-specific memory:\n\n```text\nFollowing the instructions in @\u002F.github\u002Fharness_coding_instructions\u002Fworkflow\u002Fvscode_workflow\u002Finitialize.instructions.md, initialize this repo.\n```\n\nFor CLI tools, ask naturally from the target repo root after setup:\n\n```bash\nclaude\n# or\ncodex\n```\n\n## Supported Environments\n\n| Environment | Entry point | Workflow directory | Notes |\n|---|---|---|---|\n| VS Code + Copilot | `.github\u002Fcopilot-instructions.md` | `workflow\u002Fvscode_workflow\u002F` | Primary VS Code router. |\n| VS Code fast mode | Request templates with `mode: fast` | `workflow\u002Fvscode_token_effective_workflow\u002F` | Faster, more parallel workflow variants. |\n| Claude Code CLI | Root `CLAUDE.md` | `workflow\u002Fclaudecode_workflow\u002F` | Uses Claude Code native mechanisms and Claude-only skill steps. |\n| Codex CLI \u002F Codex in VS Code | Root `AGENTS.md` | `workflow\u002Fcodex_workflow\u002F` | General Codex workflows with manual review fallbacks where Claude skills do not apply. |\n| Codex fast mode | Root `AGENTS.md` with `mode: fast` | `workflow\u002Fcodex_token_effective_workflow\u002F` | Token-effective Codex workflows for CLI and Codex in VS Code. |\n| Aider or generic LLMs | Manual file references | Any workflow file | The Markdown can be followed manually, but subagent orchestration is not wired. |\n\n## What Is In This Repo\n\n| Path | Purpose |\n|---|---|\n| `copilot-instructions.md` | VS Code Copilot router template. |\n| `CLAUDE.md` | Claude Code CLI router template copied to the target repo root by `cli_setup.sh`. |\n| `AGENTS.md` | Codex CLI router template copied to the target repo root by `cli_setup.sh`. |\n| `_lib\u002F` | Shared workflow contract, safety rules, and approval-gate rules. |\n| `philosophy\u002F` | Shared behavioral guidance used by workflows and subagents. |\n| `workflow\u002F` | Tool-specific workflow instruction families. |\n| `agents\u002F` | Custom agent definitions plus `agents\u002FINDEX.md`. |\n| `request_template\u002F` | Fill-in request templates, including `mode: general` and `mode: fast` selection. |\n| `skills\u002F` | Skill definitions, including PR breakdown and Claude-native post-implementation skill orchestration. |\n| `.claude\u002Frules\u002F` | Claude Code path-scoped rules copied to target repos by `cli_setup.sh`. |\n| `setup.sh` | Configures VS Code workspace settings and generated Copilot instructions in a target repo. |\n| `cli_setup.sh` | Generates CLI entry points and ensures target `repo_info\u002F` files exist. |\n| `repo_info\u002F` | Local\u002Fgenerated repo memory files. This directory is ignored by git in this source repo. |\n\n## Workflow Families\n\nEach workflow family currently contains these instruction files:\n\n```text\ncode.instructions.md\ncorrectness_check.instructions.md\ndebug.instructions.md\nexec.instructions.md\ninitialize.instructions.md\npr.instructions.md\nquery.instructions.md\nrefactor.instructions.md\n```\n\nThe five workflow families are:\n\n| Directory | Intended use |\n|---|---|\n| `workflow\u002Fvscode_workflow\u002F` | Full VS Code Copilot workflows. |\n| `workflow\u002Fvscode_token_effective_workflow\u002F` | Streamlined VS Code workflows selected by request templates with `mode: fast`. |\n| `workflow\u002Fclaudecode_workflow\u002F` | Claude Code CLI workflows. |\n| `workflow\u002Fcodex_workflow\u002F` | Codex CLI workflows. |\n| `workflow\u002Fcodex_token_effective_workflow\u002F` | Streamlined Codex workflows selected by `mode: fast` under Codex CLI or Codex in VS Code. |\n\nThe root routers classify the six common categories: initialize, code implementation, debug, query, correctness check, and refactor. The PR workflow exists as `pr.instructions.md` in every workflow family and is exposed through `request_template\u002Fpr_request_template.md` or by directly referencing the PR workflow file.\n\n## Setup Scripts\n\n### `setup.sh`\n\nRun from the target repo root after copying the pack to `.github\u002Fharness_coding_instructions\u002F`.\n\nIt validates that the pack is present, then writes or updates `.vscode\u002Fsettings.json` with:\n\n```json\n{\n  \"chat.instructionsFilesLocations\": {\n    \".github\u002Fharness_coding_instructions\": true,\n    \".claude\u002Frules\": true\n  },\n  \"chat.agentFilesLocations\": {\n    \".github\u002Fharness_coding_instructions\u002Fagents\": true\n  },\n  \"chat.includeReferencedInstructions\": true\n}\n```\n\nIt also creates or refreshes `.github\u002Fcopilot-instructions.md` when that file is generated by this pack. Existing custom Copilot instructions are left unchanged.\n\nWhen merging an existing VS Code settings file, the script tries `python3`, then `node`, then `jq`. If none are available, it prints manual settings to add.\n\n### `cli_setup.sh`\n\nRun from the target repo root after copying the pack to `.github\u002Fharness_coding_instructions\u002F`.\n\nIt:\n\n- Detects whether `claude` or `codex` is on `PATH`.\n- Creates or refreshes root `CLAUDE.md` and `AGENTS.md` when they are generated by this pack.\n- Creates or refreshes `.github\u002Fcopilot-instructions.md` when appropriate.\n- Copies `.claude\u002Frules\u002F*.md` into the target repo.\n- Ensures the eight canonical `repo_info\u002F` files exist under the installed pack.\n\nExisting custom files are not overwritten unless they contain this pack's generated markers.\n\n## Request Templates\n\n`request_template\u002F` contains user-facing prompt templates:\n\n```text\ncode_request_template.md\ncorrectness_check_request_template.md\ndebug_request_template.md\ninitialize_request_template.md\npr_request_template.md\nquery_request_template.md\nrefactor_request_template.md\n```\n\nTemplates use:\n\n```text\nmode: general\n```\n\nor:\n\n```text\nmode: fast\n```\n\nFor VS Code Copilot, `general` selects `workflow\u002Fvscode_workflow\u002F` and `fast` selects `workflow\u002Fvscode_token_effective_workflow\u002F`.\nFor Codex CLI or Codex in VS Code, `general` selects `workflow\u002Fcodex_workflow\u002F` and `fast` selects `workflow\u002Fcodex_token_effective_workflow\u002F`. The templates use `@\u002F.github\u002Fharness_coding_instructions\u002F...` paths for VS Code Copilot and filesystem paths for Codex.\n\n## Agents And Skills\n\n`agents\u002F` defines coordinator agents and worker agents. Coordinator agents include Code Workflow, Debug Workflow, Refactor Workflow, Query Workflow, and Correctness Workflow. Worker agents include Focus Analyst, Broad Analyst, Free Analyst, Senior Engineer, Principal Engineer, Devils Advocate, Online Researcher, Implementer, QA Engineer, Bug Reproducer, and several refactor-focused analysts.\n\nSee `agents\u002FINDEX.md` for the complete registry.\n\n`skills\u002F` currently contains:\n\n- `breakdown-pr`: analyzes a large branch or PR and proposes a stacked PR breakdown.\n- `claude-native-skills-subagents`: Claude Code-only post-implementation orchestration for native skills such as `\u002Fsimplify`, `\u002Fbatch`, `\u002Fdebug`, and `\u002Fclaude-api`.\n\n## Repo Memory\n\nWorkflows use `repo_info\u002F` as persistent repo memory. `cli_setup.sh` ensures these canonical files exist in the installed pack:\n\n```text\ncodebase_overview.md\nknown_issues.md\nknown_issues_auto_generated.md\npast_Correctness_Check.md\npast_Q&A.md\nscripts_overview.md\nupdate_logs.md\nupdate_logs_auto_generated.md\n```\n\nIn this source repo, `repo_info\u002F` is ignored by git. In a target repo, initialize or refresh it for that specific codebase before relying on later workflows.\n\n## Path Rules\n\n- In this source repo, paths are root-relative, for example `workflow\u002Fcodex_workflow\u002Fcode.instructions.md` or `workflow\u002Fcodex_token_effective_workflow\u002Fcode.instructions.md`.\n- In an installed target repo, the pack lives under `.github\u002Fharness_coding_instructions\u002F`.\n- VS Code workflow prompts may use `@\u002F.github\u002Fharness_coding_instructions\u002F...`.\n- CLI entry points use filesystem-relative paths such as `.github\u002Fharness_coding_instructions\u002Fworkflow\u002Fcodex_workflow\u002Fcode.instructions.md` and `.github\u002Fharness_coding_instructions\u002Fworkflow\u002Fcodex_token_effective_workflow\u002Fcode.instructions.md`.\n- Do not add VS Code `@\u002F` prefixes to CLI workflow files.\n\n## Safety Rules\n\nThe shared workflow contract and safety rules require:\n\n- Do not try to commit changes to GitHub.\n- Do not write spam files into the repo.\n- Do not use `sudo`.\n- For code, debug, and refactor workflows, print the finalized plan before implementation. If the user requested no code changes, stop after the plan; otherwise continue.\n\nKeep destructive auto-approval disabled for any command that can delete or overwrite user files.\n\n## Limitations\n\n- This repo is an instruction pack, not an application. There is no package manifest, runtime, build command, or formal test suite.\n- The setup scripts are Bash scripts.\n- CLI subagent behavior depends on the capabilities of the active CLI tool and model parity support.\n- Claude-native skill steps only apply in Claude Code environments.\n- The source repo ignores `.github\u002F` and `repo_info\u002F`, so generated target-repo files are not tracked here.\n- Root `AGENTS.md` and `CLAUDE.md` in this source repo are templates for installed target repos; their `.github\u002Fharness_coding_instructions\u002F...` paths are expected to resolve after installation.\n\n## Typical Usage\n\nFor normal work, ask naturally and let the active router classify the request. Use request templates when you want strict mode selection or when you want to force the agent to read a specific workflow file first.\n\nExamples:\n\n```text\nUpdate the README based on this repo.\n```\n\n```text\nmode: fast\n\nFollow the corresponding debug.instructions.md and fix the failing test described below.\n```\n\n```text\nUse request_template\u002Fpr_request_template.md to break this branch into reviewable PRs.\n```\n","HarnessFlow 是一个用于管理 Codex、Claude 和 GitHub Copilot 编码工作流的工具包。它通过提供一致的工作流程文件，帮助开发者在不同编码助手之间切换时保持代码仓库上下文的一致性。核心功能包括支持 VS Code + Copilot、Claude Code CLI 以及 Codex CLI 的集成，并且能够自动处理初始化、实现、调试、提问、正确性检查、重构和 PR 分解等任务。适用于需要跨多种AI辅助工具进行开发的场景，特别是对于希望提高团队协作效率和代码一致性要求较高的项目。",2,"2026-06-11 04:07:52","CREATED_QUERY"]