[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7DM8MH9G9VRRG0JXW8B3SM2":3,"skill-same:01M7DM8MH9G9VRRG0JXW8B3SM2":166},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":27,"repositoryHtmlUrl":28,"repositoryHomepageUrl":6,"ownerHtmlUrl":29,"ownerBlogUrl":30,"ownerDescription":6,"updatedAt":31,"install":32,"resources":45},"01M7DM8MH9G9VRRG0JXW8B3SM2","finhub-harness",null,"Designs a harness for a project or domain: the specialist agents, the skills each one uses and a surface-aware orchestrator for Claude Code, Claude chat or Claude Cowork. Use when the user asks to 'build a harness', 'set up a harness', 'design a harness', 'create an agent team', 'build an agent team for X', 'make a finhub harness', or to rework, extend, migrate or enrich a harness ('add an agent', 'upgrade the harness to v2', 'borrow the judge-panel pattern from repo Y'), and to operate one ('audit the harness', 'check harness status', 'sync agents and skills'). Do NOT use for a light, quick, small or cheap harness (use finhub-harness-light), for running a harness that already exists (call its orchestrator skill) or for folding run feedback back in (use finhub-harness-evolve).","danielnguyenfinhub\u002Ffinhub-harness","danielnguyenfinhub","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F264356854?v=4","01M7DM55XETDR9HF92FWC28SBN","Daniel Nguyen","01M7DM55YGJYBWW488JZSQYEJ4",1,"Apache-2.0","https:\u002F\u002Fgithub.com\u002Fdanielnguyenfinhub\u002Ffinhub-harness\u002Fblob\u002Fmain\u002Fskills\u002Ffinhub-harness\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: finhub-harness\ndescription: \"Designs a harness for a project or domain: the specialist agents, the skills each one uses and a surface-aware orchestrator for Claude Code, Claude chat or Claude Cowork. Use when the user asks to 'build a harness', 'set up a harness', 'design a harness', 'create an agent team', 'build an agent team for X', 'make a finhub harness', or to rework, extend, migrate or enrich a harness ('add an agent', 'upgrade the harness to v2', 'borrow the judge-panel pattern from repo Y'), and to operate one ('audit the harness', 'check harness status', 'sync agents and skills'). Do NOT use for a light, quick, small or cheap harness (use finhub-harness-light), for running a harness that already exists (call its orchestrator skill) or for folding run feedback back in (use finhub-harness-evolve).\"\n---\n\n# FinHub Harness — agent teams, their skills and a surface-aware orchestrator\n\n> Ported from revfactory\u002Fharness v2.1.0 (Apache-2.0), translated to English and extended for FinHub. Original: https:\u002F\u002Fgithub.com\u002Frevfactory\u002Fharness. FinHub additions: surface adaptation (Code \u002F chat \u002F Cowork), the Authority List with a fresh-context adversarial audit, mutation-tested boundary QA, and licence-tiered enrichment from other harness repos.\n\nDesign a harness that fits the project. Define each agent's role, write the skill each agent follows when it works, and write one orchestrator that says who collaborates, in what order, on which surface.\n\n**Light option.** If the user asks for a light, quick, small or cheap build, or the job is one small task, use `finhub-harness-light` instead: it is under a quarter of this file's size. A harness built here can still run light: see the Run mode bullet in Step 5.\n\n## Core principles\n\n1. Agent definitions live in `project\u002F.claude\u002Fagents\u002F`, skills in `project\u002F.claude\u002Fskills\u002F`. An agent definition says **who** works; a skill says **how** the work is done. Keep them apart.\n2. Choose the execution mode from the shape of the work. If the item list, the verification rule and the repeat condition can be written as code, orchestrate with a Workflow. If the same expert must trade feedback across turns, use persistent named agents. If you only need a result once, delegate to a sub-agent. Step 2-1 gives the rule; the full decision tree is `references\u002Fexecution-modes.md` §4.\n3. Choose the model per agent from the task's complexity, duration, autonomy and latency need: fable for long-horizon autonomous planning, opus for bounded deep reasoning (design, code generation, cross-checking), sonnet for routine work. The criteria are in `references\u002Fmodel-selection-guide.md`. Never set every agent to the top model because \"it matters\".\n4. Record only the trigger conditions and a change history in `CLAUDE.md`, so a new session can find the orchestrator. Everything else lives in the orchestrator and the agent\u002Fskill files.\n5. Feed what each run teaches back into the agents, skills and `CLAUDE.md`. The retrospective is `finhub-harness-evolve`'s job.\n6. Write every generated artefact in the language the user writes in. Do not copy this skill's language or the templates' example wording; translate headings and examples. If the user extends an existing harness, follow the language of the existing files.\n7. **Declare the target surface.** Every orchestrator says whether it runs on Claude Code, Claude chat, Claude Cowork or several. Modes A\u002FB\u002FC exist only in Claude Code; chat and Cowork need a single-context fallback. `references\u002Fsurfaces.md` says exactly how each primitive degrades.\n8. **Borrowed patterns carry a citation.** A design decision taken from a reference repo enters the harness through an Authority List row (`claim → references\u002F\u003Crepo>\u002F\u003Cpath>:\u003Cline>`, licence tier noted). A decision with no source is labelled NET-NEW with a reason and a named test, never a fake citation. `references\u002Fquality-gates.md` has the schema; `references\u002Fsource-enrichment.md` says what may be borrowed from where.\n\n## Procedure\n\n### Step 0: Check the current state\n\nRead `project\u002F.claude\u002Fagents\u002F`, `project\u002F.claude\u002Fskills\u002F`, `project\u002FCLAUDE.md` and, if present, `project\u002F.claude-plugin\u002Fplugin.json`. Then pick exactly one path:\n\n- **New build**: no agents or skills, or empty directories → run Steps 1-6 in full.\n- **Extend an existing harness**: add an agent, a skill, or change the structure → run only the steps in the table below.\n- **Operate \u002F maintain**: audit, repair or sync → go to Step 7.\n\n| Change | Step 1 | Step 2 | Step 3 | Step 4 | Step 5 | Step 6 |\n| --- | --- | --- | --- | --- | --- | --- |\n| Add an agent | skip, reuse Step 0 findings | decide only which mode, team and phase it joins | required | only if it needs a dedicated skill | edit the orchestrator | required |\n| Add or change a skill | skip | skip | skip | required | only if wiring changes | required |\n| Change structure or execution mode | skip | required | affected agents only | affected skills only | required | required |\n\nThen:\n\n1. **Detect v1 artefacts.** If an orchestrator or agent mentions `TeamCreate`, `TeamDelete`, `team_name`, `SendMessage({to: \"all\"})` or `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS`, it was built for v1 and will silently degrade to a single agent on the current runtime. Propose the v2 migration in `references\u002Fexecution-modes.md` §5 before anything else.\n2. **Detect the surface mismatch.** If the orchestrator assumes `Agent`\u002F`Workflow` tools but the user wants to run it in Claude chat or Cowork, add the single-context fallback (`references\u002Fsurfaces.md`) before extending it.\n3. Compare the real agent and skill list with the `CLAUDE.md` change history and list every mismatch.\n4. Report the findings and the plan to the user and get confirmation.\n\n### Step 1: Analyse the domain and the work\n\n1. Extract the domain and the goal from the request.\n2. Split the work by kind: generate, verify, edit, analyse.\n3. Characterise the flow so Step 2 can pick a mode:\n   - Can the item list be enumerated up front (N files, M viewpoints)?\n   - Is there a verify-then-fix loop?\n   - Does the result improve when agents argue with each other?\n   - Must the same expert stay in conversation within one session?\n4. Find overlaps or conflicts with the agents and skills found in Step 0.\n5. Skim the codebase: stack, data model, main modules, existing tests and gates (`pytest`, `ruff`, `mypy` or their equivalents) — the orchestrator's QA must run the real gates, not invent new ones.\n6. Match the explanation level to the user. Do not use \"assertion\" or \"JSON Schema\" without a gloss for a non-coder.\n7. **Which surface(s)?** Ask if it is not obvious. A harness for a mortgage-broking operator who works in Cowork with CRM connectors is a different artefact from one for a developer in Claude Code, even for the same domain.\n\n### Step 2: Choose the execution mode and the team pattern\n\n#### 2-0. Delegation gate (first; the default is one agent)\n\nBefore choosing a mode or a pattern, answer six questions in one line each: (1) which units of work are independent, or in what order they hand off, (2) what splitting buys: specialisation, parallel speed or a separate context, (3) which paths or resources each worker writes, (4) whether every worker's tools and permissions cover its task on the target surface, (5) who synthesises and accepts the result, (6) how a partial, blocked or conflicting result is reported. `references\u002Fteam-patterns.md` §6-1 says when an answer counts as unclear.\n\n- If any answer is missing or unclear, the outcome is **single agent**: the main context does the work, there is at most one agent file, and no Mode A or B and no parallel workers are used. Having an `Agent` or `Workflow` tool is not a reason to delegate. For an extension, \"at most one agent file\" counts the new role only: the new role then becomes a step of the main context or of an existing agent, not a new file.\n- Only when all six answers are concrete is the outcome **delegate**; then 2-1 to 2-3 and the Step 5 scale rule size the team. When extending a harness, run the gate again for the new role alone.\n- A dependent chain (pipeline, producer-reviewer, Mode B, a fresh-context judge, design then judge then build then QA) is concrete when each hand-off artefact is named; it delegates in sequence, and independence only decides whether calls run in parallel.\n- Rigor is a separate axis. The six answers never select a level, and a level never overrides them for the producing roles. A unit that the Rigor table runs `gated` adds a judge and a QA agent as an exception to the single-agent cap above (\"at most one agent file\"), which counts the producing roles only; their hand-off artefacts (the verdict, the report) are the named artefacts of question 1. (adapted from references\u002Fopenrig\u002Fpackages\u002Fdaemon\u002Fspecs\u002Fagents\u002Fshared\u002Fskills\u002Fpods\u002Freview-team\u002FSKILL.md:24-25 (Apache-2.0))\n- When the user explicitly asks for a team or names the roles, build what was asked: write each unclear answer under `## Delegation gate` as a stated risk and tell the user. The single-agent default applies when the user has not chosen.\n- A coordinator layer between the root and its workers needs one sentence in the orchestrator that names why the root cannot hold that work; without it, workers report to the root. The two-level cap in 2-2 stays.\n- Write the answers and the outcome in the orchestrator under `## Delegation gate` (Step 5).\n\n(adapted from references\u002Fmeta_harness\u002F.agents\u002Fskills\u002Fharness\u002Freferences\u002Fagent-design-patterns.md:221 (Apache-2.0); adapted from references\u002Fmeta_harness\u002F.agents\u002Fskills\u002Fharness\u002FSKILL.md:166 (Apache-2.0))\n\n#### 2-1. Execution mode (Claude Code)\n\n| Mode | Primitives | Fits |\n| --- | --- | --- |\n| **A. Workflow orchestration** | `Workflow` script: `agent()`, `pipeline()`, `parallel()`, `phase()`, `schema` | item list, verification rule and repeat count expressible as code; schema-validated results; dozens of agent calls |\n| **B. Persistent agent collaboration** | `Agent(name:)`, `SendMessage`, `TaskCreate`\u002F`TaskUpdate` | named experts that keep context across feedback, negotiation and joint editing |\n| **C. Sub-agent delegation** | one `Agent` call per task, background by default; independent calls parallel in one message, dependent calls one after another with the prior artefact path in the prompt | no agent-to-agent talk needed; a result once |\n\nDecide in this order: (1) if the list, rule and loop can be coded, use A — code-defined control flow is reproducible; (2) else if agents must converse or remember, use B; (3) else C — a short pipeline of one-shot agents is still Mode C, run sequentially; (4) mix modes per phase and write `**Execution mode:**` above each phase. Write only the mode(s) you chose; an orchestrator is not required to carry all three.\n\n`Workflow` needs the user's explicit opt-in. Invoking an orchestrator skill that declares a Workflow counts as opt-in. Keep the default agent count small; scale up only on \"thorough\", \"exhaustive\" or a stated token budget (`+500k`).\n\n> Details, concurrency caps, schemas, budgets and resume: `references\u002Fexecution-modes.md`. Chat and Cowork fallbacks: `references\u002Fsurfaces.md`.\n\n#### 2-2. Team pattern\n\nSplit the work by expertise, then pick from `references\u002Fteam-patterns.md`: **pipeline**, **fan-out\u002Ffan-in**, **expert pool**, **producer-reviewer**, **supervisor**, **hierarchical delegation** (two levels at most; one level of Workflow nesting).\n\nWhen correctness matters, add verification patterns: **adversarial verification** (N adversarial checkers per finding; only majority-`confirmed` passes; `refuted`\u002F`uncertain` never count as passes), **judge panel**, **loop-until-dry**, **multi-axis search**, **omission reviewer**. For harnesses that *design before they build*, add the FinHub pattern: an **Authority List** audited by a **fresh-context judge** (`references\u002Fquality-gates.md` §1-2), which is adversarial verification applied to the design itself.\n\n#### 2-3. Splitting agents\n\nSplit on expertise, parallelism, context load and reuse (`references\u002Fteam-patterns.md` §6). Before creating any agent, check `.claude\u002Fagents\u002F` for one that already covers the role and extend it instead (§7).\n\n### Step 3: Write the agent definitions\n\nReusable experts are custom types in `project\u002F.claude\u002Fagents\u002F{name}.md`, invoked with `subagent_type: \"{name}\"` (Agent) or `agentType: \"{name}\"` (Workflow). One-off tasks that fit `general-purpose`, `Explore` or `Plan` get no file.\n\n- Frontmatter: `name` and `description` required; `tools` to restrict (drop Edit and Write for read-only reviewers; give Edit *and* Write to anything that fixes artefacts); `model` with the reason as a comment.\n- Body: role, working principles with their reasons, input\u002Foutput rules, error handling, collaboration. Persistent agents (Mode B) add `## Communication rules`; Workflow-only agents (Mode A) add `## Structured output`; one-shot agents (Mode C) need neither — their `## Input and output rules` name the artefact paths they read and write. Skills are wired in the body (\"call `\u002Fskill-name` with the Skill tool\"); there is no `skills:` frontmatter field.\n- Connectors: an agent that cannot do its job without an MCP server or connector gets a `## Required connectors` section in its body, one server per line, written as the segment between `mcp__` and the next `__` in its tool names (`mcp__crm__search` → `crm`). Leave the section out when the agent needs none. In a harness that can send, write a record, publish or pay, only the sending worker lists the send, write or publish tools (`mcp__\u003Cserver>__*`) in its `tools:` allowlist; every other worker gets a `tools:` allowlist without any `mcp__` tool, because a worker with no `tools:` line inherits connector tools too and the Ask-first yes stops only the orchestrator (`lint_harness.py` warns `connector-tools-unscoped`). Step 5 copies these lines into the orchestrator's preflight table, so a missing connector stops the run before anyone is spawned instead of failing on the agent's first call. (adapted from references\u002Fopenharness\u002Fsrc\u002Fopenharness\u002Fcoordinator\u002Fagent_definitions.py:956 (MIT))\n- QA agents get a type with all tools except `mcp__` connector tools unless the agent is the sender (`Explore` cannot run scripts), compare shapes across boundaries rather than check existence, and run after every module, not once at the end (`references\u002Fqa-agent-guide.md`). Add the mutation spot-check from `references\u002Fquality-gates.md` §3 whenever the QA agent judges tests, count a mutant as killed only when `scripts\u002Fmutant_gate.py` prints `STATE: CAUGHT` for it (§3-4), and have it write a `CANDIDATE:` line under `RESULT:` so the verdict names the tree it judged (§3-7). Its definition file also says four things, because a QA agent follows only what its own file says: write `cause: context-gap` or `cause: judgment-gap` at the end of every defect row, under a heading written exactly `## Defects` (rows are `- defect: file:line ...` or `1. file:line ...`, observations are `- observation:` bullets, and no other line starts with the word Defect or Defects); copy the brief's Base line into a `BASE:` line; write one `drift:` row in its Gate table; and run `scripts\u002Ffinding_tags.py check` on its report last (§3-8, `qa-agent-guide.md` §6 and §7-10; adapted from references\u002Fopenrig\u002Fdocs\u002Freference\u002Fwave-sdlc.md:54-62 (Apache-2.0)).\n- A QA or judge agent file also says to copy the `Rigor:` line of its brief into a `RIGOR:` line (line 5 of a QA report after `BASE:`, line 4 of a verdict after `CARRIED:`), to choose and change no level or class, and to add no check because an earlier one found something (`references\u002Fquality-gates.md` section 3-10). The check that reads those lines is `scripts\u002Frigor_check.py`. In a `standard` unit the judge runs one round and QA runs once per unit without mutation spot-checks unless the brief says the owner asked (§3-10 RS2-RS4). (adapted from references\u002Fopenrig\u002Fdocs\u002Freference\u002Fproduct-journey-sdlc.md:177-178 (Apache-2.0))\n- A design-writing agent's file also tells it to give every refusal, prompt or required step its design adds a cost statement (the scenario, who causes it, what it costs everyone else, or one line saying the design adds none), and a judge agent's file carries the fixed `cost statement` row: UPHELD only when each addition the judge finds has all three, REJECTED with a cause tag when one is missing or generic, N\u002FA when none (`references\u002Fquality-gates.md` section 3-11). The row adds no round, gate or level. (adapted from references\u002Fopenrig\u002FCONTRIBUTING.md:29-31 (Apache-2.0))\n- An agent that makes an outside effect (a send, a record write, a publication or a payment; `references\u002Fstate-ledger.md` section 3a) says in its file, on a line of its own that starts `Sending worker:` (the marker `lint_harness.py` reads), that it makes only the calls on the approved list its brief names, each once and with exactly the listed arguments, that it never asks the user for approval or decides it, and that with no list, or before a call that is not on it, it makes no call and reports `STATUS: blocked` (Ask-first block, `references\u002Forchestrator-template.md`).\n- Library skills: before writing an agent's own skill (Step 4), look for an existing skill that already does its job and assign it. The library is every skill the host lists (the available-skills list; `ListSkills` or `SearchSkills` where the session has them) plus `.claude\u002Fskills\u002F`. For each agent: match its role and task against the skill descriptions, take the narrowest domain match, assign at most three, and wire each in the agent's body (\"call `\u002Fskill-name` with the Skill tool\"). Add `Skill` to its `tools:` allowlist if it has one, because an allowlist that omits it hides every skill. Use only a name the listing shows, never one from memory. Never give a skill that sends, writes a record, publishes or pays to a worker that is not the sending worker. Record the result as a table, agent | assigned skill | why, in the Step 5 report; an agent with no good match is marked `none found` and Step 4 writes its skill. A chosen library skill is reused, not copied. Where no skill listing is readable, say so in the report and write the skills instead of guessing.\n- Model per agent from `references\u002Fmodel-selection-guide.md`: fable only for the layer that plans and runs long; opus for design, generation, judging; sonnet by default.\n\n### Step 4: Write the skills\n\nEach agent's method goes in `project\u002F.claude\u002Fskills\u002F{name}\u002FSKILL.md` (`references\u002Fskill-writing-guide.md`).\n\n1. Check `.claude\u002Fskills\u002F` for an existing skill that covers it; link or extend rather than duplicate (§9).\n2. Layout: `SKILL.md` (required, under 500 lines) + optional `scripts\u002F`, `references\u002F`, `assets\u002F`.\n3. `description` states what the skill does and the concrete situations that must trigger it. Follow-up phrasings (\"re-run\", \"update\", \"redo only the X part\") are required on the orchestrator and on any skill users will invoke directly; a leaf skill only ever called by an agent needs none. Name near-miss cases it must not take.\n4. Body: explain the reason behind each rule, generalise to principles, imperative register, move detail to `references\u002F` and say when to read each file.\n5. Wire skills to agents: Skill-tool call for shared workflows, inline for short agent-private procedures, `Read` of a reference file for long conditional material.\n6. A skill that holds rules which change (lender policy, tax rates and thresholds, regulator guidance) opts in to provenance: set `last_verified`, `verified_source` and `review_days` in its frontmatter (`references\u002Fskill-writing-guide.md` section 10); lender-policy and rate claims rest on tier T1 sources. A skill about method alone leaves them out. Top-level provenance keys are expected to be ignored by Claude Code and plugin loaders, not checked here; which frontmatter keys a chat or Cowork upload accepts is UNVERIFIED, so test an upload before relying on it. (adapted from references\u002Fopenrig\u002Fpackages\u002Fdaemon\u002Fsrc\u002Fdomain\u002Fskill-audit.ts:98-111 (Apache-2.0))\n\n### Step 5: Integrate and order the run\n\nThe orchestrator is itself a skill. Use the matching template in `references\u002Forchestrator-template.md` (A, B, C or mixed) and the scripts in `references\u002Fworkflow-recipes.md`. When extending, edit the existing orchestrator; never create a second one for the same domain.\n\nEvery orchestrator contains:\n\n- **Execution mode and target surface** at the top (per phase if mixed). If chat or Cowork is a target, a `## Single-context fallback` section (`references\u002Fsurfaces.md`).\n- **Step 0 context check**: no `_workspace\u002F` → fresh run; `_workspace\u002F` + partial request → re-run only that agent\u002Fphase (pass prior output paths); `_workspace\u002F` + new input → move it to `_workspace_{timestamp}\u002F` and start fresh; Workflow mode → `resumeFromRunId` when `run_meta.json` has one, except for a `once` stage that did not return a result (`references\u002Fstate-ledger.md` section 3a, rule O7). A run of two or more phases that pass files to each other also keeps a state ledger, so a request to continue after a context reset or in a new session starts at the first unfinished phase, not the first one; a named partial re-run still wins, and the script is copied into the harness when the plugin is not installed there (`references\u002Fstate-ledger.md`, script `scripts\u002Fstate_ledger.py`). A phase that sends, publishes, uploads or writes a record outside the workspace is marked `once` in the optional `replay` column of that table, so a resume stops and asks about a half-done one instead of running it again (`references\u002Fstate-ledger.md` section 3a). (adapted from references\u002Fopenharness\u002Fsrc\u002Fopenharness\u002Fautopilot\u002Fservice.py:405 (MIT); adapted from references\u002Fmeta_harness\u002F.agents\u002Fskills\u002Fharness\u002FSKILL.md:158 (Apache-2.0); adapted from references\u002Fopenrig\u002Fdocs\u002Freference\u002Frig-spec.md:519 (Apache-2.0))\n- **Connector preflight** (only when an agent has `## Required connectors`): Step 0 ends with the preflight item from Template A Step 0 in `references\u002Forchestrator-template.md`, holding one agent → connector row per declared line. On Claude Code a missing connector stops the run before any spawn; on chat and Cowork the orchestrator warns and asks instead, because connector listings there are deferred and an absent name is not proof (`references\u002Fsurfaces.md` §4).\n- **Data hand-off**: structured return (`schema`) in A; return message in C; `SendMessage` and shared tasks in B; files for anything large or auditable, as `_workspace\u002F{phase}_{agent}_{artifact}.{ext}`. Freeze artefacts at phase boundaries in B (template B Step 4).\n- **Delegation contract** (only when the orchestrator spawns or messages a worker, so never in a single-context fallback): paste the Delegation block from `references\u002Forchestrator-template.md` at the step that launches workers and fill one five-line brief per worker role. The block fixes what a brief must contain, the STATUS \u002F EVIDENCE \u002F BLOCKER report a worker ends with, and the check the orchestrator runs before it uses a report (re-ask once, then mark the result unverified; a `once` phase is never re-asked). It is prompt quality plus a check, not a guarantee.\n- **Delegation gate** (every orchestrator): a `## Delegation gate` section with the six answers and the outcome from Step 2-0, written before anything is spawned; a single-agent outcome spawns nothing. Template C in `references\u002Forchestrator-template.md` carries the block and an optional notes block for workers; an A or B orchestrator copies the same block.\n- **Rigor** (every orchestrator that has a `Quality gates` bullet below): a `## Rigor` section with the table of `references\u002Fquality-gates.md` section 3-10 and the block in `references\u002Forchestrator-template.md`. Ask the owner, per kind of unit, whether it is an audited decision (money, eligibility, compliance and client-facing text) or `other`, and write the answer: an agent never classifies a unit as `other` on its own. Audited decisions are `gated`, preselected; `other` units are `light` unless the owner assigns them `standard` or `gated` (software is `other`; offer `standard` for a normal expert build and write it only on the owner's answer). When it is unclear whether an output is an audited decision, treat it as one. A classification or a downgrade that lowers rigor needs the user's approval; an agent never decides it. Ask once who the owner is and write that name as the `OWNERS` line of the copied `waiver_ledger.py`, and copy `rigor_check.py` with it because it imports `waiver_ledger.py`. A role name, an idle seat and an earlier finding assign no gate. Show the table in the report of Step 6 item 7. A downgrade of one item, or a later lowering of a row, is a `WAIVERS.md` row with the owner's words and never a table edit alone; a harness that never downgrades passes `-` for the ledger. (adapted from references\u002Fopenrig\u002Fpackages\u002Fdaemon\u002Fspecs\u002Fagents\u002Fshared\u002Fskills\u002Fpods\u002Forchestration-team\u002FSKILL.md:17-19 and :149-152 (Apache-2.0))\n- **Error policy**: one retry then proceed and record the gap, except that a `once` phase is never retried automatically: it stops and asks (`references\u002Fstate-ledger.md` section 3a, rule O7); a verdict whose `candidate_id.py check` exits 3 gets its own row in the error table (treated as not given, the judging phase re-run on the current tree when the user agrees); never retry quota, auth or permission failures — open the partial artefacts, record what is missing, report; the orchestrator fills a gap only with facts it verified itself, never with a guessed judgement; in Mode A, `.filter(Boolean)` after every `parallel()`\u002F`pipeline()` and `log()` the dropped count.\n- **Ask before an outside effect** (every orchestrator of a harness that can send, write a record, publish or pay, a single agent included): paste the Ask-first block of `references\u002Forchestrator-template.md` before the first phase that does it, and into any `## Single-context fallback`. Before each phase that makes an outside call, the orchestrator shows that phase's calls with their exact arguments and stops; it makes them only after the user's explicit yes to that list, each once, and treats no answer, a no, a change and a run with nobody to answer as not sent. One list and one yes per sending phase; a list that names calls of two phases approves neither. Within a phase the batch is shown in full and approved once. A host permission prompt and a passed audit are not the yes. (adapted from references\u002Fpaperclip\u002Fskills\u002Fpaperclip\u002FSKILL.md:474-479 (MIT, Paperclip AI), idea only; adapted from references\u002Fopenrig\u002Fdocs\u002Freference\u002Fgetting-started.md:663-667 (Apache-2.0)) The skill that carries the block also sets `disable-model-invocation: true` in its frontmatter, so a model never starts it unasked; `lint_harness.py` warns `send-implicit` when the key is missing (adapted from references\u002Frepository_harness\u002Ftests\u002Finstaller\u002Fassert-agent-authority-contract.sh:90 (MIT), holder Hoang Nguyen per references\u002Frepository_harness\u002FLICENSE:1-3, idea only). On chat and Cowork the key may be ignored: unverified.\n- **Run mode** (every orchestrator): paste the Run mode block of `references\u002Forchestrator-template.md` after the Delegation gate and mark the phases that only add checking `[full-only]`, so the user can say \"run it light\", \"standard\" or \"full\" and the orchestrator skips them and starts its workers on cheap models. Light is a cost switch; standard and full raise one run; none of them lowers a unit the Rigor table runs `gated`. The cost fields it uses are `model` on the `Agent` call, which beats the agent file's `model:`, and `maxTurns` and `effort` in agent frontmatter (checked against the Claude Code docs, 2026-11-05).\n- **Scale**: 2-3 persistent agents for small jobs, 3-5 for medium, supervisor + 3-5 for large; Workflow calls from a handful to hundreds, capped by `budget.remaining()` when a budget is set.\n- **Quality gates** when the harness builds software or produces audited decisions — money, eligibility, compliance and client-facing text: credit or compliance assessments, client-facing advice and emails, legal or financial figures. A gap email is client-facing text and so is one; so is a servicing verdict. Which units run the chain below is the Rigor bullet's decision. Then: Authority List → fresh-context judge (max 3 rounds, one in a `standard` unit, then escalate with both positions) whose verdict also rules the fixed `cost statement` row (§3-11) → build one slice → boundary QA with `RESULT: PASS|FAIL` first line, the repo's real gates re-run, mutation spot-checks on a scratch copy, one builder retry → final report whose first line is Done \u002F partly done \u002F blocked (`references\u002Fquality-gates.md`). Each QA report and judge verdict names the candidate it judged, and the orchestrator checks that line before it commits or ships (`scripts\u002Fcandidate_id.py`, §3-7; `unverified` where no shell runs).\n- **`CLAUDE.md` pointer**: record only the block below, between its two marker lines, with the change history after the end marker. Agent lists, directory trees and run rules stay out of it.\n\n````markdown\n\u003C!-- finhub-harness:begin {orchestrator-skill-name} -->\n## Harness: {domain}\n\n**Goal:** {one line}\n\n**Trigger:** For {domain} work, use the `{orchestrator-skill-name}` skill. Simple questions may be answered directly.\n\u003C!-- finhub-harness:end {orchestrator-skill-name} -->\n\n**Change history:**\n| Date | Change | Target | Reason |\n| --- | --- | --- | --- |\n| {YYYY-MM-DD} | Initial build with finhub-harness | all | - |\n````\n\nOn an initial build the Reason column stays `-`; later rows carry the feedback or defect that caused the change.\n\nThe block belongs to this skill; everything else in `CLAUDE.md` belongs to the user. Each marker stands alone on its line, and the name in it is the orchestrator skill's kebab-case name, never translated, so several harnesses can share one file. Before writing anything, list the marker lines from the file itself, with `grep -n 'finhub-harness:' CLAUDE.md` or the Read tool, never from the copy of `CLAUDE.md` loaded at session start, which may not show HTML comment lines. Count only a line that holds nothing but a marker; a byte-order mark at the very start of the file does not count as text. Then take the first case that fits this orchestrator's name:\n\n1. No `CLAUDE.md`: create it with the block and the history table.\n2. No marker line for this name: back up, then add a blank line, the block and the history table at the end of the file. If an unmarked `## Harness: {domain}` section from an earlier build is already there, add no block: edit that section in place as before, put the history row in its table, and say in the report that the pointer has no markers, and that wrapping its heading, Goal and Trigger lines in the two markers, with the history kept below the end marker, lets a later run replace it in place.\n3. One begin line above one end line, with no other harness's marker between them: start the new block from the lines now between the markers and change only what this run changes, so an edit made there since the last build (by `finhub-harness-evolve` or by hand) is kept. If the result matches those lines, write nothing. Otherwise back up, replace only those lines, and put the history row in the table below the block. Every byte above the begin line and below the end line stays as it was.\n4. Anything else (a second begin or end line, an end line above its begin line, a marker without its partner, another harness's marker inside the block, or a `CLAUDE.md` you cannot read): write nothing to `CLAUDE.md`. Show the user the marker lines with their line numbers and ask them to fix the file by hand. Never guess which pair is meant.\n\nA renamed orchestrator: when the file holds a valid pair whose name matches no orchestrator skill of this harness, that block may be the old one of a harness that was renamed. Leave it exactly as it is, name it in the report together with the new block, and ask the user whether to remove it; never delete or rewrite a block under another name unasked. The lint does not flag it. (adapted from references\u002Fopenrig\u002Fpackages\u002Fdaemon\u002Fsrc\u002Fdomain\u002Fmanaged-blocks.ts:8 and :36 (Apache-2.0), idea only)\n\nBack up before the first write, as the backup gate of `finhub-harness-evolve` Phase 3 does: `cp -p CLAUDE.md CLAUDE.md.bak && cmp CLAUDE.md CLAUDE.md.bak`, using the first unused `CLAUDE.md.bak.2`, `CLAUDE.md.bak.3` and so on when `CLAUDE.md.bak` exists, and writing nothing if the copy fails or `cmp` prints anything. Keep the block, both marker lines included, to 1600 bytes or fewer: it is read at the start of every session, and the lint warns (`pointer-budget`) when it is longer. The change history below the block is never counted, never trimmed and never moved into it. On chat and Cowork, whether `CLAUDE.md` can be read or edited in place and whether the lint can run are unverified: give the user the block and the history row to paste, and check the four cases by hand. (adapted from references\u002Frepository_harness\u002Fscripts\u002Finstall-harness.sh:330-344 and :369 (MIT, Hoang Nguyen); size budget adapted from references\u002Frepository_harness\u002Ftests\u002Finstaller\u002Fassert-agent-authority-contract.sh:35 (MIT, Hoang Nguyen))\n\n- **Follow-up triggers** in the orchestrator `description`: \"re-run\", \"update\", \"fix\", \"redo only {part}\", \"improve the previous result\", plus the domain's everyday verbs.\n\n### Step 6: Verify and test\n\nFollow `references\u002Fskill-testing-guide.md`.\n\n1. **Files and references**: run `python3 scripts\u002Flint_harness.py project\u002F.claude` (path relative to this skill's directory) and fix every `ERROR` line; fix each `WARN` line or say in the report why it stays. The lint checks frontmatter, name grammar and that a skill's directory matches its name, non-empty descriptions, that every `subagent_type`\u002F`agentType` names an agent file or a built-in type, that `## Required connectors` lines and the preflight table agree, that no agent or skill file which calls `Agent(`, `agent(`, `Task(` or `SendMessage`, or names `subagent_type` or `agentType`, contains a lazy-delegation phrase (WARN `lazy-delegation`), and v1 artefacts, and that local markdown links, a skill's single-level `references\u002F\u003Cfile>.\u003Cext>` mentions and agent and skill names (`broken-link`, `bundled-ref`, `duplicate-name`) are not dead or duplicated, and that a skill which sets any of `last_verified`, `verified_source` or `review_days` has a real calendar date that is not in the future, a source that is not the skill itself and holds a URL or a year, and a window the date has not outrun (WARN only, each with a fix: `verified-date`, `verified-future`, `verified-bare`, `verified-window`, `verified-stale`, `verified-orphan`; a skill that sets none of the three is not checked), and that the `CLAUDE.md` beside DIR (in DIR's parent when DIR is `.claude`) has, per orchestrator name, one begin marker line above one end marker line with no other harness's marker between them (`pointer-marker`, ERROR) and a block of at most 1600 bytes (`pointer-budget`, WARN; a `CLAUDE.md` with no marker line is not checked); for a mention of a file you mean to create later, write it with a path prefix (`\u003Cskill>\u002Freferences\u002Fx.md`), inside a code fence or as an angle-bracket placeholder rather than waiving the ERROR; it exits 1 on any error. Where it cannot run (chat without code execution), check the same list by hand. The lint does not check that nothing was written to `.claude\u002Fcommands\u002F` or that every Authority List citation opens to a line that supports the claim; check those yourself. Where the project pins `references\u002F` submodules, the cite check, run from the project root as `python3 \u003Cthis skill's directory>\u002Fscripts\u002Fcite_check.py \u003Cdesign or port map>`, confirms that each `references\u002F\u003Csub>\u002F\u003Cpath>:\u003Cline>` cite exists at the pinned commit and is in range, not that it supports the claim; a generated judge agent file says to run it before the first claim and names where it is: this skill's `scripts\u002F` when the plugin is installed, or a copy in the harness's own `scripts\u002F` (`references\u002Fquality-gates.md` §1-4). (adapted from references\u002Fcrewai\u002Flib\u002Fcrewai\u002Fsrc\u002Fcrewai\u002Fskills\u002Fvalidation.py:43 (MIT)) (provenance rules adapted from references\u002Fopenrig\u002Fpackages\u002Fdaemon\u002Fsrc\u002Fdomain\u002Fskill-audit.ts:98-136 (Apache-2.0))\n2. **Per mode**: A — `meta` is a pure literal, no `Date.now()`\u002F`Math.random()`, `parallel()` only where a barrier is needed, `.filter(Boolean)` present, `phase()` titles match `meta.phases`; B — message routes, task dependencies, agent count; C — inputs chain to outputs, parallel calls batched in one message; mixed — mode written per phase and hand-offs unbroken. Chat\u002FCowork targets — the single-context fallback covers every phase. Delegation, wherever workers are spawned or messaged — `grep -l 'STATUS:' project\u002F.claude\u002Fskills\u002F*\u002FSKILL.md` lists the orchestrator. Where the lint cannot run, `grep -nEi 'based on (your|the) (findings|research)|as (we )?discussed' project\u002F.claude\u002Fskills\u002F*\u002FSKILL.md project\u002F.claude\u002Fagents\u002F*.md` is a stricter manual fallback (no word boundaries, every file, blind to a phrase wrapped over two lines): judge each hit by hand, because a research-and-write skill may legitimately keep one.\n3. **Skill runs**: 2-3 realistic prompts per skill, with-skill vs baseline in parallel, qualitative plus assertion-based grading; fix by principle, not per example; repeat until gains flatten; move repeated helper code into `scripts\u002F`.\n4. **Trigger check**: 10 should-trigger prompts in varied register and 10 near-miss should-not-trigger prompts; check for collisions with existing skills' descriptions.\n5. **Dry run**: phase order, hand-off paths, input\u002Foutput fit, error branches executable.\n6. **Record** one happy-path and at least one error-path scenario under `## Test scenarios` in the orchestrator. A harness with the Ask-first block also records its three cases (no answer, a no, a yes), run against a stub connector that records its calls.\n7. **Rigor table**: put the harness's `## Rigor` table in the report you give the owner, with the class and the level of each scope and who assigned it. It is the owner's answer from build time and nothing compares it with anything (`references\u002Fquality-gates.md` section 3-10).\n\n### Step 7: Operate, maintain and improve\n\nA harness is not a one-off artefact. Retrospectives and feedback belong to `finhub-harness-evolve` (\"harness retrospective\", \"evolve the harness\", \"fold this feedback in\"). This skill handles operation:\n\n1. **Status check**: diff `.claude\u002Fagents\u002F`, `.claude\u002Fskills\u002F` and the orchestrator; list mismatches and report.\n2. **Incremental change**: one item at a time, verify immediately.\n3. **Change history**: date, change, target, reason in `CLAUDE.md`.\n4. **Verify the change**: structure always; trigger test if a description changed; run test and dry run if the change is large; final `CLAUDE.md`-vs-files check.\n5. **Audit**: when the user asks whether a harness's rules have real checks, follow `references\u002Faudit-guide.md`: one row per rule or check, one finding each (enforced, partially enforced, unenforced rule, check lacking authority, unknown), evidence classes never promoted, and the audit reads and reports without editing.\n\nSuggest `finhub-harness-evolve` when the same feedback recurs, an agent fails twice for the same cause, a QA report or judge verdict rejects for the same reason twice, or the user keeps doing the orchestrator's job by hand.\n\n### Enriching from other harness repos\n\nWhen the user wants a pattern from another harness (`\"borrow the judge panel from repo Y\"`, `\"adopt how Z sandboxes code\"`), do not copy. Pin the repo as a reference submodule, run the port-map procedure, then adopt the pattern through an Authority List row with its licence tier. `references\u002Fsource-enrichment.md` has the procedure, the pinned repos and their tiers.\n\n## Deliverable checklist\n\n- [ ] Every reusable custom type has a file in `project\u002F.claude\u002Fagents\u002F`; one-offs on built-in types have none.\n- [ ] Every needed `SKILL.md` and reference exists under `project\u002F.claude\u002Fskills\u002F`.\n- [ ] Every agent has an assigned library skill or a `none found` row in the agent | skill | why table; every assigned name appears in the host's skill listing and in the agent's body, and no sending skill sits on a non-sending worker.\n- [ ] One orchestrator skill with data hand-off, error policy, test scenarios and a declared target surface; a single-context fallback if chat or Cowork is a target.\n- [ ] Execution mode written (per phase if mixed); no v1 artefacts.\n- [ ] `scripts\u002Flint_harness.py` exits 0 on `project\u002F.claude`, and every `WARN` line is fixed or explained.\n- [ ] `model:` chosen per agent from the task, with the reason as a comment; no blanket top-model setting.\n- [ ] Workflow scripts: `.filter(Boolean)` present, `meta` literal, `parallel()` only for real barriers.\n- [ ] Nothing written to `.claude\u002Fcommands\u002F`.\n- [ ] Existing agents and skills checked for overlap before creating new ones; no name or role collision.\n- [ ] Artefacts written in the user's language (or the existing harness's language).\n- [ ] Every skill `description` names its trigger situations and follow-up phrasings.\n- [ ] Every `SKILL.md` under 500 lines; detail moved to `references\u002F`.\n- [ ] Run with 2-3 realistic prompts; triggers validated with should and should-not cases.\n- [ ] `CLAUDE.md` holds only the trigger pointer, inside its one pair of finhub-harness marker lines (1600 bytes or fewer), and the change history below it; the user's own text outside the block is unchanged.\n- [ ] Orchestrator Step 0 distinguishes first run, follow-up and partial re-run (and `resumeFromRunId` for Workflow mode).\n- [ ] Every `## Required connectors` line in an agent file has a row in the orchestrator's connector preflight table, and every row has a matching agent line.\n- [ ] Every worker brief has Goal, Inputs, Scope, Expected output and Report; every worker report ends in STATUS \u002F EVIDENCE \u002F BLOCKER form; the orchestrator re-asks once and then marks the result unverified (a `once` phase is never re-asked).\n- [ ] A harness that can send, write a record, publish or pay has the Ask-first block before its first such phase and in its single-context fallback, and its test scenarios hold the no-answer, no and yes cases.\n- [ ] Every section that launches writers in parallel has a `## Writers` table with one ownership label per writer (`references\u002Fwrite-safety.md`); `python3 scripts\u002Fcheck_writers.py --require` on that orchestrator exits 0 (path relative to this skill's directory); a harness with one writer needs no table and is not run with `--require`.\n- [ ] Borrowed patterns cited in an Authority List with licence tier; net-new decisions labelled with reason and test.\n- [ ] If the harness builds software: QA runs the repo's real gates after every slice and reports `RESULT:` first, then `CANDIDATE:`; the orchestrator runs `candidate_id.py check` on that report before it commits. Each mutant it ran ends in `STATE: CAUGHT` or is redone.\n\n## References\n\n- Execution modes and v1→v2 migration: `references\u002Fexecution-modes.md`\n- Surfaces (Code \u002F chat \u002F Cowork) and the single-context fallback: `references\u002Fsurfaces.md`\n- Model selection: `references\u002Fmodel-selection-guide.md`\n- Team patterns and agent definitions: `references\u002Fteam-patterns.md`\n- Worked team examples: `references\u002Fteam-examples.md`\n- Workflow scripts and pitfalls: `references\u002Fworkflow-recipes.md`\n- Orchestrator templates: `references\u002Forchestrator-template.md`\n- State ledger, rebuild and resume across context resets: `references\u002Fstate-ledger.md`\n- Run-once phases: a resume stops and asks about a half-done send, publish or record write (the ledger reads files only; an idempotency key accepted by the connector is the real fix): `references\u002Fstate-ledger.md` section 3a\n- Asking before an outside effect (the exact calls shown, an explicit yes, each call once, no answer is no): `references\u002Forchestrator-template.md`, Ask-first block\n- Bulk job with one phase repeated over N items: a per-row tracker so a re-run resumes at the item, not the phase (`scripts\u002Funit_tracker.py`, rules U1-U8): `references\u002Funit-tracker.md`\n- The same work over many items, pilot first, then fan out (rules P1-P6): `references\u002Fteam-patterns.md` section 1-2a\n- Skill writing: `references\u002Fskill-writing-guide.md`\n- Skill testing: `references\u002Fskill-testing-guide.md`\n- A harness that tries changes and keeps the winners (the seven-item contract named before the first candidate, a read-only evaluation surface, a ledger, gates before the score, and a four-scenario A\u002FB for team layouts): `references\u002Fexperiment-profile.md`\n- QA agents: `references\u002Fqa-agent-guide.md`\n- Authority List, adversarial audit, mutation-tested QA, honest reporting: `references\u002Fquality-gates.md`\n- A mutant counts as caught only when the test written for it fails at the assertion written for it, between a passing run before and a passing run after: `references\u002Fquality-gates.md` §3-4 (rules M1-M8) and `scripts\u002Fmutant_gate.py` (adapted from references\u002Fopenrig\u002Fpackages\u002Ftest-system\u002Fci\u002Fresult.mjs:33-34 (Apache-2.0))\n- Naming the tree a verdict judged, and refusing a stale verdict: `references\u002Fquality-gates.md` §3-7 and `scripts\u002Fcandidate_id.py` (adapted from references\u002Fopenrig\u002Fscripts\u002Fgate-lane-consume.mjs:23-25 (Apache-2.0))\n- Checking that each `references\u002F\u003Csub>\u002F\u003Cpath>:\u003Cline>` cite exists at the pinned commit and is in range: `references\u002Fquality-gates.md` §1-4 and `scripts\u002Fcite_check.py` (adapted from references\u002Frepository_harness (MIT); the source lines are named in §1-4)\n- Parallel writers, the ownership ladder and honest labels: `references\u002Fwrite-safety.md` (adapted from references\u002Fmeta_harness\u002F.agents\u002Fskills\u002Fharness\u002FSKILL.md:133 (Apache-2.0))\n- Updating installed harness files from a new version without overwriting edits (plan against a stored baseline, stage conflicts, edit nothing; rules R1-R6): `references\u002Fsafe-update.md` and `scripts\u002Fsafe_update.py` (adapted from references\u002Frepository_harness\u002Fcrates\u002Fharness\u002Fsrc\u002Fapplication\u002Fservice.rs:516 (MIT, Hoang Nguyen), idea only)\n- Borrowing from other harness repos under licence rules: `references\u002Fsource-enrichment.md`\n","# FinHub Harness — agent teams, their skills and a surface-aware orchestrator\n\n> Ported from revfactory\u002Fharness v2.1.0 (Apache-2.0), translated to English and extended for FinHub. Original: https:\u002F\u002Fgithub.com\u002Frevfactory\u002Fharness. FinHub additions: surface adaptation (Code \u002F chat \u002F Cowork), the Authority List with a fresh-context adversarial audit, mutation-tested boundary QA, and licence-tiered enrichment from other harness repos.\n\nDesign a harness that fits the project. Define each agent's role, write the skill each agent follows when it works, and write one orchestrator that says who collaborates, in what order, on which surface.\n\n**Light option.** If the user asks for a light, quick, small or cheap build, or the job is one small task, use `finhub-harness-light` instead: it is under a quarter of this file's size. A harness built here can still run light: see the Run mode bullet in Step 5.\n\n## Core principles\n\n1. Agent definitions live in `project\u002F.claude\u002Fagents\u002F`, skills in `project\u002F.claude\u002Fskills\u002F`. An agent definition says **who** works; a skill says **how** the work is done. Keep them apart.\n2. Choose the execution mode from the shape of the work. If the item list, the verification rule and the repeat condition can be written as code, orchestrate with a Workflow. If the same expert must trade feedback across turns, use persistent named agents. If you only need a result once, delegate to a sub-agent. Step 2-1 gives the rule; the full decision tree is `references\u002Fexecution-modes.md` §4.\n3. Choose the model per agent from the task's complexity, duration, autonomy and latency need: fable for long-horizon autonomous planning, opus for bounded deep reasoning (design, code generation, cross-checking), sonnet for routine work. The criteria are in `references\u002Fmodel-selection-guide.md`. Never set every agent to the top model because \"it matters\".\n4. Record only the trigger conditions and a change history in `CLAUDE.md`, so a new session can find the orchestrator. Everything else lives in the orchestrator and the agent\u002Fskill files.\n5. Feed what each run teaches back into the agents, skills and `CLAUDE.md`. The retrospective is `finhub-harness-evolve`'s job.\n6. Write every generated artefact in the language the user writes in. Do not copy this skill's language or the templates' example wording; translate headings and examples. If the user extends an existing harness, follow the language of the existing files.\n7. **Declare the target surface.** Every orchestrator says whether it runs on Claude Code, Claude chat, Claude Cowork or several. Modes A\u002FB\u002FC exist only in Claude Code; chat and Cowork need a single-context fallback. `references\u002Fsurfaces.md` says exactly how each primitive degrades.\n8. **Borrowed patterns carry a citation.** A design decision taken from a reference repo enters the harness through an Authority List row (`claim → references\u002F\u003Crepo>\u002F\u003Cpath>:\u003Cline>`, licence tier noted). A decision with no source is labelled NET-NEW with a reason and a named test, never a fake citation. `references\u002Fquality-gates.md` has the schema; `references\u002Fsource-enrichment.md` says what may be borrowed from where.\n\n## Procedure\n\n### Step 0: Check the current state\n\nRead `project\u002F.claude\u002Fagents\u002F`, `project\u002F.claude\u002Fskills\u002F`, `project\u002FCLAUDE.md` and, if present, `project\u002F.claude-plugin\u002Fplugin.json`. Then pick exactly one path:\n\n- **New build**: no agents or skills, or empty directories → run Steps 1-6 in full.\n- **Extend an existing harness**: add an agent, a skill, or change the structure → run only the steps in the table below.\n- **Operate \u002F maintain**: audit, repair or sync → go to Step 7.\n\n| Change | Step 1 | Step 2 | Step 3 | Step 4 | Step 5 | Step 6 |\n| --- | --- | --- | --- | --- | --- | --- |\n| Add an agent | skip, reuse Step 0 findings | decide only which mode, team and phase it joins | required | only if it needs a dedicated skill | edit the orchestrator | required |\n| Add or change a skill | skip | skip | skip | required | only if wiring changes | required |\n| Change structure or execution mode | skip | required | affected agents only | affected skills only | required | required |\n\nThen:\n\n1. **Detect v1 artefacts.** If an orchestrator or agent mentions `TeamCreate`, `TeamDelete`, `team_name`, `SendMessage({to: \"all\"})` or `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS`, it was built for v1 and will silently degrade to a single agent on the current runtime. Propose the v2 migration in `references\u002Fexecution-modes.md` §5 before anything else.\n2. **Detect the surface mismatch.** If the orchestrator assumes `Agent`\u002F`Workflow` tools but the user wants to run it in Claude chat or Cowork, add the single-context fallback (`references\u002Fsurfaces.md`) before extending it.\n3. Compare the real agent and skill list with the `CLAUDE.md` change history and list every mismatch.\n4. Report the findings and the plan to the user and get confirmation.\n\n### Step 1: Analyse the domain and the work\n\n1. Extract the domain and the goal from the request.\n2. Split the work by kind: generate, verify, edit, analyse.\n3. Characterise the flow so Step 2 can pick a mode:\n   - Can the item list be enumerated up front (N files, M viewpoints)?\n   - Is there a verify-then-fix loop?\n   - Does the result improve when agents argue with each other?\n   - Must the same expert stay in conversation within one session?\n4. Find overlaps or conflicts with the agents and skills found in Step 0.\n5. Skim the codebase: stack, data model, main modules, existing tests and gates (`pytest`, `ruff`, `mypy` or their equivalents) — the orchestrator's QA must run the real gates, not invent new ones.\n6. Match the explanation level to the user. Do not use \"assertion\" or \"JSON Schema\" without a gloss for a non-coder.\n7. **Which surface(s)?** Ask if it is not obvious. A harness for a mortgage-broking operator who works in Cowork with CRM connectors is a different artefact from one for a developer in Claude Code, even for the same domain.\n\n### Step 2: Choose the execution mode and the team pattern\n\n#### 2-0. Delegation gate (first; the default is one agent)\n\nBefore choosing a mode or a pattern, answer six questions in one line each: (1) which units of work are independent, or in what order they hand off, (2) what splitting buys: specialisation, parallel speed or a separate context, (3) which paths or resources each worker writes, (4) whether every worker's tools and permissions cover its task on the target surface, (5) who synthesises and accepts the result, (6) how a partial, blocked or conflicting result is reported. `references\u002Fteam-patterns.md` §6-1 says when an answer counts as unclear.\n\n- If any answer is missing or unclear, the outcome is **single agent**: the main context does the work, there is at most one agent file, and no Mode A or B and no parallel workers are used. Having an `Agent` or `Workflow` tool is not a reason to delegate. For an extension, \"at most one agent file\" counts the new role only: the new role then becomes a step of the main context or of an existing agent, not a new file.\n- Only when all six answers are concrete is the outcome **delegate**; then 2-1 to 2-3 and the Step 5 scale rule size the team. When extending a harness, run the gate again for the new role alone.\n- A dependent chain (pipeline, producer-reviewer, Mode B, a fresh-context judge, design then judge then build then QA) is concrete when each hand-off artefact is named; it delegates in sequence, and independence only decides whether calls run in parallel.\n- Rigor is a separate axis. The six answers never select a level, and a level never overrides them for the producing roles. A unit that the Rigor table runs `gated` adds a judge and a QA agent as an exception to the single-agent cap above (\"at most one agent file\"), which counts the producing roles only; their hand-off artefacts (the verdict, the report) are the named artefacts of question 1. (adapted from references\u002Fopenrig\u002Fpackages\u002Fdaemon\u002Fspecs\u002Fagents\u002Fshared\u002Fskills\u002Fpods\u002Freview-team\u002FSKILL.md:24-25 (Apache-2.0))\n- When the user explicitly asks for a team or names the roles, build what was asked: write each unclear answer under `## Delegation gate` as a stated risk and tell the user. The single-agent default applies when the user has not chosen.\n- A coordinator layer between the root and its workers needs one sentence in the orchestrator that names why the root cannot hold that work; without it, workers report to the root. The two-level cap in 2-2 stays.\n- Write the answers and the outcome in the orchestrator under `## Delegation gate` (Step 5).\n\n(adapted from references\u002Fmeta_harness\u002F.agents\u002Fskills\u002Fharness\u002Freferences\u002Fagent-design-patterns.md:221 (Apache-2.0); adapted from references\u002Fmeta_harness\u002F.agents\u002Fskills\u002Fharness\u002FSKILL.md:166 (Apache-2.0))\n\n#### 2-1. Execution mode (Claude Code)\n\n| Mode | Primitives | Fits |\n| --- | --- | --- |\n| **A. Workflow orchestration** | `Workflow` script: `agent()`, `pipeline()`, `parallel()`, `phase()`, `schema` | item list, verification rule and repeat count expressible as code; schema-validated results; dozens of agent calls |\n| **B. Persistent agent collaboration** | `Agent(name:)`, `SendMessage`, `TaskCreate`\u002F`TaskUpdate` | named experts that keep context across feedback, negotiation and joint editing |\n| **C. Sub-agent delegation** | one `Agent` call per task, background by default; independent calls parallel in one message, dependent calls one after another with the prior artefact path in the prompt | no agent-to-agent talk needed; a result once |\n\nDecide in this order: (1) if the list, rule and loop can be coded, use A — code-defined control flow is reproducible; (2) else if agents must converse or remember, use B; (3) else C — a short pipeline of one-shot agents is still Mode C, run sequentially; (4) mix modes per phase and write `**Execution mode:**` above each phase. Write only the mode(s) you chose; an orchestrator is not required to carry all three.\n\n`Workflow` needs the user's explicit opt-in. Invoking an orchestrator skill that declares a Workflow counts as opt-in. Keep the default agent count small; scale up only on \"thorough\", \"exhaustive\" or a stated token budget (`+500k`).\n\n> Details, concurrency caps, schemas, budgets and resume: `references\u002Fexecution-modes.md`. Chat and Cowork fallbacks: `references\u002Fsurfaces.md`.\n\n#### 2-2. Team pattern\n\nSplit the work by expertise, then pick from `references\u002Fteam-patterns.md`: **pipeline**, **fan-out\u002Ffan-in**, **expert pool**, **producer-reviewer**, **supervisor**, **hierarchical delegation** (two levels at most; one level of Workflow nesting).\n\nWhen correctness matters, add verification patterns: **adversarial verification** (N adversarial checkers per finding; only majority-`confirmed` passes; `refuted`\u002F`uncertain` never count as passes), **judge panel**, **loop-until-dry**, **multi-axis search**, **omission reviewer**. For harnesses that *design before they build*, add the FinHub pattern: an **Authority List** audited by a **fresh-context judge** (`references\u002Fquality-gates.md` §1-2), which is adversarial verification applied to the design itself.\n\n#### 2-3. Splitting agents\n\nSplit on expertise, parallelism, context load and reuse (`references\u002Fteam-patterns.md` §6). Before creating any agent, check `.claude\u002Fagents\u002F` for one that already covers the role and extend it instead (§7).\n\n### Step 3: Write the agent definitions\n\nReusable experts are custom types in `project\u002F.claude\u002Fagents\u002F{name}.md`, invoked with `subagent_type: \"{name}\"` (Agent) or `agentType: \"{name}\"` (Workflow). One-off tasks that fit `general-purpose`, `Explore` or `Plan` get no file.\n\n- Frontmatter: `name` and `description` required; `tools` to restrict (drop Edit and Write for read-only reviewers; give Edit *and* Write to anything that fixes artefacts); `model` with the reason as a comment.\n- Body: role, working principles with their reasons, input\u002Foutput rules, error handling, collaboration. Persistent agents (Mode B) add `## Communication rules`; Workflow-only agents (Mode A) add `## Structured output`; one-shot agents (Mode C) need neither — their `## Input and output rules` name the artefact paths they read and write. Skills are wired in the body (\"call `\u002Fskill-name` with the Skill tool\"); there is no `skills:` frontmatter field.\n- Connectors: an agent that cannot do its job without an MCP server or connector gets a `## Required connectors` section in its body, one server per line, written as the segment between `mcp__` and the next `__` in its tool names (`mcp__crm__search` → `crm`). Leave the section out when the agent needs none. In a harness that can send, write a record, publish or pay, only the sending worker lists the send, write or publish tools (`mcp__\u003Cserver>__*`) in its `tools:` allowlist; every other worker gets a `tools:` allowlist without any `mcp__` tool, because a worker with no `tools:` line inherits connector tools too and the Ask-first yes stops only the orchestrator (`lint_harness.py` warns `connector-tools-unscoped`). Step 5 copies these lines into the orchestrator's preflight table, so a missing connector stops the run before anyone is spawned instead of failing on the agent's first call. (adapted from references\u002Fopenharness\u002Fsrc\u002Fopenharness\u002Fcoordinator\u002Fagent_definitions.py:956 (MIT))\n- QA agents get a type with all tools except `mcp__` connector tools unless the agent is the sender (`Explore` cannot run scripts), compare shapes across boundaries rather than check existence, and run after every module, not once at the end (`references\u002Fqa-agent-guide.md`). Add the mutation spot-check from `references\u002Fquality-gates.md` §3 whenever the QA agent judges tests, count a mutant as killed only when `scripts\u002Fmutant_gate.py` prints `STATE: CAUGHT` for it (§3-4), and have it write a `CANDIDATE:` line under `RESULT:` so the verdict names the tree it judged (§3-7). Its definition file also says four things, because a QA agent follows only what its own file says: write `cause: context-gap` or `cause: judgment-gap` at the end of every defect row, under a heading written exactly `## Defects` (rows are `- defect: file:line ...` or `1. file:line ...`, observations are `- observation:` bullets, and no other line starts with the word Defect or Defects); copy the brief's Base line into a `BASE:` line; write one `drift:` row in its Gate table; and run `scripts\u002Ffinding_tags.py check` on its report last (§3-8, `qa-agent-guide.md` §6 and §7-10; adapted from references\u002Fopenrig\u002Fdocs\u002Freference\u002Fwave-sdlc.md:54-62 (Apache-2.0)).\n- A QA or judge agent file also says to copy the `Rigor:` line of its brief into a `RIGOR:` line (line 5 of a QA report after `BASE:`, line 4 of a verdict after `CARRIED:`), to choose and change no level or class, and to add no check because an earlier one found something (`references\u002Fquality-gates.md` section 3-10). The check that reads those lines is `scripts\u002Frigor_check.py`. In a `standard` unit the judge runs one round and QA runs once per unit without mutation spot-checks unless the brief says the owner asked (§3-10 RS2-RS4). (adapted from references\u002Fopenrig\u002Fdocs\u002Freference\u002Fproduct-journey-sdlc.md:177-178 (Apache-2.0))\n- A design-writing agent's file also tells it to give every refusal, prompt or required step its design adds a cost statement (the scenario, who causes it, what it costs everyone else, or one line saying the design adds none), and a judge agent's file carries the fixed `cost statement` row: UPHELD only when each addition the judge finds has all three, REJECTED with a cause tag when one is missing or generic, N\u002FA when none (`references\u002Fquality-gates.md` section 3-11). The row adds no round, gate or level. (adapted from references\u002Fopenrig\u002FCONTRIBUTING.md:29-31 (Apache-2.0))\n- An agent that makes an outside effect (a send, a record write, a publication or a payment; `references\u002Fstate-ledger.md` section 3a) says in its file, on a line of its own that starts `Sending worker:` (the marker `lint_harness.py` reads), that it makes only the calls on the approved list its brief names, each once and with exactly the listed arguments, that it never asks the user for approval or decides it, and that with no list, or before a call that is not on it, it makes no call and reports `STATUS: blocked` (Ask-first block, `references\u002Forchestrator-template.md`).\n- Library skills: before writing an agent's own skill (Step 4), look for an existing skill that already does its job and assign it. The library is every skill the host lists (the available-skills list; `ListSkills` or `SearchSkills` where the session has them) plus `.claude\u002Fskills\u002F`. For each agent: match its role and task against the skill descriptions, take the narrowest domain match, assign at most three, and wire each in the agent's body (\"call `\u002Fskill-name` with the Skill tool\"). Add `Skill` to its `tools:` allowlist if it has one, because an allowlist that omits it hides every skill. Use only a name the listing shows, never one from memory. Never give a skill that sends, writes a record, publishes or pays to a worker that is not the sending worker. Record the result as a table, agent | assigned skill | why, in the Step 5 report; an agent with no good match is marked `none found` and Step 4 writes its skill. A chosen library skill is reused, not copied. Where no skill listing is readable, say so in the report and write the skills instead of guessing.\n- Model per agent from `references\u002Fmodel-selection-guide.md`: fable only for the layer that plans and runs long; opus for design, generation, judging; sonnet by default.\n\n### Step 4: Write the skills\n\nEach agent's method goes in `project\u002F.claude\u002Fskills\u002F{name}\u002FSKILL.md` (`references\u002Fskill-writing-guide.md`).\n\n1. Check `.claude\u002Fskills\u002F` for an existing skill that covers it; link or extend rather than duplicate (§9).\n2. Layout: `SKILL.md` (required, under 500 lines) + optional `scripts\u002F`, `references\u002F`, `assets\u002F`.\n3. `description` states what the skill does and the concrete situations that must trigger it. Follow-up phrasings (\"re-run\", \"update\", \"redo only the X part\") are required on the orchestrator and on any skill users will invoke directly; a leaf skill only ever called by an agent needs none. Name near-miss cases it must not take.\n4. Body: explain the reason behind each rule, generalise to principles, imperative register, move detail to `references\u002F` and say when to read each file.\n5. Wire skills to agents: Skill-tool call for shared workflows, inline for short agent-private procedures, `Read` of a reference file for long conditional material.\n6. A skill that holds rules which change (lender policy, tax rates and thresholds, regulator guidance) opts in to provenance: set `last_verified`, `verified_source` and `review_days` in its frontmatter (`references\u002Fskill-writing-guide.md` section 10); lender-policy and rate claims rest on tier T1 sources. A skill about method alone leaves them out. Top-level provenance keys are expected to be ignored by Claude Code and plugin loaders, not checked here; which frontmatter keys a chat or Cowork upload accepts is UNVERIFIED, so test an upload before relying on it. (adapted from references\u002Fopenrig\u002Fpackages\u002Fdaemon\u002Fsrc\u002Fdomain\u002Fskill-audit.ts:98-111 (Apache-2.0))\n\n### Step 5: Integrate and order the run\n\nThe orchestrator is itself a skill. Use the matching template in `references\u002Forchestrator-template.md` (A, B, C or mixed) and the scripts in `references\u002Fworkflow-recipes.md`. When extending, edit the existing orchestrator; never create a second one for the same domain.\n\nEvery orchestrator contains:\n\n- **Execution mode and target surface** at the top (per phase if mixed). If chat or Cowork is a target, a `## Single-context fallback` section (`references\u002Fsurfaces.md`).\n- **Step 0 context check**: no `_workspace\u002F` → fresh run; `_workspace\u002F` + partial request → re-run only that agent\u002Fphase (pass prior output paths); `_workspace\u002F` + new input → move it to `_workspace_{timestamp}\u002F` and start fresh; Workflow mode → `resumeFromRunId` when `run_meta.json` has one, except for a `once` stage that did not return a result (`references\u002Fstate-ledger.md` section 3a, rule O7). A run of two or more phases that pass files to each other also keeps a state ledger, so a request to continue after a context reset or in a new session starts at the first unfinished phase, not the first one; a named partial re-run still wins, and the script is copied into the harness when the plugin is not installed there (`references\u002Fstate-ledger.md`, script `scripts\u002Fstate_ledger.py`). A phase that sends, publishes, uploads or writes a record outside the workspace is marked `once` in the optional `replay` column of that table, so a resume stops and asks about a half-done one instead of running it again (`references\u002Fstate-ledger.md` section 3a). (adapted from references\u002Fopenharness\u002Fsrc\u002Fopenharness\u002Fautopilot\u002Fservice.py:405 (MIT); adapted from references\u002Fmeta_harness\u002F.agents\u002Fskills\u002Fharness\u002FSKILL.md:158 (Apache-2.0); adapted from references\u002Fopenrig\u002Fdocs\u002Freference\u002Frig-spec.md:519 (Apache-2.0))\n- **Connector preflight** (only when an agent has `## Required connectors`): Step 0 ends with the preflight item from Template A Step 0 in `references\u002Forchestrator-template.md`, holding one agent → connector row per declared line. On Claude Code a missing connector stops the run before any spawn; on chat and Cowork the orchestrator warns and asks instead, because connector listings there are deferred and an absent name is not proof (`references\u002Fsurfaces.md` §4).\n- **Data hand-off**: structured return (`schema`) in A; return message in C; `SendMessage` and shared tasks in B; files for anything large or auditable, as `_workspace\u002F{phase}_{agent}_{artifact}.{ext}`. Freeze artefacts at phase boundaries in B (template B Step 4).\n- **Delegation contract** (only when the orchestrator spawns or messages a worker, so never in a single-context fallback): paste the Delegation block from `references\u002Forchestrator-template.md` at the step that launches workers and fill one five-line brief per worker role. The block fixes what a brief must contain, the STATUS \u002F EVIDENCE \u002F BLOCKER report a worker ends with, and the check the orchestrator runs before it uses a report (re-ask once, then mark the result unverified; a `once` phase is never re-asked). It is prompt quality plus a check, not a guarantee.\n- **Delegation gate** (every orchestrator): a `## Delegation gate` section with the six answers and the outcome from Step 2-0, written before anything is spawned; a single-agent outcome spawns nothing. Template C in `references\u002Forchestrator-template.md` carries the block and an optional notes block for workers; an A or B orchestrator copies the same block.\n- **Rigor** (every orchestrator that has a `Quality gates` bullet below): a `## Rigor` section with the table of `references\u002Fquality-gates.md` section 3-10 and the block in `references\u002Forchestrator-template.md`. Ask the owner, per kind of unit, whether it is an audited decision (money, eligibility, compliance and client-facing text) or `other`, and write the answer: an agent never classifies a unit as `other` on its own. Audited decisions are `gated`, preselected; `other` units are `light` unless the owner assigns them `standard` or `gated` (software is `other`; offer `standard` for a normal expert build and write it only on the owner's answer). When it is unclear whether an output is an audited decision, treat it as one. A classification or a downgrade that lowers rigor needs the user's approval; an agent never decides it. Ask once who the owner is and write that name as the `OWNERS` line of the copied `waiver_ledger.py`, and copy `rigor_check.py` with it because it imports `waiver_ledger.py`. A role name, an idle seat and an earlier finding assign no gate. Show the table in the report of Step 6 item 7. A downgrade of one item, or a later lowering of a row, is a `WAIVERS.md` row with the owner's words and never a table edit alone; a harness that never downgrades passes `-` for the ledger. (adapted from references\u002Fopenrig\u002Fpackages\u002Fdaemon\u002Fspecs\u002Fagents\u002Fshared\u002Fskills\u002Fpods\u002Forchestration-team\u002FSKILL.md:17-19 and :149-152 (Apache-2.0))\n- **Error policy**: one retry then proceed and record the gap, except that a `once` phase is never retried automatically: it stops and asks (`references\u002Fstate-ledger.md` section 3a, rule O7); a verdict whose `candidate_id.py check` exits 3 gets its own row in the error table (treated as not given, the judging phase re-run on the current tree when the user agrees); never retry quota, auth or permission failures — open the partial artefacts, record what is missing, report; the orchestrator fills a gap only with facts it verified itself, never with a guessed judgement; in Mode A, `.filter(Boolean)` after every `parallel()`\u002F`pipeline()` and `log()` the dropped count.\n- **Ask before an outside effect** (every orchestrator of a harness that can send, write a record, publish or pay, a single agent included): paste the Ask-first block of `references\u002Forchestrator-template.md` before the first phase that does it, and into any `## Single-context fallback`. Before each phase that makes an outside call, the orchestrator shows that phase's calls with their exact arguments and stops; it makes them only after the user's explicit yes to that list, each once, and treats no answer, a no, a change and a run with nobody to answer as not sent. One list and one yes per sending phase; a list that names calls of two phases approves neither. Within a phase the batch is shown in full and approved once. A host permission prompt and a passed audit are not the yes. (adapted from references\u002Fpaperclip\u002Fskills\u002Fpaperclip\u002FSKILL.md:474-479 (MIT, Paperclip AI), idea only; adapted from references\u002Fopenrig\u002Fdocs\u002Freference\u002Fgetting-started.md:663-667 (Apache-2.0)) The skill that carries the block also sets `disable-model-invocation: true` in its frontmatter, so a model never starts it unasked; `lint_harness.py` warns `send-implicit` when the key is missing (adapted from references\u002Frepository_harness\u002Ftests\u002Finstaller\u002Fassert-agent-authority-contract.sh:90 (MIT), holder Hoang Nguyen per references\u002Frepository_harness\u002FLICENSE:1-3, idea only). On chat and Cowork the key may be ignored: unverified.\n- **Run mode** (every orchestrator): paste the Run mode block of `references\u002Forchestrator-template.md` after the Delegation gate and mark the phases that only add checking `[full-only]`, so the user can say \"run it light\", \"standard\" or \"full\" and the orchestrator skips them and starts its workers on cheap models. Light is a cost switch; standard and full raise one run; none of them lowers a unit the Rigor table runs `gated`. The cost fields it uses are `model` on the `Agent` call, which beats the agent file's `model:`, and `maxTurns` and `effort` in agent frontmatter (checked against the Claude Code docs, 2026-11-05).\n- **Scale**: 2-3 persistent agents for small jobs, 3-5 for medium, supervisor + 3-5 for large; Workflow calls from a handful to hundreds, capped by `budget.remaining()` when a budget is set.\n- **Quality gates** when the harness builds software or produces audited decisions — money, eligibility, compliance and client-facing text: credit or compliance assessments, client-facing advice and emails, legal or financial figures. A gap email is client-facing text and so is one; so is a servicing verdict. Which units run the chain below is the Rigor bullet's decision. Then: Authority List → fresh-context judge (max 3 rounds, one in a `standard` unit, then escalate with both positions) whose verdict also rules the fixed `cost statement` row (§3-11) → build one slice → boundary QA with `RESULT: PASS|FAIL` first line, the repo's real gates re-run, mutation spot-checks on a scratch copy, one builder retry → final report whose first line is Done \u002F partly done \u002F blocked (`references\u002Fquality-gates.md`). Each QA report and judge verdict names the candidate it judged, and the orchestrator checks that line before it commits or ships (`scripts\u002Fcandidate_id.py`, §3-7; `unverified` where no shell runs).\n- **`CLAUDE.md` pointer**: record only the block below, between its two marker lines, with the change history after the end marker. Agent lists, directory trees and run rules stay out of it.\n\n````markdown\n\u003C!-- finhub-harness:begin {orchestrator-skill-name} -->\n## Harness: {domain}\n\n**Goal:** {one line}\n\n**Trigger:** For {domain} work, use the `{orchestrator-skill-name}` skill. Simple questions may be answered directly.\n\u003C!-- finhub-harness:end {orchestrator-skill-name} -->\n\n**Change history:**\n| Date | Change | Target | Reason |\n| --- | --- | --- | --- |\n| {YYYY-MM-DD} | Initial build with finhub-harness | all | - |\n````\n\nOn an initial build the Reason column stays `-`; later rows carry the feedback or defect that caused the change.\n\nThe block belongs to this skill; everything else in `CLAUDE.md` belongs to the user. Each marker stands alone on its line, and the name in it is the orchestrator skill's kebab-case name, never translated, so several harnesses can share one file. Before writing anything, list the marker lines from the file itself, with `grep -n 'finhub-harness:' CLAUDE.md` or the Read tool, never from the copy of `CLAUDE.md` loaded at session start, which may not show HTML comment lines. Count only a line that holds nothing but a marker; a byte-order mark at the very start of the file does not count as text. Then take the first case that fits this orchestrator's name:\n\n1. No `CLAUDE.md`: create it with the block and the history table.\n2. No marker line for this name: back up, then add a blank line, the block and the history table at the end of the file. If an unmarked `## Harness: {domain}` section from an earlier build is already there, add no block: edit that section in place as before, put the history row in its table, and say in the report that the pointer has no markers, and that wrapping its heading, Goal and Trigger lines in the two markers, with the history kept below the end marker, lets a later run replace it in place.\n3. One begin line above one end line, with no other harness's marker between them: start the new block from the lines now between the markers and change only what this run changes, so an edit made there since the last build (by `finhub-harness-evolve` or by hand) is kept. If the result matches those lines, write nothing. Otherwise back up, replace only those lines, and put the history row in the table below the block. Every byte above the begin line and below the end line stays as it was.\n4. Anything else (a second begin or end line, an end line above its begin line, a marker without its partner, another harness's marker inside the block, or a `CLAUDE.md` you cannot read): write nothing to `CLAUDE.md`. Show the user the marker lines with their line numbers and ask them to fix the file by hand. Never guess which pair is meant.\n\nA renamed orchestrator: when the file holds a valid pair whose name matches no orchestrator skill of this harness, that block may be the old one of a harness that was renamed. Leave it exactly as it is, name it in the report together with the new block, and ask the user whether to remove it; never delete or rewrite a block under another name unasked. The lint does not flag it. (adapted from references\u002Fopenrig\u002Fpackages\u002Fdaemon\u002Fsrc\u002Fdomain\u002Fmanaged-blocks.ts:8 and :36 (Apache-2.0), idea only)\n\nBack up before the first write, as the backup gate of `finhub-harness-evolve` Phase 3 does: `cp -p CLAUDE.md CLAUDE.md.bak && cmp CLAUDE.md CLAUDE.md.bak`, using the first unused `CLAUDE.md.bak.2`, `CLAUDE.md.bak.3` and so on when `CLAUDE.md.bak` exists, and writing nothing if the copy fails or `cmp` prints anything. Keep the block, both marker lines included, to 1600 bytes or fewer: it is read at the start of every session, and the lint warns (`pointer-budget`) when it is longer. The change history below the block is never counted, never trimmed and never moved into it. On chat and Cowork, whether `CLAUDE.md` can be read or edited in place and whether the lint can run are unverified: give the user the block and the history row to paste, and check the four cases by hand. (adapted from references\u002Frepository_harness\u002Fscripts\u002Finstall-harness.sh:330-344 and :369 (MIT, Hoang Nguyen); size budget adapted from references\u002Frepository_harness\u002Ftests\u002Finstaller\u002Fassert-agent-authority-contract.sh:35 (MIT, Hoang Nguyen))\n\n- **Follow-up triggers** in the orchestrator `description`: \"re-run\", \"update\", \"fix\", \"redo only {part}\", \"improve the previous result\", plus the domain's everyday verbs.\n\n### Step 6: Verify and test\n\nFollow `references\u002Fskill-testing-guide.md`.\n\n1. **Files and references**: run `python3 scripts\u002Flint_harness.py project\u002F.claude` (path relative to this skill's directory) and fix every `ERROR` line; fix each `WARN` line or say in the report why it stays. The lint checks frontmatter, name grammar and that a skill's directory matches its name, non-empty descriptions, that every `subagent_type`\u002F`agentType` names an agent file or a built-in type, that `## Required connectors` lines and the preflight table agree, that no agent or skill file which calls `Agent(`, `agent(`, `Task(` or `SendMessage`, or names `subagent_type` or `agentType`, contains a lazy-delegation phrase (WARN `lazy-delegation`), and v1 artefacts, and that local markdown links, a skill's single-level `references\u002F\u003Cfile>.\u003Cext>` mentions and agent and skill names (`broken-link`, `bundled-ref`, `duplicate-name`) are not dead or duplicated, and that a skill which sets any of `last_verified`, `verified_source` or `review_days` has a real calendar date that is not in the future, a source that is not the skill itself and holds a URL or a year, and a window the date has not outrun (WARN only, each with a fix: `verified-date`, `verified-future`, `verified-bare`, `verified-window`, `verified-stale`, `verified-orphan`; a skill that sets none of the three is not checked), and that the `CLAUDE.md` beside DIR (in DIR's parent when DIR is `.claude`) has, per orchestrator name, one begin marker line above one end marker line with no other harness's marker between them (`pointer-marker`, ERROR) and a block of at most 1600 bytes (`pointer-budget`, WARN; a `CLAUDE.md` with no marker line is not checked); for a mention of a file you mean to create later, write it with a path prefix (`\u003Cskill>\u002Freferences\u002Fx.md`), inside a code fence or as an angle-bracket placeholder rather than waiving the ERROR; it exits 1 on any error. Where it cannot run (chat without code execution), check the same list by hand. The lint does not check that nothing was written to `.claude\u002Fcommands\u002F` or that every Authority List citation opens to a line that supports the claim; check those yourself. Where the project pins `references\u002F` submodules, the cite check, run from the project root as `python3 \u003Cthis skill's directory>\u002Fscripts\u002Fcite_check.py \u003Cdesign or port map>`, confirms that each `references\u002F\u003Csub>\u002F\u003Cpath>:\u003Cline>` cite exists at the pinned commit and is in range, not that it supports the claim; a generated judge agent file says to run it before the first claim and names where it is: this skill's `scripts\u002F` when the plugin is installed, or a copy in the harness's own `scripts\u002F` (`references\u002Fquality-gates.md` §1-4). (adapted from references\u002Fcrewai\u002Flib\u002Fcrewai\u002Fsrc\u002Fcrewai\u002Fskills\u002Fvalidation.py:43 (MIT)) (provenance rules adapted from references\u002Fopenrig\u002Fpackages\u002Fdaemon\u002Fsrc\u002Fdomain\u002Fskill-audit.ts:98-136 (Apache-2.0))\n2. **Per mode**: A — `meta` is a pure literal, no `Date.now()`\u002F`Math.random()`, `parallel()` only where a barrier is needed, `.filter(Boolean)` present, `phase()` titles match `meta.phases`; B — message routes, task dependencies, agent count; C — inputs chain to outputs, parallel calls batched in one message; mixed — mode written per phase and hand-offs unbroken. Chat\u002FCowork targets — the single-context fallback covers every phase. Delegation, wherever workers are spawned or messaged — `grep -l 'STATUS:' project\u002F.claude\u002Fskills\u002F*\u002FSKILL.md` lists the orchestrator. Where the lint cannot run, `grep -nEi 'based on (your|the) (findings|research)|as (we )?discussed' project\u002F.claude\u002Fskills\u002F*\u002FSKILL.md project\u002F.claude\u002Fagents\u002F*.md` is a stricter manual fallback (no word boundaries, every file, blind to a phrase wrapped over two lines): judge each hit by hand, because a research-and-write skill may legitimately keep one.\n3. **Skill runs**: 2-3 realistic prompts per skill, with-skill vs baseline in parallel, qualitative plus assertion-based grading; fix by principle, not per example; repeat until gains flatten; move repeated helper code into `scripts\u002F`.\n4. **Trigger check**: 10 should-trigger prompts in varied register and 10 near-miss should-not-trigger prompts; check for collisions with existing skills' descriptions.\n5. **Dry run**: phase order, hand-off paths, input\u002Foutput fit, error branches executable.\n6. **Record** one happy-path and at least one error-path scenario under `## Test scenarios` in the orchestrator. A harness with the Ask-first block also records its three cases (no answer, a no, a yes), run against a stub connector that records its calls.\n7. **Rigor table**: put the harness's `## Rigor` table in the report you give the owner, with the class and the level of each scope and who assigned it. It is the owner's answer from build time and nothing compares it with anything (`references\u002Fquality-gates.md` section 3-10).\n\n### Step 7: Operate, maintain and improve\n\nA harness is not a one-off artefact. Retrospectives and feedback belong to `finhub-harness-evolve` (\"harness retrospective\", \"evolve the harness\", \"fold this feedback in\"). This skill handles operation:\n\n1. **Status check**: diff `.claude\u002Fagents\u002F`, `.claude\u002Fskills\u002F` and the orchestrator; list mismatches and report.\n2. **Incremental change**: one item at a time, verify immediately.\n3. **Change history**: date, change, target, reason in `CLAUDE.md`.\n4. **Verify the change**: structure always; trigger test if a description changed; run test and dry run if the change is large; final `CLAUDE.md`-vs-files check.\n5. **Audit**: when the user asks whether a harness's rules have real checks, follow `references\u002Faudit-guide.md`: one row per rule or check, one finding each (enforced, partially enforced, unenforced rule, check lacking authority, unknown), evidence classes never promoted, and the audit reads and reports without editing.\n\nSuggest `finhub-harness-evolve` when the same feedback recurs, an agent fails twice for the same cause, a QA report or judge verdict rejects for the same reason twice, or the user keeps doing the orchestrator's job by hand.\n\n### Enriching from other harness repos\n\nWhen the user wants a pattern from another harness (`\"borrow the judge panel from repo Y\"`, `\"adopt how Z sandboxes code\"`), do not copy. Pin the repo as a reference submodule, run the port-map procedure, then adopt the pattern through an Authority List row with its licence tier. `references\u002Fsource-enrichment.md` has the procedure, the pinned repos and their tiers.\n\n## Deliverable checklist\n\n- [ ] Every reusable custom type has a file in `project\u002F.claude\u002Fagents\u002F`; one-offs on built-in types have none.\n- [ ] Every needed `SKILL.md` and reference exists under `project\u002F.claude\u002Fskills\u002F`.\n- [ ] Every agent has an assigned library skill or a `none found` row in the agent | skill | why table; every assigned name appears in the host's skill listing and in the agent's body, and no sending skill sits on a non-sending worker.\n- [ ] One orchestrator skill with data hand-off, error policy, test scenarios and a declared target surface; a single-context fallback if chat or Cowork is a target.\n- [ ] Execution mode written (per phase if mixed); no v1 artefacts.\n- [ ] `scripts\u002Flint_harness.py` exits 0 on `project\u002F.claude`, and every `WARN` line is fixed or explained.\n- [ ] `model:` chosen per agent from the task, with the reason as a comment; no blanket top-model setting.\n- [ ] Workflow scripts: `.filter(Boolean)` present, `meta` literal, `parallel()` only for real barriers.\n- [ ] Nothing written to `.claude\u002Fcommands\u002F`.\n- [ ] Existing agents and skills checked for overlap before creating new ones; no name or role collision.\n- [ ] Artefacts written in the user's language (or the existing harness's language).\n- [ ] Every skill `description` names its trigger situations and follow-up phrasings.\n- [ ] Every `SKILL.md` under 500 lines; detail moved to `references\u002F`.\n- [ ] Run with 2-3 realistic prompts; triggers validated with should and should-not cases.\n- [ ] `CLAUDE.md` holds only the trigger pointer, inside its one pair of finhub-harness marker lines (1600 bytes or fewer), and the change history below it; the user's own text outside the block is unchanged.\n- [ ] Orchestrator Step 0 distinguishes first run, follow-up and partial re-run (and `resumeFromRunId` for Workflow mode).\n- [ ] Every `## Required connectors` line in an agent file has a row in the orchestrator's connector preflight table, and every row has a matching agent line.\n- [ ] Every worker brief has Goal, Inputs, Scope, Expected output and Report; every worker report ends in STATUS \u002F EVIDENCE \u002F BLOCKER form; the orchestrator re-asks once and then marks the result unverified (a `once` phase is never re-asked).\n- [ ] A harness that can send, write a record, publish or pay has the Ask-first block before its first such phase and in its single-context fallback, and its test scenarios hold the no-answer, no and yes cases.\n- [ ] Every section that launches writers in parallel has a `## Writers` table with one ownership label per writer (`references\u002Fwrite-safety.md`); `python3 scripts\u002Fcheck_writers.py --require` on that orchestrator exits 0 (path relative to this skill's directory); a harness with one writer needs no table and is not run with `--require`.\n- [ ] Borrowed patterns cited in an Authority List with licence tier; net-new decisions labelled with reason and test.\n- [ ] If the harness builds software: QA runs the repo's real gates after every slice and reports `RESULT:` first, then `CANDIDATE:`; the orchestrator runs `candidate_id.py check` on that report before it commits. Each mutant it ran ends in `STATE: CAUGHT` or is redone.\n\n## References\n\n- Execution modes and v1→v2 migration: `references\u002Fexecution-modes.md`\n- Surfaces (Code \u002F chat \u002F Cowork) and the single-context fallback: `references\u002Fsurfaces.md`\n- Model selection: `references\u002Fmodel-selection-guide.md`\n- Team patterns and agent definitions: `references\u002Fteam-patterns.md`\n- Worked team examples: `references\u002Fteam-examples.md`\n- Workflow scripts and pitfalls: `references\u002Fworkflow-recipes.md`\n- Orchestrator templates: `references\u002Forchestrator-template.md`\n- State ledger, rebuild and resume across context resets: `references\u002Fstate-ledger.md`\n- Run-once phases: a resume stops and asks about a half-done send, publish or record write (the ledger reads files only; an idempotency key accepted by the connector is the real fix): `references\u002Fstate-ledger.md` section 3a\n- Asking before an outside effect (the exact calls shown, an explicit yes, each call once, no answer is no): `references\u002Forchestrator-template.md`, Ask-first block\n- Bulk job with one phase repeated over N items: a per-row tracker so a re-run resumes at the item, not the phase (`scripts\u002Funit_tracker.py`, rules U1-U8): `references\u002Funit-tracker.md`\n- The same work over many items, pilot first, then fan out (rules P1-P6): `references\u002Fteam-patterns.md` section 1-2a\n- Skill writing: `references\u002Fskill-writing-guide.md`\n- Skill testing: `references\u002Fskill-testing-guide.md`\n- A harness that tries changes and keeps the winners (the seven-item contract named before the first candidate, a read-only evaluation surface, a ledger, gates before the score, and a four-scenario A\u002FB for team layouts): `references\u002Fexperiment-profile.md`\n- QA agents: `references\u002Fqa-agent-guide.md`\n- Authority List, adversarial audit, mutation-tested QA, honest reporting: `references\u002Fquality-gates.md`\n- A mutant counts as caught only when the test written for it fails at the assertion written for it, between a passing run before and a passing run after: `references\u002Fquality-gates.md` §3-4 (rules M1-M8) and `scripts\u002Fmutant_gate.py` (adapted from references\u002Fopenrig\u002Fpackages\u002Ftest-system\u002Fci\u002Fresult.mjs:33-34 (Apache-2.0))\n- Naming the tree a verdict judged, and refusing a stale verdict: `references\u002Fquality-gates.md` §3-7 and `scripts\u002Fcandidate_id.py` (adapted from references\u002Fopenrig\u002Fscripts\u002Fgate-lane-consume.mjs:23-25 (Apache-2.0))\n- Checking that each `references\u002F\u003Csub>\u002F\u003Cpath>:\u003Cline>` cite exists at the pinned commit and is in range: `references\u002Fquality-gates.md` §1-4 and `scripts\u002Fcite_check.py` (adapted from references\u002Frepository_harness (MIT); the source lines are named in §1-4)\n- Parallel writers, the ownership ladder and honest labels: `references\u002Fwrite-safety.md` (adapted from references\u002Fmeta_harness\u002F.agents\u002Fskills\u002Fharness\u002FSKILL.md:133 (Apache-2.0))\n- Updating installed harness files from a new version without overwriting edits (plan against a stored baseline, stage conflicts, edit nothing; rules R1-R6): `references\u002Fsafe-update.md` and `scripts\u002Fsafe_update.py` (adapted from references\u002Frepository_harness\u002Fcrates\u002Fharness\u002Fsrc\u002Fapplication\u002Fservice.rs:516 (MIT, Hoang Nguyen), idea only)\n- Borrowing from other harness repos under licence rules: `references\u002Fsource-enrichment.md`\n",{"name":5,"description":7},"main","dda161ff9daf0d9bccbdba26e34bbee0438a18b0","skills\u002Ffinhub-harness",0,"https:\u002F\u002Fgithub.com\u002Fdanielnguyenfinhub\u002Ffinhub-harness","https:\u002F\u002Fgithub.com\u002Fdanielnguyenfinhub","www.finhub.net.au","2026-11-12 17:07:32",{"source":8,"skillName":5,"commands":33,"prompt":43,"zipAvailable":44},[34,37,40],{"tool":35,"command":36},"npx","npx skills add danielnguyenfinhub\u002Ffinhub-harness --skill finhub-harness",{"tool":38,"command":39},"bunx","bunx skills add danielnguyenfinhub\u002Ffinhub-harness --skill finhub-harness",{"tool":41,"command":42},"pnpm","pnpm dlx skills add danielnguyenfinhub\u002Ffinhub-harness --skill finhub-harness","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fdanielnguyenfinhub\u002Ffinhub-harness\u002Fblob\u002Fmain\u002Fskills\u002Ffinhub-harness\u002FSKILL.md",true,[46,52,56,60,64,68,72,76,80,84,88,92,96,100,104,108,112,116,120,126,130,134,138,142,146,150,154,158,162],{"path":47,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":50,"sourceHtmlUrl":51},"references\u002Faudit-guide.md","REFERENCE","参考文档",3139,"https:\u002F\u002Fgithub.com\u002Fdanielnguyenfinhub\u002Ffinhub-harness\u002Fblob\u002Fmain\u002Fskills\u002Ffinhub-harness\u002Freferences\u002Faudit-guide.md",{"path":53,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":54,"sourceHtmlUrl":55},"references\u002Fexecution-modes.md",14686,"https:\u002F\u002Fgithub.com\u002Fdanielnguyenfinhub\u002Ffinhub-harness\u002Fblob\u002Fmain\u002Fskills\u002Ffinhub-harness\u002Freferences\u002Fexecution-modes.md",{"path":57,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":58,"sourceHtmlUrl":59},"references\u002Fexperiment-profile.md",4836,"https:\u002F\u002Fgithub.com\u002Fdanielnguyenfinhub\u002Ffinhub-harness\u002Fblob\u002Fmain\u002Fskills\u002Ffinhub-harness\u002Freferences\u002Fexperiment-profile.md",{"path":61,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":62,"sourceHtmlUrl":63},"references\u002Fmodel-selection-guide.md",10191,"https:\u002F\u002Fgithub.com\u002Fdanielnguyenfinhub\u002Ffinhub-harness\u002Fblob\u002Fmain\u002Fskills\u002Ffinhub-harness\u002Freferences\u002Fmodel-selection-guide.md",{"path":65,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":66,"sourceHtmlUrl":67},"references\u002Forchestrator-template.md",50148,"https:\u002F\u002Fgithub.com\u002Fdanielnguyenfinhub\u002Ffinhub-harness\u002Fblob\u002Fmain\u002Fskills\u002Ffinhub-harness\u002Freferences\u002Forchestrator-template.md",{"path":69,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":70,"sourceHtmlUrl":71},"references\u002Fqa-agent-guide.md",31781,"https:\u002F\u002Fgithub.com\u002Fdanielnguyenfinhub\u002Ffinhub-harness\u002Fblob\u002Fmain\u002Fskills\u002Ffinhub-harness\u002Freferences\u002Fqa-agent-guide.md",{"path":73,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":74,"sourceHtmlUrl":75},"references\u002Fquality-gates.md",106747,"https:\u002F\u002Fgithub.com\u002Fdanielnguyenfinhub\u002Ffinhub-harness\u002Fblob\u002Fmain\u002Fskills\u002Ffinhub-harness\u002Freferences\u002Fquality-gates.md",{"path":77,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":78,"sourceHtmlUrl":79},"references\u002Fsafe-update.md",4174,"https:\u002F\u002Fgithub.com\u002Fdanielnguyenfinhub\u002Ffinhub-harness\u002Fblob\u002Fmain\u002Fskills\u002Ffinhub-harness\u002Freferences\u002Fsafe-update.md",{"path":81,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":82,"sourceHtmlUrl":83},"references\u002Fskill-testing-guide.md",14843,"https:\u002F\u002Fgithub.com\u002Fdanielnguyenfinhub\u002Ffinhub-harness\u002Fblob\u002Fmain\u002Fskills\u002Ffinhub-harness\u002Freferences\u002Fskill-testing-guide.md",{"path":85,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":86,"sourceHtmlUrl":87},"references\u002Fskill-writing-guide.md",13872,"https:\u002F\u002Fgithub.com\u002Fdanielnguyenfinhub\u002Ffinhub-harness\u002Fblob\u002Fmain\u002Fskills\u002Ffinhub-harness\u002Freferences\u002Fskill-writing-guide.md",{"path":89,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":90,"sourceHtmlUrl":91},"references\u002Fsource-enrichment.md",12444,"https:\u002F\u002Fgithub.com\u002Fdanielnguyenfinhub\u002Ffinhub-harness\u002Fblob\u002Fmain\u002Fskills\u002Ffinhub-harness\u002Freferences\u002Fsource-enrichment.md",{"path":93,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":94,"sourceHtmlUrl":95},"references\u002Fstate-ledger.md",25536,"https:\u002F\u002Fgithub.com\u002Fdanielnguyenfinhub\u002Ffinhub-harness\u002Fblob\u002Fmain\u002Fskills\u002Ffinhub-harness\u002Freferences\u002Fstate-ledger.md",{"path":97,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":98,"sourceHtmlUrl":99},"references\u002Fsurfaces.md",15833,"https:\u002F\u002Fgithub.com\u002Fdanielnguyenfinhub\u002Ffinhub-harness\u002Fblob\u002Fmain\u002Fskills\u002Ffinhub-harness\u002Freferences\u002Fsurfaces.md",{"path":101,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":102,"sourceHtmlUrl":103},"references\u002Fteam-examples.md",11705,"https:\u002F\u002Fgithub.com\u002Fdanielnguyenfinhub\u002Ffinhub-harness\u002Fblob\u002Fmain\u002Fskills\u002Ffinhub-harness\u002Freferences\u002Fteam-examples.md",{"path":105,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":106,"sourceHtmlUrl":107},"references\u002Fteam-patterns.md",27833,"https:\u002F\u002Fgithub.com\u002Fdanielnguyenfinhub\u002Ffinhub-harness\u002Fblob\u002Fmain\u002Fskills\u002Ffinhub-harness\u002Freferences\u002Fteam-patterns.md",{"path":109,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":110,"sourceHtmlUrl":111},"references\u002Funit-tracker.md",10240,"https:\u002F\u002Fgithub.com\u002Fdanielnguyenfinhub\u002Ffinhub-harness\u002Fblob\u002Fmain\u002Fskills\u002Ffinhub-harness\u002Freferences\u002Funit-tracker.md",{"path":113,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":114,"sourceHtmlUrl":115},"references\u002Fworkflow-recipes.md",17278,"https:\u002F\u002Fgithub.com\u002Fdanielnguyenfinhub\u002Ffinhub-harness\u002Fblob\u002Fmain\u002Fskills\u002Ffinhub-harness\u002Freferences\u002Fworkflow-recipes.md",{"path":117,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":118,"sourceHtmlUrl":119},"references\u002Fwrite-safety.md",11761,"https:\u002F\u002Fgithub.com\u002Fdanielnguyenfinhub\u002Ffinhub-harness\u002Fblob\u002Fmain\u002Fskills\u002Ffinhub-harness\u002Freferences\u002Fwrite-safety.md",{"path":121,"resourceType":122,"resourceTypeDesc":123,"sizeBytes":124,"sourceHtmlUrl":125},"scripts\u002Fcandidate_id.py","SCRIPT","脚本",18637,"https:\u002F\u002Fgithub.com\u002Fdanielnguyenfinhub\u002Ffinhub-harness\u002Fblob\u002Fmain\u002Fskills\u002Ffinhub-harness\u002Fscripts\u002Fcandidate_id.py",{"path":127,"resourceType":122,"resourceTypeDesc":123,"sizeBytes":128,"sourceHtmlUrl":129},"scripts\u002Fcheck_writers.py",12996,"https:\u002F\u002Fgithub.com\u002Fdanielnguyenfinhub\u002Ffinhub-harness\u002Fblob\u002Fmain\u002Fskills\u002Ffinhub-harness\u002Fscripts\u002Fcheck_writers.py",{"path":131,"resourceType":122,"resourceTypeDesc":123,"sizeBytes":132,"sourceHtmlUrl":133},"scripts\u002Fcite_check.py",13852,"https:\u002F\u002Fgithub.com\u002Fdanielnguyenfinhub\u002Ffinhub-harness\u002Fblob\u002Fmain\u002Fskills\u002Ffinhub-harness\u002Fscripts\u002Fcite_check.py",{"path":135,"resourceType":122,"resourceTypeDesc":123,"sizeBytes":136,"sourceHtmlUrl":137},"scripts\u002Ffinding_tags.py",29619,"https:\u002F\u002Fgithub.com\u002Fdanielnguyenfinhub\u002Ffinhub-harness\u002Fblob\u002Fmain\u002Fskills\u002Ffinhub-harness\u002Fscripts\u002Ffinding_tags.py",{"path":139,"resourceType":122,"resourceTypeDesc":123,"sizeBytes":140,"sourceHtmlUrl":141},"scripts\u002Flint_harness.py",24223,"https:\u002F\u002Fgithub.com\u002Fdanielnguyenfinhub\u002Ffinhub-harness\u002Fblob\u002Fmain\u002Fskills\u002Ffinhub-harness\u002Fscripts\u002Flint_harness.py",{"path":143,"resourceType":122,"resourceTypeDesc":123,"sizeBytes":144,"sourceHtmlUrl":145},"scripts\u002Fmutant_gate.py",12016,"https:\u002F\u002Fgithub.com\u002Fdanielnguyenfinhub\u002Ffinhub-harness\u002Fblob\u002Fmain\u002Fskills\u002Ffinhub-harness\u002Fscripts\u002Fmutant_gate.py",{"path":147,"resourceType":122,"resourceTypeDesc":123,"sizeBytes":148,"sourceHtmlUrl":149},"scripts\u002Frigor_check.py",17799,"https:\u002F\u002Fgithub.com\u002Fdanielnguyenfinhub\u002Ffinhub-harness\u002Fblob\u002Fmain\u002Fskills\u002Ffinhub-harness\u002Fscripts\u002Frigor_check.py",{"path":151,"resourceType":122,"resourceTypeDesc":123,"sizeBytes":152,"sourceHtmlUrl":153},"scripts\u002Fsafe_update.py",6381,"https:\u002F\u002Fgithub.com\u002Fdanielnguyenfinhub\u002Ffinhub-harness\u002Fblob\u002Fmain\u002Fskills\u002Ffinhub-harness\u002Fscripts\u002Fsafe_update.py",{"path":155,"resourceType":122,"resourceTypeDesc":123,"sizeBytes":156,"sourceHtmlUrl":157},"scripts\u002Fstate_ledger.py",14544,"https:\u002F\u002Fgithub.com\u002Fdanielnguyenfinhub\u002Ffinhub-harness\u002Fblob\u002Fmain\u002Fskills\u002Ffinhub-harness\u002Fscripts\u002Fstate_ledger.py",{"path":159,"resourceType":122,"resourceTypeDesc":123,"sizeBytes":160,"sourceHtmlUrl":161},"scripts\u002Funit_tracker.py",21866,"https:\u002F\u002Fgithub.com\u002Fdanielnguyenfinhub\u002Ffinhub-harness\u002Fblob\u002Fmain\u002Fskills\u002Ffinhub-harness\u002Fscripts\u002Funit_tracker.py",{"path":163,"resourceType":122,"resourceTypeDesc":123,"sizeBytes":164,"sourceHtmlUrl":165},"scripts\u002Fwaiver_ledger.py",7526,"https:\u002F\u002Fgithub.com\u002Fdanielnguyenfinhub\u002Ffinhub-harness\u002Fblob\u002Fmain\u002Fskills\u002Ffinhub-harness\u002Fscripts\u002Fwaiver_ledger.py",[167,174,181,187,193,200],{"skillNo":168,"name":169,"nameZh":6,"description":170,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":171,"categories":172,"keywords":173,"publishedAt":19},"01M7DMBP1MQ9X39BGJ9VF62M9P","linky","Fixture whose links and bundled-file mentions all resolve. Use to prove no false errors.","https:\u002F\u002Fgithub.com\u002Fdanielnguyenfinhub\u002Ffinhub-harness\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fharness_links_ok\u002Fskills\u002Flinky\u002FSKILL.md",[],[],{"skillNo":175,"name":176,"nameZh":6,"description":177,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":178,"categories":179,"keywords":180,"publishedAt":19},"01M7DMBK70KXF6A3V1VDRHYGVT","dup-one","Second owner of the name. Use for the duplicate fixture.","https:\u002F\u002Fgithub.com\u002Fdanielnguyenfinhub\u002Ffinhub-harness\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fharness_links_bad\u002Fskills\u002Fdup-two\u002FSKILL.md",[],[],{"skillNo":182,"name":176,"nameZh":6,"description":183,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":184,"categories":185,"keywords":186,"publishedAt":19},"01M7DMBFWK8HD4AWNK89KGE89P","First owner of the name. Use for the duplicate fixture.","https:\u002F\u002Fgithub.com\u002Fdanielnguyenfinhub\u002Ffinhub-harness\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fharness_links_bad\u002Fskills\u002Fdup-one\u002FSKILL.md",[],[],{"skillNo":188,"name":189,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":190,"categories":191,"keywords":192,"publishedAt":19},"01M7DMBETX7172TFNBAA3BVREQ","nested","https:\u002F\u002Fgithub.com\u002Fdanielnguyenfinhub\u002Ffinhub-harness\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fharness_links_bad\u002Fskills\u002Fbroken\u002Fnested\u002FSKILL.md",[],[],{"skillNo":194,"name":195,"nameZh":6,"description":196,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":197,"categories":198,"keywords":199,"publishedAt":19},"01M7DMBDCH5G61QVAB1QFMQA55","broken","Fixture with one defect per rule. Use to prove each rule fires.","https:\u002F\u002Fgithub.com\u002Fdanielnguyenfinhub\u002Ffinhub-harness\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fharness_links_bad\u002Fskills\u002Fbroken\u002FSKILL.md",[],[],{"skillNo":201,"name":202,"nameZh":6,"description":203,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":204,"categories":205,"keywords":206,"publishedAt":19},"01M7DMBAQHY0Z2PTYGCPM8H7MT","notes-style","House style for client notes. Use when writing or editing a client note.","https:\u002F\u002Fgithub.com\u002Fdanielnguyenfinhub\u002Ffinhub-harness\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fharness_good\u002Fskills\u002Fnotes-style\u002FSKILL.md",[],[]]