[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M75404N306PY1JFPQ0GGNTYB":3,"skill-same:01M75404N306PY1JFPQ0GGNTYB":177},{"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":26,"commitSha":27,"skillDirectory":28,"forksCount":29,"repositoryHtmlUrl":30,"repositoryHomepageUrl":6,"ownerHtmlUrl":31,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":32,"install":33,"resources":46},"01M75404N306PY1JFPQ0GGNTYB","workflow",null,"Routes any dev task into the right execution tier (Small\u002FMedium\u002FLarge) and carries condux's operating rules — proportional effort, lazy skill loading, soft gates, implement-yourself-by-default.","jabworks\u002Fagentic-toolkit","jabworks","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F159094119?v=4","01M753P4JBZBTT7WN1PJBPZJZP","JAB Works","01M753P4K5KDGEWGXWT811BZET",2,"MIT","https:\u002F\u002Fgithub.com\u002Fjabworks\u002Fagentic-toolkit\u002Fblob\u002Fmain\u002Fskills\u002Fworkflow\u002FSKILL.md",[],[],"2026-11-12 13:55:43",false,"---\nname: workflow\ndescription: Routes any dev task into the right execution tier (Small\u002FMedium\u002FLarge) and carries condux's operating rules — proportional effort, lazy skill loading, soft gates, implement-yourself-by-default.\nwhen_to_use: \"Trigger with any dev task, however small or mundane — feature, bug fix, refactor, new endpoint, UI change, adding tests, CI and tooling config, docs and README edits, a one-line tweak. Every task starts here regardless of size (the tier decides the ceremony), including requests to start or prep a task, like loading its spec before beginning. Other skills execute within \u002Fworkflow, not instead of it. Also the operating manual — how condux works: tiers, soft gates, checkpoints, named agents.\"\nargument-hint: \"\u003Ctask description>\"\n---\n\n# \u002Fworkflow\n\nPick the right tier, confirm it, execute. No over-engineering for a button change.\nNo under-planning for a cross-cutting feature.\n\n## Usage\n\n```\n\u002Fworkflow $ARGUMENTS\n```\n\n## Live Context\n\n```!\ngit status --short 2>\u002Fdev\u002Fnull || echo \"(not a git repository yet)\"\ngit log --oneline -5 2>\u002Fdev\u002Fnull || echo \"(no commits yet)\"\n```\n\n## Operating Rules\n\nCondux is **lean and proportional** — the opposite of \"always run every gate.\"\n\n1. **Proportional, not maximal.** Match the tier to the task. Don't discovery a\n   typo. Don't wing a cross-cutting refactor.\n2. **Lazy loading.** Never load `discovery`, `draft-plan`, `test-first-development`,\n   `subagent-execution`, or `finalize` upfront. Load a skill only when the tier flow\n   reaches the step that needs it.\n3. **Soft gates, not hard walls.** A gate (e.g. discovery before planning) can be\n   skipped — but only *consciously*. If a gate hasn't run, ask the user whether they\n   want to skip it; never silently bypass it.\n4. **The user is in control.** Condux shapes *how* you work, but explicit user\n   instructions (CLAUDE.md, AGENTS.md, direct requests) always win. \"Treat this as\n   LARGE\" or \"skip the plan\" is always valid.\n5. **Implement yourself by default.** Spawning agents is the exception — only\n   delegate with a concrete justification (see Agents below).\n6. **House style rides along.** Before the first line of code in any tier, load\n   the `coding-directive` skill if it is installed — skip silently when it\n   isn't. Codebase mimicry and repo config still win over the directive.\n7. **Two tracks, one of them triggered.** Tactical is the task in front of you.\n   Strategic is the environment that produced it — would a narrower type, a\n   lint rule, or a written convention have made this task's bug impossible?\n   The strategic track is *not* a standing obligation; that would violate rule\n   1. It fires on a trigger, and the triggers are in Environment Hardening.\n\n## Entry Contract\n\nEvery dev task starts with `\u002Fworkflow` — no exceptions unless the user says so.\n\n**Valid bypasses (explicit user instruction required):**\n- Mid-flow: \"I've already designed\u002Fplanned this\" → skip to the relevant step.\n- Explicit opt-out: \"skip workflow\", \"just do it\" → proceed, but note the skip.\n\n**Not valid bypasses:**\n- Your own judgment that the task \"seems small\" — tier inference is this skill's\n  job, not yours.\n- Being loaded as companion context alongside another skill — run `\u002Fworkflow`\n  first; the other skill executes within it, not instead of it.\n\n## Tiers\n\n| Tier | Looks like | Flow |\n|---|---|---|\n| **SMALL** | isolated change, 1–3 files, clear requirements (a button, a label, a prop, a typo) | implement → `\u002Fpreflight` → `\u002Ffinalize` |\n| **MEDIUM** | multi-file, some design needed, known boundaries (new form + API route, new procedure) | quick inline plan → implement → `\u002Fpreflight` → `\u002Ffinalize` |\n| **LARGE** | cross-cutting, unclear scope, multiple subsystems (new module, auth flow, data-model change) | `\u002Fdiscovery` → `\u002Fdraft-plan` → implement → `\u002Fpreflight` → `\u002Ffinalize` |\n\nEvery tier ends with `preflight` then `finalize` — no exceptions.\n\n## The Router\n\n1. **Infer the tier.** How many files? Requirement clear or needs design? Crosses\n   service\u002Fpackage boundaries? Unknowns needing exploration first? In a mobile\n   app, also: does it touch the native layer (finalize's native-change check\n   lists what does)? That doesn't change the tier — a one-line Kotlin fix is\n   still SMALL — but say so when confirming, because nothing can verify it\n   until the app is rebuilt and reinstalled.\n2. **Spec lookup.** Detect the package root (walk up from CWD to git root, find the\n   nearest `package.json` \u002F `Cargo.toml` \u002F `go.mod` \u002F `pyproject.toml`). Check both\n   scopes (deduplicate if identical):\n   `ls \u003Cpackage-root>\u002Fspecs\u002F 2>\u002Fdev\u002Fnull` and `ls \u003Cgit-root>\u002Fspecs\u002F 2>\u002Fdev\u002Fnull`.\n   Match the task subject to a spec dir (fuzzy kebab-case: \"checkout flow\" →\n   `specs\u002Fcheckout-flow`). If found, read `index.md`, then load by task type —\n   bug\u002Fdebug → `quirks.md`, `api.md`, `fields.md`; refactor → `implementation.md`,\n   `decisions.md`; new feature → `prd.md`, `decisions.md`, `api.md`, `fields.md`\n   (any of these the spec does not have is skipped silently). Carry this\n   context through; don't re-read mid-task. No spec → proceed without comment.\n3. **Confirm with the user.** State the inferred tier + a one-sentence reason. If a\n   spec was loaded, mention it and offer the companion: \"Found spec for\n   `checkout-flow` — loaded as context. Want the live HTML preview while we work?\n   [y\u002Fn]\" (if yes, load `technical-spec` and run its preview). Wait for explicit\n   confirmation before proceeding.\n4. **Execute the tier flow**, loading only the skills the tier needs, when needed.\n5. **Checkpoints (MEDIUM\u002FLARGE).** At each phase boundary, stop and present a\n   \"what next?\" menu (AskUserQuestion), recommended option first. The user drives\n   every transition — never auto-advance. SMALL runs linear with no menus.\n\n### Tier flows\n\n- **SMALL:** implement directly (no plan doc, no discovery) → `\u002Fpreflight` → `\u002Ffinalize`.\n- **MEDIUM:** short inline plan (same section shape as draft-plan, kept lean —\n  Overview · Files · Interfaces · Sketch where non-obvious · Edge cases) → CP-1 →\n  implement top-to-bottom → CP-2 → `\u002Fpreflight` → `\u002Ffinalize` → CP-3.\n- **LARGE:** load `discovery`, run fully to sign-off → load `draft-plan`, produce the\n  plan doc, sign-off → CP-1 → implement task by task, keeping the Progress Ledger\n  (`subagent-execution` if the user picks it) → CP-2 → `\u002Fpreflight` → `\u002Ffinalize` → CP-3.\n\n## Checkpoints\n\nAfter the user picks, load **only** that skill, run it, then return to the nearest\ncheckpoint and re-present the menu until the user chooses Done.\n\n**When the question tool caps the options.** CP-1 and CP-3 have five rows, and\nsome hosts' question tools take four (Claude Code's AskUserQuestion does). The\nfirst four rows go on buttons, recommended first. The fifth row rides in the\nfree-text slot the tool adds (\"Other\"), and the question text names it:\n\"Plan ready — how do we proceed? (or type 'revise' to rework the plan)\" for\nCP-1, \"(or say done)\" for CP-3. Never merge two rows into one button to make\nroom — \"Use agents\" for the two agent rows is exactly the erosion this rule\nprevents. A host with no cap, or a plain-text menu, shows every row.\n\n**When the question tool doesn't block.** Codex's `request_user_input` queues\nthe question beside the turn: the model keeps working, the host may answer it\non a timer (`autoResolutionMs`), and an unanswered question is dropped when the\nturn ends. Every checkpoint therefore ends the turn with the full menu as a\nnumbered plain-text list in the final message (the user replies with a number\nor a row name). The picker may be shown as well, but the final message is the\nmenu of record. Never treat a picker answer you didn't see the user give as\ntheir choice.\n\n### CP-1 — Plan ready\n\n*After draft-plan sign-off (LARGE) or the inline plan (MEDIUM). Plan review already\nhappened (or was declined) in draft-plan's own save step — don't re-offer it.*\n\n| Option | What it does |\n|---|---|\n| **Start implementing** *(recommended)* | Implement the plan top-to-bottom yourself |\n| **Write tests first** | Load `test-first-development`; one upfront consent, then test-first |\n| **Spawn specialist agents** | Load `subagent-execution`; execute the plan with named agents |\n| **Dispatch independent tasks in parallel** | Load `subagent-deployment`; fan out N independent tasks |\n| **Revise the plan** | Loop back to `draft-plan` with the new direction |\n\n**The menu is the full menu.** Present every row above, every time — including\nboth subagent options. Implement-yourself-by-default governs the\n*recommendation* marker, never which options appear: the user decides whether\nagents pay off, and an option they never see is a decision made for them. If\nplan sign-off and CP-1 get combined into one prompt (common in plan-approval\nUIs), the combined menu must still carry the full CP-1 option set.\n\n### CP-2 — Implementation done\n\n| Option | What it does |\n|---|---|\n| **Verify & finalize** *(recommended)* | Run `preflight`, then `finalize` |\n| **Code review first** | Load `code-review` on the diff before finalizing |\n| **Keep building** | More scope remains — re-confirm the tier if it grew |\n\n### CP-3 — Finalized and green\n\n| Option | What it does |\n|---|---|\n| **Verify it live** *(recommended when the change has a runnable surface — an app on an emulator counts)* | Load the `live-verification` skill and follow it — including on a mobile app: drive the real UI, endpoint or emulator, check each claim against observed behaviour, and write its report |\n| **Code review** *(recommended)* | `\u002Fcode-review` the diff before merging |\n| **Commit** | Load the `git-commit` skill if installed (conventional message from the diff, safe staging); otherwise follow the repo's commit conventions |\n| **Cut a release** | Load the `release` skill if installed — machinery detection, dry-run plan, then tag → push → GitHub release; otherwise follow the repo's release conventions |\n| **Done** | Stop here |\n\n## Skills and Gates\n\nLoad each only when its step is reached.\n\n| Skill | When | Gate discipline |\n|---|---|---|\n| `discovery` | LARGE, before planning, or scope unclear | soft gate — ask before skipping |\n| `blueprint` | discovery's propose step, or a standalone mockup\u002Fvisualization ask | load only when a UI surface or data model is in play; structure, never styling |\n| `draft-plan` | LARGE, after discovery sign-off | needs a signed-off design; no design → apply the discovery soft gate first |\n| `test-first-development` | user asks, or picks it at CP-1 | one upfront consent; always ask before editing an existing test spec |\n| `subagent-execution` | LARGE plan where specialization\u002Fparallelism pays off | default is implement yourself; keeps the Progress Ledger |\n| `subagent-deployment` | 2+ independent tasks, no shared files\u002Fdeps | ad-hoc work, not ordered plans |\n| `preflight` | end of every tier, before finalize | automatic on SMALL; recommended CP-2 choice |\n| `finalize` | after all implementation | runs in order, once, stops on first failure; check AGENTS.md for the real commands |\n| `live-verification` | after finalize, when the change has a runnable surface | offer at CP-3; one pass, no loop; skipping is fine, silent skipping is not |\n| `code-review` | on request only | never auto-triggers, never fixes; after finalize you may ask ONCE |\n| `root-cause-analysis` | any bug investigation | load when debugging starts, not proactively; investigation before fixes |\n| `plan-review` | plan\u002Fspec annotation in the browser | via ExitPlanMode\u002FStop hook, draft-plan's save step, or manually |\n| `technical-spec` | spec context + persistence (see below) | confirm before writing; never silently modify spec files |\n\n**Spec companion (`technical-spec`):** the router's step-2 lookup loads spec context\nsilently — no spec, no noise. `discovery` integrates it at sign-off (design doc always;\nstructured spec default-on, opt-out + live preview). `preflight` closes the loop — its\nDrift Check compares the implementation against the task's spec before finalize.\nWhenever a task **modifies** spec files\n(`specs\u002F`, OpenAPI YAMLs, contracts, field mappings), offer: \"Want the live spec\npreview open to review the changes?\"\n\n## Artifacts\n\nTwo tiers, split by durability — not by which skill produced them.\n\n| Tier | Where | Contents | Git |\n|---|---|---|---|\n| **Durable** | `\u003Cgit-root>\u002Fspecs\u002F` | tech specs (`technical-spec`), browsable via `spec-browser` | committed |\n| **Working state** | `\u003Cgit-root>\u002F.condux\u002F` | `designs\u002F` · `plans\u002F` · `progress\u002F` · `scratch\u002F` · `verification\u002F` (live-verification evidence) | gitignored |\n\nThe spec is what you keep; the design and plan are scaffolding for building\nit. Don't promote working state into `docs\u002F` or the repo root — a project's\n`docs\u002F` belongs to the project, not to condux.\n\n**Citation direction: durable content may not depend on ephemeral content.**\nA committed file may not cite a path inside `.condux\u002F` — that path is gone on\nany other machine and on any fresh clone, so the reference is dead for everyone\nbut its author. When a spec, a changelog entry or a backlog item needs to point\nat a design or a verification report, **promote it first**: copy that file into\nthe durable tree (the spec directory it belongs to) and cite the committed\npath. If the artifact no longer exists, say so and name what survives — a PR, a\ncommit — rather than a path that resolves nowhere. The split above says where\neach artifact *lives*; this says which direction a reference may point.\n\n**Bootstrap.** `.condux\u002F` is created on demand at the git root by the first\nskill that writes there. Before that first write, check it's ignored:\n\n```bash\ngit check-ignore -q .condux\u002F || echo \"not ignored\"\n```\n\nIf it isn't, offer once: \"condux keeps its working files in `.condux\u002F` — add\nit to `.gitignore` so they stay out of your commits?\" On yes, append\n`.condux\u002F` to the repo's `.gitignore`. If the user would rather not touch a\ntracked file, write it to `.git\u002Finfo\u002Fexclude` instead. Never edit either file\nwithout asking. Not a git repo → fall back to CWD and say so once.\n\n**Override.** A project can relocate either tier in `AGENTS.md`; an explicit\noverride always wins over these defaults.\n\n## Progress Ledger\n\nConversation memory does not survive compaction, and a plan file records intent,\nnot progress. Whoever implements a plan saved in `.condux\u002Fplans\u002F` — you inline,\nor `subagent-execution` — keeps one ledger beside it,\n`.condux\u002Fprogress\u002F\u003Cfeature-slug>.md` (the plan's file name minus its date and\nextension):\n\n```\n# Progress: \u003Cfeature-slug>\n\nPlan: .condux\u002Fplans\u002F\u003Cplan-file>.md\nBASE: \u003Csha7 of HEAD before Task 1>\n\n- [x] Task 1: \u003Cname> — commit \u003Csha7>\n- [x] preflight clean\n- [x] committed \u003Csha7>; PR #N open\n```\n\n- **Task lines** are appended after the task's commit, one per task, in the same\n  message as ticking the todo. A line names a real commit.\n- **Wrap-up lines** (no task number) are appended as each checkpoint step\n  finishes: `code-review`, `preflight`, `finalize`, live verification, then the\n  commit or PR line. A tool that reads the ledger — the `\u002Fcondux` board — turns\n  them into the pipeline's done and still-to-come steps.\n- **Start of work:** if a ledger exists, tasks ticked there are DONE; resume at\n  the first one that is not.\n- **No saved plan file, no ledger.** A SMALL task and a MEDIUM inline plan have\n  nothing for a ledger to key on; do not invent a plan file to get one.\n- The ledger is a recovery aid, not the source of truth: the commits it names\n  exist in git even when context no longer remembers them. `.condux\u002F` is\n  gitignored working state (see Artifacts), so never cite a ledger from a\n  committed file.\n\n## Agents\n\nFive **named specialist agents** ship with condux — never invent a generic subagent\nwith an injected prompt. (Another installed skill that mandates its own spawn type\nand ships the worker's contract, like deep-research, runs as written — see\n`subagent-execution`.) Implement yourself by default; spawn only with concrete\njustification (unfamiliar codebase, external API to verify, genuinely parallel\nexploration, or a LARGE plan via `subagent-execution`).\n\n- `explorer` — read-only codebase navigation (sonnet at low effort, non-blocking; LSP over grep).\n- `researcher` — external API\u002Flibrary verification (opus, non-blocking; resolves\n  the installed version first, omits what it can't verify).\n- `planner` — design → executable plan (sonnet; always delegates to explorer, and\n  researcher when external libs are involved, before planning).\n- `coder` — executes a provided plan only (sonnet; no exploration, no\n  typecheck\u002Flint\u002Ftest — that's finalize's job).\n- `scout` — one angle of a survey, dispatched only by `\u002Fcondux:research` (sonnet;\n  writes only its own notes file).\n\nPipeline: explorer\u002Fresearcher gather (non-blocking) → planner plans → coder executes\n→ finalize validates. Spawn mechanics, model tiering, and the parallel-safety\nchecklist live in `subagent-execution` and `subagent-deployment`.\n\n## Escalating Mid-Task\n\nScope turns out bigger than the confirmed tier? Stop immediately, report what you\nfound (\"this touches auth middleware, not just the UI\"), re-confirm the tier before\ncontinuing. Never silently expand scope.\n\n## Environment Hardening\n\nThe strategic track, fired by a trigger rather than run on every task. Two\ntriggers, both observed rather than imagined:\n\n- **Repeated friction.** The same obstacle cost time twice — twice in this\n  task, or once here and once earlier in the session.\n- **A workaround taken.** You bypassed a convention, widened a type, disabled a\n  rule, or special-cased around a design to make the change land. `preflight`'s\n  no-workarounds box catches the ones you stopped noticing.\n\nWhen one fires, spend a sentence on the cause rather than the symptom. Agents\nsucceed in a **pit of success** — an environment where the wrong thing is hard\nto express:\n\n| Lever | Looks like |\n|---|---|\n| Constrained surface | a narrower type, a smaller public API, an argument that cannot be passed wrong |\n| Rules that force correctness | a lint rule, a stricter compiler flag, a test that fails on the shape and not just the value |\n| Written convention | a line in `AGENTS.md` \u002F `CLAUDE.md` or the house-style skill, so a reviewer cites it instead of re-deriving it |\n| Data the agent lacks | dev-server or production logs, a test database, browser access to watch the thing actually render |\n\n**The output is a sentence to the user, or a backlog item — never a new\nartifact.** Name the hardening and let the user decide. If a backlog skill\n(`record`, or the repo's own convention) is installed and they want it kept,\nfile it there. Do not create a file for it, do not add a `.condux\u002F` directory\nfor it, and do not implement it inside the current task — that is scope\nexpansion, which Escalating Mid-Task already forbids.\n\n**Silence is the correct output when neither trigger fired.** A clean SMALL\ntask gets no hardening commentary at all.\n\n## Red Flags\n\nStop if you catch yourself doing any of these:\n\n| Doing | Instead |\n|---|---|\n| Skipping `\u002Fworkflow` because the task \"seems small\" | That judgment belongs to the router — run it first |\n| Loading every condux skill upfront | Let the tier flow pull each in at its step |\n| Discovery or a plan doc for a SMALL\u002FMEDIUM task | Implement directly; verify; finalize |\n| Tests \u002F lint \u002F typecheck mid-implementation | Save it all for `finalize` |\n| Spawning agents for a task you can just do | Default is to implement yourself |\n| Omitting the subagent options from a checkpoint menu | The default shapes the recommendation, never the menu — present every CP-1 row |\n| Merging or dropping rows to fit a four-option question tool | Four rows on buttons, the fifth named in the question text and taken through \"Other\" |\n| Silently skipping discovery on a LARGE task | Ask — it's a soft gate, not a free pass |\n| Rewriting a test spec to make it pass | Stop and ask — never silently edit specs |\n| Auto-running code-review, commits, or agents | They're checkpoint choices; run only when picked |\n| Verifying live without loading `live-verification` | Load it — its `report.md` is the evidence (9 of 11 ad-hoc runs in a mobile eval left none) |\n| Auto-advancing past a checkpoint on MEDIUM\u002FLARGE | The user owns every transition |\n| A checkpoint asked only through a non-blocking picker (Codex) | End the turn with the numbered menu in plain text — the picker disappears when the turn ends |\n| Absorbing a workaround silently so the change lands | Name it — that's a hardening trigger, and preflight asks for it anyway |\n| Expanding scope past the confirmed tier | Stop, report, re-confirm |\n\n## Tips\n\n1. Be specific: \"add export button to invoice table that calls exportInvoices\" →\n   SMALL. \"improve the invoice flow\" → clarify before a tier can be inferred.\n2. Override anytime: \"treat this as LARGE\" is always valid.\n3. Tests-first is opt-in: pick it at CP-1 or say so anytime.\n4. Review is separate: after `\u002Ffinalize`, run `\u002Fcode-review` if you want one.\n","# \u002Fworkflow\n\nPick the right tier, confirm it, execute. No over-engineering for a button change.\nNo under-planning for a cross-cutting feature.\n\n## Usage\n\n```\n\u002Fworkflow $ARGUMENTS\n```\n\n## Live Context\n\n```!\ngit status --short 2>\u002Fdev\u002Fnull || echo \"(not a git repository yet)\"\ngit log --oneline -5 2>\u002Fdev\u002Fnull || echo \"(no commits yet)\"\n```\n\n## Operating Rules\n\nCondux is **lean and proportional** — the opposite of \"always run every gate.\"\n\n1. **Proportional, not maximal.** Match the tier to the task. Don't discovery a\n   typo. Don't wing a cross-cutting refactor.\n2. **Lazy loading.** Never load `discovery`, `draft-plan`, `test-first-development`,\n   `subagent-execution`, or `finalize` upfront. Load a skill only when the tier flow\n   reaches the step that needs it.\n3. **Soft gates, not hard walls.** A gate (e.g. discovery before planning) can be\n   skipped — but only *consciously*. If a gate hasn't run, ask the user whether they\n   want to skip it; never silently bypass it.\n4. **The user is in control.** Condux shapes *how* you work, but explicit user\n   instructions (CLAUDE.md, AGENTS.md, direct requests) always win. \"Treat this as\n   LARGE\" or \"skip the plan\" is always valid.\n5. **Implement yourself by default.** Spawning agents is the exception — only\n   delegate with a concrete justification (see Agents below).\n6. **House style rides along.** Before the first line of code in any tier, load\n   the `coding-directive` skill if it is installed — skip silently when it\n   isn't. Codebase mimicry and repo config still win over the directive.\n7. **Two tracks, one of them triggered.** Tactical is the task in front of you.\n   Strategic is the environment that produced it — would a narrower type, a\n   lint rule, or a written convention have made this task's bug impossible?\n   The strategic track is *not* a standing obligation; that would violate rule\n   1. It fires on a trigger, and the triggers are in Environment Hardening.\n\n## Entry Contract\n\nEvery dev task starts with `\u002Fworkflow` — no exceptions unless the user says so.\n\n**Valid bypasses (explicit user instruction required):**\n- Mid-flow: \"I've already designed\u002Fplanned this\" → skip to the relevant step.\n- Explicit opt-out: \"skip workflow\", \"just do it\" → proceed, but note the skip.\n\n**Not valid bypasses:**\n- Your own judgment that the task \"seems small\" — tier inference is this skill's\n  job, not yours.\n- Being loaded as companion context alongside another skill — run `\u002Fworkflow`\n  first; the other skill executes within it, not instead of it.\n\n## Tiers\n\n| Tier | Looks like | Flow |\n|---|---|---|\n| **SMALL** | isolated change, 1–3 files, clear requirements (a button, a label, a prop, a typo) | implement → `\u002Fpreflight` → `\u002Ffinalize` |\n| **MEDIUM** | multi-file, some design needed, known boundaries (new form + API route, new procedure) | quick inline plan → implement → `\u002Fpreflight` → `\u002Ffinalize` |\n| **LARGE** | cross-cutting, unclear scope, multiple subsystems (new module, auth flow, data-model change) | `\u002Fdiscovery` → `\u002Fdraft-plan` → implement → `\u002Fpreflight` → `\u002Ffinalize` |\n\nEvery tier ends with `preflight` then `finalize` — no exceptions.\n\n## The Router\n\n1. **Infer the tier.** How many files? Requirement clear or needs design? Crosses\n   service\u002Fpackage boundaries? Unknowns needing exploration first? In a mobile\n   app, also: does it touch the native layer (finalize's native-change check\n   lists what does)? That doesn't change the tier — a one-line Kotlin fix is\n   still SMALL — but say so when confirming, because nothing can verify it\n   until the app is rebuilt and reinstalled.\n2. **Spec lookup.** Detect the package root (walk up from CWD to git root, find the\n   nearest `package.json` \u002F `Cargo.toml` \u002F `go.mod` \u002F `pyproject.toml`). Check both\n   scopes (deduplicate if identical):\n   `ls \u003Cpackage-root>\u002Fspecs\u002F 2>\u002Fdev\u002Fnull` and `ls \u003Cgit-root>\u002Fspecs\u002F 2>\u002Fdev\u002Fnull`.\n   Match the task subject to a spec dir (fuzzy kebab-case: \"checkout flow\" →\n   `specs\u002Fcheckout-flow`). If found, read `index.md`, then load by task type —\n   bug\u002Fdebug → `quirks.md`, `api.md`, `fields.md`; refactor → `implementation.md`,\n   `decisions.md`; new feature → `prd.md`, `decisions.md`, `api.md`, `fields.md`\n   (any of these the spec does not have is skipped silently). Carry this\n   context through; don't re-read mid-task. No spec → proceed without comment.\n3. **Confirm with the user.** State the inferred tier + a one-sentence reason. If a\n   spec was loaded, mention it and offer the companion: \"Found spec for\n   `checkout-flow` — loaded as context. Want the live HTML preview while we work?\n   [y\u002Fn]\" (if yes, load `technical-spec` and run its preview). Wait for explicit\n   confirmation before proceeding.\n4. **Execute the tier flow**, loading only the skills the tier needs, when needed.\n5. **Checkpoints (MEDIUM\u002FLARGE).** At each phase boundary, stop and present a\n   \"what next?\" menu (AskUserQuestion), recommended option first. The user drives\n   every transition — never auto-advance. SMALL runs linear with no menus.\n\n### Tier flows\n\n- **SMALL:** implement directly (no plan doc, no discovery) → `\u002Fpreflight` → `\u002Ffinalize`.\n- **MEDIUM:** short inline plan (same section shape as draft-plan, kept lean —\n  Overview · Files · Interfaces · Sketch where non-obvious · Edge cases) → CP-1 →\n  implement top-to-bottom → CP-2 → `\u002Fpreflight` → `\u002Ffinalize` → CP-3.\n- **LARGE:** load `discovery`, run fully to sign-off → load `draft-plan`, produce the\n  plan doc, sign-off → CP-1 → implement task by task, keeping the Progress Ledger\n  (`subagent-execution` if the user picks it) → CP-2 → `\u002Fpreflight` → `\u002Ffinalize` → CP-3.\n\n## Checkpoints\n\nAfter the user picks, load **only** that skill, run it, then return to the nearest\ncheckpoint and re-present the menu until the user chooses Done.\n\n**When the question tool caps the options.** CP-1 and CP-3 have five rows, and\nsome hosts' question tools take four (Claude Code's AskUserQuestion does). The\nfirst four rows go on buttons, recommended first. The fifth row rides in the\nfree-text slot the tool adds (\"Other\"), and the question text names it:\n\"Plan ready — how do we proceed? (or type 'revise' to rework the plan)\" for\nCP-1, \"(or say done)\" for CP-3. Never merge two rows into one button to make\nroom — \"Use agents\" for the two agent rows is exactly the erosion this rule\nprevents. A host with no cap, or a plain-text menu, shows every row.\n\n**When the question tool doesn't block.** Codex's `request_user_input` queues\nthe question beside the turn: the model keeps working, the host may answer it\non a timer (`autoResolutionMs`), and an unanswered question is dropped when the\nturn ends. Every checkpoint therefore ends the turn with the full menu as a\nnumbered plain-text list in the final message (the user replies with a number\nor a row name). The picker may be shown as well, but the final message is the\nmenu of record. Never treat a picker answer you didn't see the user give as\ntheir choice.\n\n### CP-1 — Plan ready\n\n*After draft-plan sign-off (LARGE) or the inline plan (MEDIUM). Plan review already\nhappened (or was declined) in draft-plan's own save step — don't re-offer it.*\n\n| Option | What it does |\n|---|---|\n| **Start implementing** *(recommended)* | Implement the plan top-to-bottom yourself |\n| **Write tests first** | Load `test-first-development`; one upfront consent, then test-first |\n| **Spawn specialist agents** | Load `subagent-execution`; execute the plan with named agents |\n| **Dispatch independent tasks in parallel** | Load `subagent-deployment`; fan out N independent tasks |\n| **Revise the plan** | Loop back to `draft-plan` with the new direction |\n\n**The menu is the full menu.** Present every row above, every time — including\nboth subagent options. Implement-yourself-by-default governs the\n*recommendation* marker, never which options appear: the user decides whether\nagents pay off, and an option they never see is a decision made for them. If\nplan sign-off and CP-1 get combined into one prompt (common in plan-approval\nUIs), the combined menu must still carry the full CP-1 option set.\n\n### CP-2 — Implementation done\n\n| Option | What it does |\n|---|---|\n| **Verify & finalize** *(recommended)* | Run `preflight`, then `finalize` |\n| **Code review first** | Load `code-review` on the diff before finalizing |\n| **Keep building** | More scope remains — re-confirm the tier if it grew |\n\n### CP-3 — Finalized and green\n\n| Option | What it does |\n|---|---|\n| **Verify it live** *(recommended when the change has a runnable surface — an app on an emulator counts)* | Load the `live-verification` skill and follow it — including on a mobile app: drive the real UI, endpoint or emulator, check each claim against observed behaviour, and write its report |\n| **Code review** *(recommended)* | `\u002Fcode-review` the diff before merging |\n| **Commit** | Load the `git-commit` skill if installed (conventional message from the diff, safe staging); otherwise follow the repo's commit conventions |\n| **Cut a release** | Load the `release` skill if installed — machinery detection, dry-run plan, then tag → push → GitHub release; otherwise follow the repo's release conventions |\n| **Done** | Stop here |\n\n## Skills and Gates\n\nLoad each only when its step is reached.\n\n| Skill | When | Gate discipline |\n|---|---|---|\n| `discovery` | LARGE, before planning, or scope unclear | soft gate — ask before skipping |\n| `blueprint` | discovery's propose step, or a standalone mockup\u002Fvisualization ask | load only when a UI surface or data model is in play; structure, never styling |\n| `draft-plan` | LARGE, after discovery sign-off | needs a signed-off design; no design → apply the discovery soft gate first |\n| `test-first-development` | user asks, or picks it at CP-1 | one upfront consent; always ask before editing an existing test spec |\n| `subagent-execution` | LARGE plan where specialization\u002Fparallelism pays off | default is implement yourself; keeps the Progress Ledger |\n| `subagent-deployment` | 2+ independent tasks, no shared files\u002Fdeps | ad-hoc work, not ordered plans |\n| `preflight` | end of every tier, before finalize | automatic on SMALL; recommended CP-2 choice |\n| `finalize` | after all implementation | runs in order, once, stops on first failure; check AGENTS.md for the real commands |\n| `live-verification` | after finalize, when the change has a runnable surface | offer at CP-3; one pass, no loop; skipping is fine, silent skipping is not |\n| `code-review` | on request only | never auto-triggers, never fixes; after finalize you may ask ONCE |\n| `root-cause-analysis` | any bug investigation | load when debugging starts, not proactively; investigation before fixes |\n| `plan-review` | plan\u002Fspec annotation in the browser | via ExitPlanMode\u002FStop hook, draft-plan's save step, or manually |\n| `technical-spec` | spec context + persistence (see below) | confirm before writing; never silently modify spec files |\n\n**Spec companion (`technical-spec`):** the router's step-2 lookup loads spec context\nsilently — no spec, no noise. `discovery` integrates it at sign-off (design doc always;\nstructured spec default-on, opt-out + live preview). `preflight` closes the loop — its\nDrift Check compares the implementation against the task's spec before finalize.\nWhenever a task **modifies** spec files\n(`specs\u002F`, OpenAPI YAMLs, contracts, field mappings), offer: \"Want the live spec\npreview open to review the changes?\"\n\n## Artifacts\n\nTwo tiers, split by durability — not by which skill produced them.\n\n| Tier | Where | Contents | Git |\n|---|---|---|---|\n| **Durable** | `\u003Cgit-root>\u002Fspecs\u002F` | tech specs (`technical-spec`), browsable via `spec-browser` | committed |\n| **Working state** | `\u003Cgit-root>\u002F.condux\u002F` | `designs\u002F` · `plans\u002F` · `progress\u002F` · `scratch\u002F` · `verification\u002F` (live-verification evidence) | gitignored |\n\nThe spec is what you keep; the design and plan are scaffolding for building\nit. Don't promote working state into `docs\u002F` or the repo root — a project's\n`docs\u002F` belongs to the project, not to condux.\n\n**Citation direction: durable content may not depend on ephemeral content.**\nA committed file may not cite a path inside `.condux\u002F` — that path is gone on\nany other machine and on any fresh clone, so the reference is dead for everyone\nbut its author. When a spec, a changelog entry or a backlog item needs to point\nat a design or a verification report, **promote it first**: copy that file into\nthe durable tree (the spec directory it belongs to) and cite the committed\npath. If the artifact no longer exists, say so and name what survives — a PR, a\ncommit — rather than a path that resolves nowhere. The split above says where\neach artifact *lives*; this says which direction a reference may point.\n\n**Bootstrap.** `.condux\u002F` is created on demand at the git root by the first\nskill that writes there. Before that first write, check it's ignored:\n\n```bash\ngit check-ignore -q .condux\u002F || echo \"not ignored\"\n```\n\nIf it isn't, offer once: \"condux keeps its working files in `.condux\u002F` — add\nit to `.gitignore` so they stay out of your commits?\" On yes, append\n`.condux\u002F` to the repo's `.gitignore`. If the user would rather not touch a\ntracked file, write it to `.git\u002Finfo\u002Fexclude` instead. Never edit either file\nwithout asking. Not a git repo → fall back to CWD and say so once.\n\n**Override.** A project can relocate either tier in `AGENTS.md`; an explicit\noverride always wins over these defaults.\n\n## Progress Ledger\n\nConversation memory does not survive compaction, and a plan file records intent,\nnot progress. Whoever implements a plan saved in `.condux\u002Fplans\u002F` — you inline,\nor `subagent-execution` — keeps one ledger beside it,\n`.condux\u002Fprogress\u002F\u003Cfeature-slug>.md` (the plan's file name minus its date and\nextension):\n\n```\n# Progress: \u003Cfeature-slug>\n\nPlan: .condux\u002Fplans\u002F\u003Cplan-file>.md\nBASE: \u003Csha7 of HEAD before Task 1>\n\n- [x] Task 1: \u003Cname> — commit \u003Csha7>\n- [x] preflight clean\n- [x] committed \u003Csha7>; PR #N open\n```\n\n- **Task lines** are appended after the task's commit, one per task, in the same\n  message as ticking the todo. A line names a real commit.\n- **Wrap-up lines** (no task number) are appended as each checkpoint step\n  finishes: `code-review`, `preflight`, `finalize`, live verification, then the\n  commit or PR line. A tool that reads the ledger — the `\u002Fcondux` board — turns\n  them into the pipeline's done and still-to-come steps.\n- **Start of work:** if a ledger exists, tasks ticked there are DONE; resume at\n  the first one that is not.\n- **No saved plan file, no ledger.** A SMALL task and a MEDIUM inline plan have\n  nothing for a ledger to key on; do not invent a plan file to get one.\n- The ledger is a recovery aid, not the source of truth: the commits it names\n  exist in git even when context no longer remembers them. `.condux\u002F` is\n  gitignored working state (see Artifacts), so never cite a ledger from a\n  committed file.\n\n## Agents\n\nFive **named specialist agents** ship with condux — never invent a generic subagent\nwith an injected prompt. (Another installed skill that mandates its own spawn type\nand ships the worker's contract, like deep-research, runs as written — see\n`subagent-execution`.) Implement yourself by default; spawn only with concrete\njustification (unfamiliar codebase, external API to verify, genuinely parallel\nexploration, or a LARGE plan via `subagent-execution`).\n\n- `explorer` — read-only codebase navigation (sonnet at low effort, non-blocking; LSP over grep).\n- `researcher` — external API\u002Flibrary verification (opus, non-blocking; resolves\n  the installed version first, omits what it can't verify).\n- `planner` — design → executable plan (sonnet; always delegates to explorer, and\n  researcher when external libs are involved, before planning).\n- `coder` — executes a provided plan only (sonnet; no exploration, no\n  typecheck\u002Flint\u002Ftest — that's finalize's job).\n- `scout` — one angle of a survey, dispatched only by `\u002Fcondux:research` (sonnet;\n  writes only its own notes file).\n\nPipeline: explorer\u002Fresearcher gather (non-blocking) → planner plans → coder executes\n→ finalize validates. Spawn mechanics, model tiering, and the parallel-safety\nchecklist live in `subagent-execution` and `subagent-deployment`.\n\n## Escalating Mid-Task\n\nScope turns out bigger than the confirmed tier? Stop immediately, report what you\nfound (\"this touches auth middleware, not just the UI\"), re-confirm the tier before\ncontinuing. Never silently expand scope.\n\n## Environment Hardening\n\nThe strategic track, fired by a trigger rather than run on every task. Two\ntriggers, both observed rather than imagined:\n\n- **Repeated friction.** The same obstacle cost time twice — twice in this\n  task, or once here and once earlier in the session.\n- **A workaround taken.** You bypassed a convention, widened a type, disabled a\n  rule, or special-cased around a design to make the change land. `preflight`'s\n  no-workarounds box catches the ones you stopped noticing.\n\nWhen one fires, spend a sentence on the cause rather than the symptom. Agents\nsucceed in a **pit of success** — an environment where the wrong thing is hard\nto express:\n\n| Lever | Looks like |\n|---|---|\n| Constrained surface | a narrower type, a smaller public API, an argument that cannot be passed wrong |\n| Rules that force correctness | a lint rule, a stricter compiler flag, a test that fails on the shape and not just the value |\n| Written convention | a line in `AGENTS.md` \u002F `CLAUDE.md` or the house-style skill, so a reviewer cites it instead of re-deriving it |\n| Data the agent lacks | dev-server or production logs, a test database, browser access to watch the thing actually render |\n\n**The output is a sentence to the user, or a backlog item — never a new\nartifact.** Name the hardening and let the user decide. If a backlog skill\n(`record`, or the repo's own convention) is installed and they want it kept,\nfile it there. Do not create a file for it, do not add a `.condux\u002F` directory\nfor it, and do not implement it inside the current task — that is scope\nexpansion, which Escalating Mid-Task already forbids.\n\n**Silence is the correct output when neither trigger fired.** A clean SMALL\ntask gets no hardening commentary at all.\n\n## Red Flags\n\nStop if you catch yourself doing any of these:\n\n| Doing | Instead |\n|---|---|\n| Skipping `\u002Fworkflow` because the task \"seems small\" | That judgment belongs to the router — run it first |\n| Loading every condux skill upfront | Let the tier flow pull each in at its step |\n| Discovery or a plan doc for a SMALL\u002FMEDIUM task | Implement directly; verify; finalize |\n| Tests \u002F lint \u002F typecheck mid-implementation | Save it all for `finalize` |\n| Spawning agents for a task you can just do | Default is to implement yourself |\n| Omitting the subagent options from a checkpoint menu | The default shapes the recommendation, never the menu — present every CP-1 row |\n| Merging or dropping rows to fit a four-option question tool | Four rows on buttons, the fifth named in the question text and taken through \"Other\" |\n| Silently skipping discovery on a LARGE task | Ask — it's a soft gate, not a free pass |\n| Rewriting a test spec to make it pass | Stop and ask — never silently edit specs |\n| Auto-running code-review, commits, or agents | They're checkpoint choices; run only when picked |\n| Verifying live without loading `live-verification` | Load it — its `report.md` is the evidence (9 of 11 ad-hoc runs in a mobile eval left none) |\n| Auto-advancing past a checkpoint on MEDIUM\u002FLARGE | The user owns every transition |\n| A checkpoint asked only through a non-blocking picker (Codex) | End the turn with the numbered menu in plain text — the picker disappears when the turn ends |\n| Absorbing a workaround silently so the change lands | Name it — that's a hardening trigger, and preflight asks for it anyway |\n| Expanding scope past the confirmed tier | Stop, report, re-confirm |\n\n## Tips\n\n1. Be specific: \"add export button to invoice table that calls exportInvoices\" →\n   SMALL. \"improve the invoice flow\" → clarify before a tier can be inferred.\n2. Override anytime: \"treat this as LARGE\" is always valid.\n3. Tests-first is opt-in: pick it at CP-1 or say so anytime.\n4. Review is separate: after `\u002Ffinalize`, run `\u002Fcode-review` if you want one.\n",{"name":5,"description":7,"when_to_use":24,"argument-hint":25},"Trigger with any dev task, however small or mundane — feature, bug fix, refactor, new endpoint, UI change, adding tests, CI and tooling config, docs and README edits, a one-line tweak. Every task starts here regardless of size (the tier decides the ceremony), including requests to start or prep a task, like loading its spec before beginning. Other skills execute within \u002Fworkflow, not instead of it. Also the operating manual — how condux works: tiers, soft gates, checkpoints, named agents.","\u003Ctask description>","main","5277649b071c1c0cdf4f15eee861b1608fc1bbcb","skills\u002Fworkflow",0,"https:\u002F\u002Fgithub.com\u002Fjabworks\u002Fagentic-toolkit","https:\u002F\u002Fgithub.com\u002Fjabworks","2026-11-03 15:03:51",{"source":8,"skillName":5,"commands":34,"prompt":44,"zipAvailable":45},[35,38,41],{"tool":36,"command":37},"npx","npx skills add jabworks\u002Fagentic-toolkit --skill workflow",{"tool":39,"command":40},"bunx","bunx skills add jabworks\u002Fagentic-toolkit --skill workflow",{"tool":42,"command":43},"pnpm","pnpm dlx skills add jabworks\u002Fagentic-toolkit --skill workflow","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fjabworks\u002Fagentic-toolkit\u002Fblob\u002Fmain\u002Fskills\u002Fworkflow\u002FSKILL.md",true,[47,53,57,61,67,73,77,81,85,89,93,97,101,105,109,113,117,121,125,129,133,137,141,145,149,153,157,161,165,169,173],{"path":48,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":51,"sourceHtmlUrl":52},"evals\u002Ftrigger_eval.json","REFERENCE","参考文档",3035,"https:\u002F\u002Fgithub.com\u002Fjabworks\u002Fagentic-toolkit\u002Fblob\u002Fmain\u002Fskills\u002Fworkflow\u002Fevals\u002Ftrigger_eval.json",{"path":54,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":55,"sourceHtmlUrl":56},"hooks\u002Fcodex-hooks.json",672,"https:\u002F\u002Fgithub.com\u002Fjabworks\u002Fagentic-toolkit\u002Fblob\u002Fmain\u002Fskills\u002Fworkflow\u002Fhooks\u002Fcodex-hooks.json",{"path":58,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":59,"sourceHtmlUrl":60},"hooks\u002Fhooks.json",389,"https:\u002F\u002Fgithub.com\u002Fjabworks\u002Fagentic-toolkit\u002Fblob\u002Fmain\u002Fskills\u002Fworkflow\u002Fhooks\u002Fhooks.json",{"path":62,"resourceType":63,"resourceTypeDesc":64,"sizeBytes":65,"sourceHtmlUrl":66},"hooks\u002Fmod\u002Fboard\u002Fbadges.ts","SCRIPT","脚本",910,"https:\u002F\u002Fgithub.com\u002Fjabworks\u002Fagentic-toolkit\u002Fblob\u002Fmain\u002Fskills\u002Fworkflow\u002Fhooks\u002Fmod\u002Fboard\u002Fbadges.ts",{"path":68,"resourceType":69,"resourceTypeDesc":70,"sizeBytes":71,"sourceHtmlUrl":72},"hooks\u002Fmod\u002Fboard\u002Fboard.tsx","OTHER","其他",26796,"https:\u002F\u002Fgithub.com\u002Fjabworks\u002Fagentic-toolkit\u002Fblob\u002Fmain\u002Fskills\u002Fworkflow\u002Fhooks\u002Fmod\u002Fboard\u002Fboard.tsx",{"path":74,"resourceType":63,"resourceTypeDesc":64,"sizeBytes":75,"sourceHtmlUrl":76},"hooks\u002Fmod\u002Fboard\u002Fgraph.ts",6762,"https:\u002F\u002Fgithub.com\u002Fjabworks\u002Fagentic-toolkit\u002Fblob\u002Fmain\u002Fskills\u002Fworkflow\u002Fhooks\u002Fmod\u002Fboard\u002Fgraph.ts",{"path":78,"resourceType":63,"resourceTypeDesc":64,"sizeBytes":79,"sourceHtmlUrl":80},"hooks\u002Fmod\u002Fboard\u002Fparse-ledger.ts",1706,"https:\u002F\u002Fgithub.com\u002Fjabworks\u002Fagentic-toolkit\u002Fblob\u002Fmain\u002Fskills\u002Fworkflow\u002Fhooks\u002Fmod\u002Fboard\u002Fparse-ledger.ts",{"path":82,"resourceType":63,"resourceTypeDesc":64,"sizeBytes":83,"sourceHtmlUrl":84},"hooks\u002Fmod\u002Fboard\u002Fparse-plan.ts",4421,"https:\u002F\u002Fgithub.com\u002Fjabworks\u002Fagentic-toolkit\u002Fblob\u002Fmain\u002Fskills\u002Fworkflow\u002Fhooks\u002Fmod\u002Fboard\u002Fparse-plan.ts",{"path":86,"resourceType":63,"resourceTypeDesc":64,"sizeBytes":87,"sourceHtmlUrl":88},"hooks\u002Fmod\u002Fboard\u002Fstate.ts",6028,"https:\u002F\u002Fgithub.com\u002Fjabworks\u002Fagentic-toolkit\u002Fblob\u002Fmain\u002Fskills\u002Fworkflow\u002Fhooks\u002Fmod\u002Fboard\u002Fstate.ts",{"path":90,"resourceType":63,"resourceTypeDesc":64,"sizeBytes":91,"sourceHtmlUrl":92},"hooks\u002Fmod\u002Fboard\u002Fstepper.ts",1428,"https:\u002F\u002Fgithub.com\u002Fjabworks\u002Fagentic-toolkit\u002Fblob\u002Fmain\u002Fskills\u002Fworkflow\u002Fhooks\u002Fmod\u002Fboard\u002Fstepper.ts",{"path":94,"resourceType":63,"resourceTypeDesc":64,"sizeBytes":95,"sourceHtmlUrl":96},"hooks\u002Fmod\u002Fboard\u002Ftext.ts",7281,"https:\u002F\u002Fgithub.com\u002Fjabworks\u002Fagentic-toolkit\u002Fblob\u002Fmain\u002Fskills\u002Fworkflow\u002Fhooks\u002Fmod\u002Fboard\u002Ftext.ts",{"path":98,"resourceType":63,"resourceTypeDesc":64,"sizeBytes":99,"sourceHtmlUrl":100},"hooks\u002Fmod\u002Fkit\u002Fcharts.ts",6221,"https:\u002F\u002Fgithub.com\u002Fjabworks\u002Fagentic-toolkit\u002Fblob\u002Fmain\u002Fskills\u002Fworkflow\u002Fhooks\u002Fmod\u002Fkit\u002Fcharts.ts",{"path":102,"resourceType":63,"resourceTypeDesc":64,"sizeBytes":103,"sourceHtmlUrl":104},"hooks\u002Fmod\u002Fkit\u002Flocate.ts",881,"https:\u002F\u002Fgithub.com\u002Fjabworks\u002Fagentic-toolkit\u002Fblob\u002Fmain\u002Fskills\u002Fworkflow\u002Fhooks\u002Fmod\u002Fkit\u002Flocate.ts",{"path":106,"resourceType":63,"resourceTypeDesc":64,"sizeBytes":107,"sourceHtmlUrl":108},"hooks\u002Fmod\u002Fkit\u002Fpaths.ts",1675,"https:\u002F\u002Fgithub.com\u002Fjabworks\u002Fagentic-toolkit\u002Fblob\u002Fmain\u002Fskills\u002Fworkflow\u002Fhooks\u002Fmod\u002Fkit\u002Fpaths.ts",{"path":110,"resourceType":69,"resourceTypeDesc":70,"sizeBytes":111,"sourceHtmlUrl":112},"hooks\u002Fmod\u002Fregister.tsx",935,"https:\u002F\u002Fgithub.com\u002Fjabworks\u002Fagentic-toolkit\u002Fblob\u002Fmain\u002Fskills\u002Fworkflow\u002Fhooks\u002Fmod\u002Fregister.tsx",{"path":114,"resourceType":69,"resourceTypeDesc":70,"sizeBytes":115,"sourceHtmlUrl":116},"hooks\u002Fmod\u002Ftests\u002Fautoopen.test.tsx",2916,"https:\u002F\u002Fgithub.com\u002Fjabworks\u002Fagentic-toolkit\u002Fblob\u002Fmain\u002Fskills\u002Fworkflow\u002Fhooks\u002Fmod\u002Ftests\u002Fautoopen.test.tsx",{"path":118,"resourceType":69,"resourceTypeDesc":70,"sizeBytes":119,"sourceHtmlUrl":120},"hooks\u002Fmod\u002Ftests\u002Fboard.test.tsx",7811,"https:\u002F\u002Fgithub.com\u002Fjabworks\u002Fagentic-toolkit\u002Fblob\u002Fmain\u002Fskills\u002Fworkflow\u002Fhooks\u002Fmod\u002Ftests\u002Fboard.test.tsx",{"path":122,"resourceType":69,"resourceTypeDesc":70,"sizeBytes":123,"sourceHtmlUrl":124},"hooks\u002Fmod\u002Ftests\u002Fcapped.test.tsx",2949,"https:\u002F\u002Fgithub.com\u002Fjabworks\u002Fagentic-toolkit\u002Fblob\u002Fmain\u002Fskills\u002Fworkflow\u002Fhooks\u002Fmod\u002Ftests\u002Fcapped.test.tsx",{"path":126,"resourceType":69,"resourceTypeDesc":70,"sizeBytes":127,"sourceHtmlUrl":128},"hooks\u002Fmod\u002Ftests\u002Fchrome-pane.test.tsx",5969,"https:\u002F\u002Fgithub.com\u002Fjabworks\u002Fagentic-toolkit\u002Fblob\u002Fmain\u002Fskills\u002Fworkflow\u002Fhooks\u002Fmod\u002Ftests\u002Fchrome-pane.test.tsx",{"path":130,"resourceType":69,"resourceTypeDesc":70,"sizeBytes":131,"sourceHtmlUrl":132},"hooks\u002Fmod\u002Ftests\u002Fchrome.test.tsx",5769,"https:\u002F\u002Fgithub.com\u002Fjabworks\u002Fagentic-toolkit\u002Fblob\u002Fmain\u002Fskills\u002Fworkflow\u002Fhooks\u002Fmod\u002Ftests\u002Fchrome.test.tsx",{"path":134,"resourceType":63,"resourceTypeDesc":64,"sizeBytes":135,"sourceHtmlUrl":136},"hooks\u002Fmod\u002Ftests\u002Ffixtures.ts",5162,"https:\u002F\u002Fgithub.com\u002Fjabworks\u002Fagentic-toolkit\u002Fblob\u002Fmain\u002Fskills\u002Fworkflow\u002Fhooks\u002Fmod\u002Ftests\u002Ffixtures.ts",{"path":138,"resourceType":69,"resourceTypeDesc":70,"sizeBytes":139,"sourceHtmlUrl":140},"hooks\u002Fmod\u002Ftests\u002Fharness.tsx",5678,"https:\u002F\u002Fgithub.com\u002Fjabworks\u002Fagentic-toolkit\u002Fblob\u002Fmain\u002Fskills\u002Fworkflow\u002Fhooks\u002Fmod\u002Ftests\u002Fharness.tsx",{"path":142,"resourceType":69,"resourceTypeDesc":70,"sizeBytes":143,"sourceHtmlUrl":144},"hooks\u002Fmod\u002Ftests\u002Fparse-ledger.test.tsx",3416,"https:\u002F\u002Fgithub.com\u002Fjabworks\u002Fagentic-toolkit\u002Fblob\u002Fmain\u002Fskills\u002Fworkflow\u002Fhooks\u002Fmod\u002Ftests\u002Fparse-ledger.test.tsx",{"path":146,"resourceType":69,"resourceTypeDesc":70,"sizeBytes":147,"sourceHtmlUrl":148},"hooks\u002Fmod\u002Ftests\u002Fparse-plan.test.tsx",3857,"https:\u002F\u002Fgithub.com\u002Fjabworks\u002Fagentic-toolkit\u002Fblob\u002Fmain\u002Fskills\u002Fworkflow\u002Fhooks\u002Fmod\u002Ftests\u002Fparse-plan.test.tsx",{"path":150,"resourceType":69,"resourceTypeDesc":70,"sizeBytes":151,"sourceHtmlUrl":152},"hooks\u002Fmod\u002Ftests\u002Fregister.test.tsx",597,"https:\u002F\u002Fgithub.com\u002Fjabworks\u002Fagentic-toolkit\u002Fblob\u002Fmain\u002Fskills\u002Fworkflow\u002Fhooks\u002Fmod\u002Ftests\u002Fregister.test.tsx",{"path":154,"resourceType":69,"resourceTypeDesc":70,"sizeBytes":155,"sourceHtmlUrl":156},"hooks\u002Fmod\u002Ftests\u002Fstate.test.tsx",9477,"https:\u002F\u002Fgithub.com\u002Fjabworks\u002Fagentic-toolkit\u002Fblob\u002Fmain\u002Fskills\u002Fworkflow\u002Fhooks\u002Fmod\u002Ftests\u002Fstate.test.tsx",{"path":158,"resourceType":69,"resourceTypeDesc":70,"sizeBytes":159,"sourceHtmlUrl":160},"hooks\u002Fmod\u002Ftests\u002Fstatus.test.tsx",4197,"https:\u002F\u002Fgithub.com\u002Fjabworks\u002Fagentic-toolkit\u002Fblob\u002Fmain\u002Fskills\u002Fworkflow\u002Fhooks\u002Fmod\u002Ftests\u002Fstatus.test.tsx",{"path":162,"resourceType":69,"resourceTypeDesc":70,"sizeBytes":163,"sourceHtmlUrl":164},"hooks\u002Fmod\u002Ftests\u002Ftext.test.tsx",2734,"https:\u002F\u002Fgithub.com\u002Fjabworks\u002Fagentic-toolkit\u002Fblob\u002Fmain\u002Fskills\u002Fworkflow\u002Fhooks\u002Fmod\u002Ftests\u002Ftext.test.tsx",{"path":166,"resourceType":63,"resourceTypeDesc":64,"sizeBytes":167,"sourceHtmlUrl":168},"hooks\u002Fmod\u002Ftypes\u002Findex.d.ts",4522,"https:\u002F\u002Fgithub.com\u002Fjabworks\u002Fagentic-toolkit\u002Fblob\u002Fmain\u002Fskills\u002Fworkflow\u002Fhooks\u002Fmod\u002Ftypes\u002Findex.d.ts",{"path":170,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":171,"sourceHtmlUrl":172},"hooks\u002Frouting.md",1678,"https:\u002F\u002Fgithub.com\u002Fjabworks\u002Fagentic-toolkit\u002Fblob\u002Fmain\u002Fskills\u002Fworkflow\u002Fhooks\u002Frouting.md",{"path":174,"resourceType":63,"resourceTypeDesc":64,"sizeBytes":175,"sourceHtmlUrl":176},"hooks\u002Fsession-start.mjs",2230,"https:\u002F\u002Fgithub.com\u002Fjabworks\u002Fagentic-toolkit\u002Fblob\u002Fmain\u002Fskills\u002Fworkflow\u002Fhooks\u002Fsession-start.mjs",[178,184,190,197,204,211],{"skillNo":179,"name":180,"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":181,"categories":182,"keywords":183,"publishedAt":19},"01M7540BPNTFZH7V41P5E2S692","orphan","https:\u002F\u002Fgithub.com\u002Fjabworks\u002Fagentic-toolkit\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fcomposition\u002Fbad\u002Fskills\u002Forphan\u002FSKILL.md",[],[],{"skillNo":185,"name":186,"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":187,"categories":188,"keywords":189,"publishedAt":19},"01M7540AG2KFTQ8DJMNV6806MV","no-blurb","https:\u002F\u002Fgithub.com\u002Fjabworks\u002Fagentic-toolkit\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fcomposition\u002Fbad\u002Fskills\u002Fno-blurb\u002FSKILL.md",[],[],{"skillNo":191,"name":192,"nameZh":6,"description":193,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":194,"categories":195,"keywords":196,"publishedAt":19},"01M753ZZ6TTA06GRJAG679BQ2H","usage-trace","Checks and manages durable, local usage capture — ingest, health status, and the opt-in limit snapshot — for Claude Code and Codex. Capture itself runs automatically at session start.","https:\u002F\u002Fgithub.com\u002Fjabworks\u002Fagentic-toolkit\u002Fblob\u002Fmain\u002Fskills\u002Fusage-trace\u002FSKILL.md",[],[],{"skillNo":198,"name":199,"nameZh":6,"description":200,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":201,"categories":202,"keywords":203,"publishedAt":19},"01M753ZSKJSF8WFS7AXR2N65SE","toolkit-skill-standards","Use when writing or reviewing a SKILL.md for jabworks\u002Fagentic-toolkit — frontmatter budgets, the trigger contract (\"Use when…\" description or when_to_use field), progressive disclosure into references\u002F, and keeping a new description out of existing skills' trigger space. Triggers include \"review this skill description\", \"write the frontmatter\", \"does this collide with an existing skill\", \"where should this content live\". Not for scaffold\u002Fsync mechanics; use toolkit-foundry.","https:\u002F\u002Fgithub.com\u002Fjabworks\u002Fagentic-toolkit\u002Fblob\u002Fmain\u002Fskills\u002Ftoolkit-skill-standards\u002FSKILL.md",[],[],{"skillNo":205,"name":206,"nameZh":6,"description":207,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":208,"categories":209,"keywords":210,"publishedAt":19},"01M753ZKX3KTVYWX15A9A0WZN0","toolkit-research-frontier","Use when planning improvement work on jabworks\u002Fagentic-toolkit itself — open problems (trigger-collision automation, YAML-strict frontmatter checks, docs-catalog enforcement), existing assets, the next three concrete steps, and the four-front library-health campaign with commands and success criteria. Triggers include \"let's improve our toolkit\", \"let's improve this repo\", \"what should we improve next\", \"toolkit roadmap\", \"open problems\", \"run the health campaign\".","https:\u002F\u002Fgithub.com\u002Fjabworks\u002Fagentic-toolkit\u002Fblob\u002Fmain\u002Fskills\u002Ftoolkit-research-frontier\u002FSKILL.md",[],[],{"skillNo":212,"name":213,"nameZh":6,"description":214,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":215,"categories":216,"keywords":217,"publishedAt":19},"01M753ZCAH03BTJ33V2A4M6KDZ","toolkit-plugin-reference","Use when writing or editing plugin.json, marketplace.json, or package manifests in jabworks\u002Fagentic-toolkit and the exact schema matters — required fields, the .claude-plugin\u002F.codex-plugin pairing and where it diverges (interface, hooks), the skills-path form, how the four install channels consume the repo, and which SKILL.md frontmatter fields are real. Triggers include \"what fields does plugin.json need\", \"claude vs codex manifest\", \"marketplace entry format\", \"how opencode loads skills\".","https:\u002F\u002Fgithub.com\u002Fjabworks\u002Fagentic-toolkit\u002Fblob\u002Fmain\u002Fskills\u002Ftoolkit-plugin-reference\u002FSKILL.md",[],[]]