@1aboveio/skills 1.0.7 → 1.0.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (75) hide show
  1. package/package.json +2 -2
  2. package/skills/app-dev/airflow/SKILL.md +1 -1
  3. package/skills/app-dev/android-foundation/SKILL.md +92 -34
  4. package/skills/app-dev/android-foundation/assets/android-ci-job.yml +13 -7
  5. package/skills/app-dev/android-foundation/references/ci.md +23 -13
  6. package/skills/app-dev/android-foundation/references/delivery-focus.md +29 -0
  7. package/skills/app-dev/android-foundation/references/diagnosis.md +136 -0
  8. package/skills/app-dev/android-foundation/references/gotchas.md +20 -11
  9. package/skills/app-dev/android-foundation/references/setup.md +15 -6
  10. package/skills/app-dev/android-foundation/scripts/device-run.sh +148 -42
  11. package/skills/app-dev/android-foundation/scripts/device-run.test.mjs +322 -58
  12. package/skills/app-dev/app-debug/SKILL.md +1 -1
  13. package/skills/app-dev/better-auth/SKILL.md +1 -1
  14. package/skills/app-dev/data-catalog/SKILL.md +1 -1
  15. package/skills/app-dev/data-quality/SKILL.md +1 -1
  16. package/skills/app-dev/ios-foundation/SKILL.md +1 -1
  17. package/skills/app-dev/monorepo/SKILL.md +1 -1
  18. package/skills/app-dev/nextjs-fullstack/SKILL.md +1 -1
  19. package/skills/app-dev/prisma-setup/SKILL.md +1 -1
  20. package/skills/app-dev/pyspark/SKILL.md +1 -1
  21. package/skills/app-dev/python-backend/SKILL.md +1 -1
  22. package/skills/app-dev/shadcn/SKILL.md +1 -1
  23. package/skills/app-dev/zod-v4/SKILL.md +1 -1
  24. package/skills/cicd/cloud-build/SKILL.md +1 -1
  25. package/skills/cicd/cloud-debug/SKILL.md +1 -1
  26. package/skills/cicd/cloud-deploy/SKILL.md +1 -1
  27. package/skills/cicd/docker/SKILL.md +1 -1
  28. package/skills/cicd/github-actions/SKILL.md +1 -1
  29. package/skills/cicd/github-flow/SKILL.md +1 -1
  30. package/skills/cicd/google-cloud/SKILL.md +1 -1
  31. package/skills/cicd/mergify/SKILL.md +1 -1
  32. package/skills/cicd/podman/SKILL.md +1 -1
  33. package/skills/content/article-review/SKILL.md +1 -1
  34. package/skills/content/article-to-image/SKILL.md +1 -1
  35. package/skills/content/flowchart-svg/SKILL.md +1 -1
  36. package/skills/content/image-gen/SKILL.md +1 -1
  37. package/skills/content/mermaid/SKILL.md +1 -1
  38. package/skills/content/wechat-article-writer/SKILL.md +1 -1
  39. package/skills/content/wechat-publisher/SKILL.md +1 -1
  40. package/skills/content/wechat-search/SKILL.md +1 -1
  41. package/skills/content/xai-search/SKILL.md +1 -1
  42. package/skills/core/distill-writing/SKILL.md +1 -1
  43. package/skills/core/doc-to-md/SKILL.md +1 -1
  44. package/skills/core/editorial-review/SKILL.md +1 -1
  45. package/skills/core/house-style/SKILL.md +1 -1
  46. package/skills/core/plain-language/SKILL.md +1 -1
  47. package/skills/core/polish-cn/SKILL.md +1 -1
  48. package/skills/core/reg-parser/SKILL.md +1 -1
  49. package/skills/core/terminology/SKILL.md +1 -1
  50. package/skills/core/write-doc/SKILL.md +1 -1
  51. package/skills/engineering/better-review/SKILL.md +1 -1
  52. package/skills/engineering/contributing/SKILL.md +1 -1
  53. package/skills/engineering/e2e-test/SKILL.md +1 -1
  54. package/skills/engineering/engineering-runtime/SKILL.md +1 -1
  55. package/skills/engineering/engineering-runtime/coherence/workflow.json +13 -13
  56. package/skills/engineering/ensure-coverage/SKILL.md +1 -1
  57. package/skills/engineering/golden-path/SKILL.md +1 -1
  58. package/skills/engineering/harness-runtime/SKILL.md +1 -1
  59. package/skills/engineering/resolve-issues/SKILL.md +11 -20
  60. package/skills/engineering/resolve-issues/references/delivery-progress.md +63 -0
  61. package/skills/engineering/resolve-issues/references/expire.md +24 -11
  62. package/skills/engineering/resolve-issues/references/implementation.md +9 -1
  63. package/skills/engineering/resolve-issues/references/task-plan.md +7 -4
  64. package/skills/engineering/resolve-release/SKILL.md +1 -1
  65. package/skills/engineering/rush-issues/SKILL.md +5 -2
  66. package/skills/engineering/rush-release/SKILL.md +1 -1
  67. package/skills/engineering/test-quality/SKILL.md +1 -1
  68. package/skills/risk-compliance/compliance-audit/SKILL.md +1 -1
  69. package/skills/risk-compliance/contract-compare/SKILL.md +1 -1
  70. package/skills/risk-compliance/contract-review/SKILL.md +1 -1
  71. package/skills/risk-compliance/doc-authenticity/SKILL.md +1 -1
  72. package/skills/risk-compliance/fraud-analysis/SKILL.md +1 -1
  73. package/skills/risk-compliance/payment-analysis/SKILL.md +1 -1
  74. package/skills/risk-compliance/similar-domain/SKILL.md +1 -1
  75. package/skills/risk-compliance/tld-detection/SKILL.md +1 -1
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: github-flow
3
3
  description: "Deliver a change after the commit: push, open a PR, wait for checks, and merge to main through the repo's flow (direct push, pull request, or merge queue). Use whenever you commit or finish a change, when CONTRIBUTING.md has a Delivery section, and for asks like 'commit this', 'push it', 'open a PR', 'ship it', 'land it', 'get it merged'. Also: declare a repo's delivery flow, or write the CI conventions and Delivery section into CONTRIBUTING.md on request. NOT for writing workflow YAML (github-actions), Mergify config or a stuck queued PR (mergify), cutting a release (resolve-release), or PRs that resolve-issues or rush-issues deliver."
4
- release-version: 0.43.0
4
+ release-version: 0.43.1
5
5
  ---
6
6
  **Updates:** Once/session run `node <skill-base-dir>/release-check.mjs`.
7
7
  # GitHub Flow
@@ -5,7 +5,7 @@ description: >
5
5
  project management. Use when configuring GCP resources, managing service
6
6
  accounts, setting up IAP access, configuring VPC networks, managing secrets,
7
7
  or debugging cloud infrastructure.
8
- release-version: 0.43.0
8
+ release-version: 0.43.1
9
9
  ---
10
10
  **Updates:** Once/session run `node <skill-base-dir>/release-check.mjs`.
11
11
  # Google Cloud Platform (GCP) Skill
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: mergify
3
3
  description: "Mergify merge queue and stacked PRs (`mergify stack`): config, rules, queue status, delivery. Use whenever a merge queue or stack is involved, including plain asks ('watch #123 till it merges', 'where is #412 in the queue', 'push this stack'): `gh pr view`/`gh pr checks` cannot see a dequeue; use `mergify queue show` and the bundled watcher. Also: a hook saying 'use mergify stack push', a missing Change-Id; authoring or debugging `.mergify.yml`, queue rules, merge protections, batch size, the ruleset making merges queue-only; enqueue policy (`@mergifyio queue` vs `auto_merge_conditions`); a push dequeuing a queued PR; bypass actors; freezing a branch. Failures: a PR stuck, queued but never merging, or merged unqueued; CI green on GitHub but unmet in Mergify; a batch going red or bisecting; a queue check missing rather than failing. Outranks the vendor mergify-* skills. NOT for pushing a PR in a repo without stack hooks (github-flow), workflow YAML (github-actions), or GCP deploy pipelines (cloud-deploy)."
4
- release-version: 0.43.0
4
+ release-version: 0.43.1
5
5
  ---
6
6
  **Updates:** Once/session run `node <skill-base-dir>/release-check.mjs`.
7
7
  # Mergify Merge Queue
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: podman
3
3
  description: "Debug, design, or fix Podman: rootless/rootful containers, pods, podman-compose, the socket and systemd services, Docker-compatible API (DOCKER_HOST/CONTAINER_HOST), networking, volumes, SELinux labels, Docker migration, and CI/SSH provisioning of rootless sockets (user lingering, XDG_RUNTIME_DIR). Covers FailedToOpenSocket and systemctl --user DBUS/XDG errors."
4
- release-version: 0.43.0
4
+ release-version: 0.43.1
5
5
  ---
6
6
  **Updates:** Once/session run `node <skill-base-dir>/release-check.mjs`.
7
7
  # Podman Operations
@@ -6,7 +6,7 @@ description: >
6
6
  Use when a user shares an article, pastes article text, sends a URL, or asks to
7
7
  review, rate, critique, evaluate, 评价, 点评, 分析, or 看看 any article, post, or 文章.
8
8
  Default template is 公众号-支付行业.
9
- release-version: 0.43.0
9
+ release-version: 0.43.1
10
10
  ---
11
11
  **Updates:** Once/session run `node <skill-base-dir>/release-check.mjs`.
12
12
  # 文章评审引擎
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: article-to-image
3
3
  description: "Generate article cover images: WeChat banner/square (公众号封面), Xiaohongshu (小红书封面), LinkedIn banner, general wide. Brainstorms 4 visual directions from the article, then renders each format with correct aspect ratios and title-safe zones. Use when given an article and asked for covers, banners, or 出图."
4
- release-version: 0.43.0
4
+ release-version: 0.43.1
5
5
  ---
6
6
  **Updates:** Once/session run `node <skill-base-dir>/release-check.mjs`.
7
7
  # Article-to-Image
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: flowchart-svg
3
3
  description: Create polished flowcharts directly as SVG and export PNG copies. Use when asked to draw, design, render, or deliver process diagrams, architecture diagrams, consulting workflows, decision flows, swimlanes, or other flowcharts as image files, especially when final outputs must include .svg and .png versions.
4
- release-version: 0.43.0
4
+ release-version: 0.43.1
5
5
  ---
6
6
  **Updates:** Once/session run `node <skill-base-dir>/release-check.mjs`.
7
7
  # Flowchart SVG
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: image-gen
3
3
  description: Generate an image from a text prompt with OpenAI gpt-image-2 or Google Nano Banana (Gemini), saved to an image file. Use whenever the user asks to generate, create, make, draw, paint, render, or design an image, picture, illustration, photo, artwork, logo, icon, avatar, banner, hero image, thumbnail, poster, wallpaper, sticker, or concept art — including phrasings like "an image of X", "a picture of X", "show me what X would look like", or a request for a visual for a slide, blog post, README, or social post. Also triggers on Chinese phrasings such as 生成图片, 画一张图, 做一张海报, 设计一个 logo. NOT for charts or data visualizations (dataviz), flowcharts or architecture diagrams (flowchart-svg), or editing an existing image file.
4
- release-version: 0.43.0
4
+ release-version: 0.43.1
5
5
  ---
6
6
  **Updates:** Once/session run `node <skill-base-dir>/release-check.mjs`.
7
7
  # Image Generation
@@ -2,7 +2,7 @@
2
2
  name: mermaid
3
3
  description: Create and edit Mermaid diagrams for architecture, API flows, database schemas, workflows, and data models.
4
4
  user-invocable: true
5
- release-version: 0.43.0
5
+ release-version: 0.43.1
6
6
  ---
7
7
  **Updates:** Once/session run `node <skill-base-dir>/release-check.mjs`.
8
8
  # Mermaid Diagram Creation
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: wechat-article-writer
3
3
  description: "Write WeChat 公众号 articles in Chinese content styles — 踩坑型 (pitfall-story), 实操型 (how-to), 对比型 (comparison), 观察型 (industry insight) — in the account's house style from the nearest WRITING.md. Use for drafting from scratch, rewriting a draft, adapting source material into a publishable article, or picking the right style. NOT for business or technical documents (write-doc)."
4
- release-version: 0.43.0
4
+ release-version: 0.43.1
5
5
  ---
6
6
  **Updates:** Once/session run `node <skill-base-dir>/release-check.mjs`.
7
7
  # WeChat Article Writer (公众号写作)
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: wechat-publisher
3
3
  description: "Publish articles to a WeChat Official Account (公众号) via API: push Markdown to the draft box (or auto-publish with --publish), convert Markdown to WeChat HTML, upload images to the media library. Requires AppID + AppSecret + whitelisted server IP on a 认证订阅号/服务号. Consumes wechat-article-writer's Markdown."
4
- release-version: 0.43.0
4
+ release-version: 0.43.1
5
5
  ---
6
6
  **Updates:** Once/session run `node <skill-base-dir>/release-check.mjs`.
7
7
  # WeChat Publisher (公众号发布)
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: wechat-search
3
3
  description: "Search WeChat 公众号 articles via Sogou Weixin, or read/summarize an article from a mp.weixin.qq.com URL (读/分析/总结) — suggest proactively when such a URL appears. Use for Chinese WeChat content, industry reports, competitor or trending topics. Requires Chrome Browser Relay. NOT general web search (web_search)."
4
- release-version: 0.43.0
4
+ release-version: 0.43.1
5
5
  ---
6
6
  **Updates:** Once/session run `node <skill-base-dir>/release-check.mjs`.
7
7
  # WeChat Article Search & Reader (搜狗微信搜索)
@@ -9,7 +9,7 @@ metadata:
9
9
  type: secret
10
10
  required: true
11
11
  description: xAI API key (get from console.x.ai)
12
- release-version: 0.43.0
12
+ release-version: 0.43.1
13
13
  ---
14
14
  **Updates:** Once/session run `node <skill-base-dir>/release-check.mjs`.
15
15
  # xAI Search (X/Twitter + Web)
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: distill-writing
3
3
  description: "Learn a house writing style from approved sample documents, or save an explicitly stated project document preference, into WRITING.md and writing/templates/. Use for sample-based style learning, house-style setup or refresh, and requests such as 'remember this for future PRDs' or 'make this our report default', including handoffs from write-doc or plain-language. Preserve manual edits and separate document types. NOT for drafting a document (write-doc) or saving chat-only preferences (plain-language)."
4
- release-version: 0.43.0
4
+ release-version: 0.43.1
5
5
  ---
6
6
  **Updates:** Once/session run `node <skill-base-dir>/release-check.mjs`.
7
7
  # Distill a writing style
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: doc-to-md
3
3
  description: "Convert documents (PDF, DOCX, PPTX, XLSX, images) to Markdown so agents can read them. Use as the preprocessing step whenever binary files need to enter agent context — contract review, compliance audit, document analysis, evidence review."
4
- release-version: 0.43.0
4
+ release-version: 0.43.1
5
5
  ---
6
6
  **Updates:** Once/session run `node <skill-base-dir>/release-check.mjs`.
7
7
  # doc-to-md
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: editorial-review
3
3
  description: "Review a document or generated report for what it says (does the reader get the answer, is the argument sound, is anything unsupported, obvious or repeated), then fix the content. Use to review, tighten or clarify a doc or report, and as the review step of write-doc and the report skills. NOT for Chinese wording (polish-cn) or code review (better-review)."
4
- release-version: 0.43.0
4
+ release-version: 0.43.1
5
5
  ---
6
6
  **Updates:** Once/session run `node <skill-base-dir>/release-check.mjs`.
7
7
  # Editorial review
@@ -3,7 +3,7 @@ name: house-style
3
3
  description: "Shared reference the writing skills read by path: WRITING.md lookup and precedence, template choice, gap markers, template shape, the bundled templates, and the default English and Chinese style guides. Never select or invoke it as a task."
4
4
  disable-model-invocation: true
5
5
  user-invocable: false
6
- release-version: 0.43.0
6
+ release-version: 0.43.1
7
7
  ---
8
8
  **Updates:** Once/session run `node <skill-base-dir>/release-check.mjs`.
9
9
  # House style
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: plain-language
3
3
  description: "Session mode: every reply and status line in plain language — lead with the point, everyday words, full sentences, no filler — in English or Chinese, until turned off. Enable by default when the project has an applicable WRITING.md, even without a slash command. Use for /plain-language, 'talk plainly', '说人话', and explicit requests to remember project reply preferences; /plain-language init persists the default and loading instructions. Save reply rules only under Agent replies; route document preferences to distill-writing. Ordinary mode toggles remain session-only. Turn off with '/plain-language off' or 'normal mode'. NOT for writing a document (write-doc) or reviewing one (editorial-review)."
4
- release-version: 0.43.0
4
+ release-version: 0.43.1
5
5
  ---
6
6
  **Updates:** Once/session run `node <skill-base-dir>/release-check.mjs`.
7
7
  # Plain language
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: polish-cn
3
3
  description: "Polish the Chinese wording of a finished document or report, with a script proving every number, date, identifier, link and protected term is unchanged; prefers a Chinese model and records which ran. Use for '中文润色' or as a report skill's last step. NOT for cutting or restructuring content (editorial-review) or translating (write-doc)."
4
- release-version: 0.43.0
4
+ release-version: 0.43.1
5
5
  ---
6
6
  **Updates:** Once/session run `node <skill-base-dir>/release-check.mjs`.
7
7
  # Polish Chinese
@@ -2,7 +2,7 @@
2
2
  name: reg-parser
3
3
  version: 1.1.0
4
4
  description: "Parse regulatory/scheme documents into structured outputs: convert a regulation (AML, VARS, PCI-DSS, KYC, GDPR) into an audit-ready compliance checklist, or trace contract clauses to a mandate source. Suggest proactively when a regulation PDF accompanies a contract review or compliance task. NOT general summarization (doc-to-md), or writing the gap analysis or policy from the checklist (write-doc)."
5
- release-version: 0.43.0
5
+ release-version: 0.43.1
6
6
  ---
7
7
  **Updates:** Once/session run `node <skill-base-dir>/release-check.mjs`.
8
8
  # reg-parser
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: terminology
3
3
  description: "Build and keep a project's TERMINOLOGY.md: the preferred term per concept in English, 简体 and 繁體, and the terms to avoid. Use to set it up from the project's documents, when the user settles or corrects a term, or when another writing skill needs the format. NOT for writing documents (write-doc) or the code domain model (domain-modeling)."
4
- release-version: 0.43.0
4
+ release-version: 0.43.1
5
5
  ---
6
6
  **Updates:** Once/session run `node <skill-base-dir>/release-check.mjs`.
7
7
  # Terminology
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: write-doc
3
3
  description: "Write or edit documents and compliance reports in the project's house style: BRD, PRD, gap analysis, technical spec, integration guide, proposal, policy, risk procedure, audit report, external assessment, management report or Visa VARS Review Report; English, Chinese or bilingual. Use automatically whenever asked to draft, write, revise or edit a document, without needing a slash command, including 'write up the findings'. Route explicit requests to remember a writing preference to its persistence owner. Markdown by default; export when requested. NOT for ordinary chat replies (plain-language), learning style from samples or preference-only saves (distill-writing), performing an audit (compliance-audit), or WeChat articles (wechat-article-writer)."
4
- release-version: 0.43.0
4
+ release-version: 0.43.1
5
5
  ---
6
6
  **Updates:** Once/session run `node <skill-base-dir>/release-check.mjs`.
7
7
  # Write a document
@@ -4,7 +4,7 @@ description: "Slash/explicit-only (/better-review). Single-agent adversarial rev
4
4
  disable-model-invocation: true
5
5
  dependencies:
6
6
  - engineering-runtime
7
- release-version: 0.43.0
7
+ release-version: 0.43.1
8
8
  ---
9
9
  **Updates:** Once/session run `node <skill-base-dir>/release-check.mjs`.
10
10
  # Better Review
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: contributing
3
3
  description: "The conventions a repo's CONTRIBUTING.md holds, starting with tracker routing: which tracker an issue belongs in (GitHub for engineering, Linear for product), duplicate search, and linking back to the source requirement. Use before creating any issue, spec, epic, ticket or sub-issue on GitHub or Linear, including inside /to-spec, /to-tickets and /triage, and whenever work that started from a Linear issue turns into engineering work. Also writes the rules as the Issue tracking section of the repo's CONTRIBUTING.md. NOT for delivering a PR (github-flow) or splitting work into slices (to-tickets)."
4
- release-version: 0.43.0
4
+ release-version: 0.43.1
5
5
  ---
6
6
  **Updates:** Once/session run `node <skill-base-dir>/release-check.mjs`.
7
7
  # Contributing
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: e2e-test
3
3
  description: "Playwright end-to-end standard: the 3-tier suite (render-health / functional / journey), generated route manifest, and presentation sweep. Use when browser routes or user flows ship or change, or a Playwright test flakes. NOT for non-browser tests, defining what to test (ensure-coverage), the curated ALIVE/DEAD golden-path gate (golden-path), or CI workflow YAML (github-actions)."
4
- release-version: 0.43.0
4
+ release-version: 0.43.1
5
5
  ---
6
6
  **Updates:** Once/session run `node <skill-base-dir>/release-check.mjs`.
7
7
  # E2E Testing Standard
@@ -3,7 +3,7 @@ name: engineering-runtime
3
3
  description: Internal support package for shared Engineering Workflow executable behavior. Never select or invoke this package as a user capability.
4
4
  disable-model-invocation: true
5
5
  user-invocable: false
6
- release-version: 0.43.0
6
+ release-version: 0.43.1
7
7
  ---
8
8
  **Updates:** Once/session run `node <skill-base-dir>/release-check.mjs`.
9
9
  # Engineering Runtime
@@ -369,7 +369,7 @@
369
369
  "repository": "1aboveio/ai",
370
370
  "revision": "main"
371
371
  },
372
- "contentDigest": "8f0be335debec8a0b64bb40201a412eb0bc9ccc402074a7af0a483609daac28e",
372
+ "contentDigest": "a37292865bf496db5c900602b3a2fefb87b5ebc9e6e7a185e2c8471d498c9a38",
373
373
  "digestExcludes": []
374
374
  },
375
375
  {
@@ -382,7 +382,7 @@
382
382
  "repository": "1aboveio/ai",
383
383
  "revision": "main"
384
384
  },
385
- "contentDigest": "54c4c3e8579168b32c9d894f91d9bd6950dde2bf44ebd908cc7c548bdc0f6435",
385
+ "contentDigest": "76e79c091a20274fc7a11296e5dbb2bb128525499596129baae4a11179ef7f71",
386
386
  "digestExcludes": []
387
387
  },
388
388
  {
@@ -395,7 +395,7 @@
395
395
  "repository": "1aboveio/ai",
396
396
  "revision": "main"
397
397
  },
398
- "contentDigest": "8e6ae6a6065c670b6ed61c2b881dbea921847a7d80818916e853c4b73dd02e56",
398
+ "contentDigest": "e4c79b9b236babd8413778b57b67e157edc81b7870302ac38153ebd15eca6b66",
399
399
  "digestExcludes": []
400
400
  },
401
401
  {
@@ -408,7 +408,7 @@
408
408
  "repository": "1aboveio/ai",
409
409
  "revision": "main"
410
410
  },
411
- "contentDigest": "d5c96b3b0a7272a6ae6d4670f3deca7196c39cdb857d52936b076e880d338bcd",
411
+ "contentDigest": "c91d1d12fb3110f42779c00aa7666a7f9401bae04e63c681034c84276adab222",
412
412
  "digestExcludes": []
413
413
  },
414
414
  {
@@ -421,7 +421,7 @@
421
421
  "repository": "1aboveio/ai",
422
422
  "revision": "main"
423
423
  },
424
- "contentDigest": "077317f2b2e8a142bd46c75d00bf2ba23b34cc24daa3f49bb9e4bb7247f7590c",
424
+ "contentDigest": "800748e040c2c47a78b65713fd88d1586206feb7f5a5ce052da051a72cc82743",
425
425
  "digestExcludes": []
426
426
  },
427
427
  {
@@ -434,7 +434,7 @@
434
434
  "repository": "1aboveio/ai",
435
435
  "revision": "main"
436
436
  },
437
- "contentDigest": "a755c90afd1aef1e3de56fd35af08e98fc111b7cea775a63c7a34593ec1e499b",
437
+ "contentDigest": "5441c5a8c40c27c1455001ee65b5cf055d25932963410b852d6fd7753e03c7e0",
438
438
  "digestExcludes": []
439
439
  },
440
440
  {
@@ -447,7 +447,7 @@
447
447
  "repository": "1aboveio/ai",
448
448
  "revision": "main"
449
449
  },
450
- "contentDigest": "937c2139aa3ca8f9f0a325c8a1300b1a84faba2f16132f8c608169e4e0732631",
450
+ "contentDigest": "22b2d51f863c5e215dda1036ada423d65873652d05aee4efa83ff4e4995dfc2d",
451
451
  "digestExcludes": []
452
452
  },
453
453
  {
@@ -460,7 +460,7 @@
460
460
  "repository": "1aboveio/ai",
461
461
  "revision": "main"
462
462
  },
463
- "contentDigest": "a2e269f07c9309c5404eafe1b2ca2f5913dd390711c9a3ea7bffb3ae13c88a58",
463
+ "contentDigest": "f293e919a756e073894e959f25d874d69ef94839ccd98a92aa5073308f18f643",
464
464
  "digestExcludes": []
465
465
  },
466
466
  {
@@ -473,7 +473,7 @@
473
473
  "repository": "1aboveio/ai",
474
474
  "revision": "main"
475
475
  },
476
- "contentDigest": "9c2920ba1dd60e6546831d5c5e0d32c2ce620cfd81cbb6b336c19dde223cacbb",
476
+ "contentDigest": "3d9dd1501f80995d27026e1b7ba9751e2e10f4db7f1a427c36bd1f9eec24fcdf",
477
477
  "digestExcludes": []
478
478
  },
479
479
  {
@@ -486,7 +486,7 @@
486
486
  "repository": "1aboveio/ai",
487
487
  "revision": "main"
488
488
  },
489
- "contentDigest": "4b85a0b25eec4594b40d95f41307ae1960b57d648df6e032cc0c780187432805",
489
+ "contentDigest": "4d5e6c1570bb2395813382991aa04437b60b7f20fd54234d07a7af5dbd2b31e3",
490
490
  "digestExcludes": []
491
491
  },
492
492
  {
@@ -499,7 +499,7 @@
499
499
  "repository": "1aboveio/ai",
500
500
  "revision": "main"
501
501
  },
502
- "contentDigest": "ee9204746c76d9734873b6f4953c2bf4854d01544bdd8212fe93df80d51e1c28",
502
+ "contentDigest": "8d32ffe5807e680193e4ee05d51a7c6691e25ffea54bd657405e1025e318cf09",
503
503
  "digestExcludes": []
504
504
  },
505
505
  {
@@ -512,13 +512,13 @@
512
512
  "repository": "1aboveio/ai",
513
513
  "revision": "main"
514
514
  },
515
- "contentDigest": "1924382a6facdc4ad20cf9a70ee608c33c9d3dcba0babc2c1ed900876f6f1bb2",
515
+ "contentDigest": "6fcf7271652b12f8a64e03cdce85fdeee10cc8456f89ac1b39631281e2e52615",
516
516
  "digestExcludes": [
517
517
  "coherence/workflow.json"
518
518
  ]
519
519
  }
520
520
  ],
521
- "releaseIdentity": "931e08c86e3cec4a44ba5568386488328de64187ae452e1db2a952043068d0f6",
521
+ "releaseIdentity": "0e956b77698da11b37a94d960a5f7a7102af5b761b788f1fe52a6c9716cf132d",
522
522
  "lifecycleAuthority": "native-skills-cli",
523
523
  "repairRecipe": {
524
524
  "id": "engineering-workflow-dependency-first",
@@ -2,7 +2,7 @@
2
2
  name: ensure-coverage
3
3
  description: "Define or audit behavior-first test criteria — ACs, required test levels, mock/integration/E2E policy — across three axes: breadth (Coverage Ledger), depth (over-mocking), presentation (perceivability of browser surfaces). NOT judging whether a single test is any good (test-quality), authoring browser tests (e2e-test), reviewing a PR (better-review), or delivering issues (resolve-issues)."
4
4
  disable-model-invocation: true
5
- release-version: 0.43.0
5
+ release-version: 0.43.1
6
6
  ---
7
7
  **Updates:** Once/session run `node <skill-base-dir>/release-check.mjs`.
8
8
  # Ensure Coverage
@@ -3,7 +3,7 @@ name: golden-path
3
3
  description: "Golden-path E2E: the short list of user journeys whose failure blocks a release, kept in a repo as one contract (golden-paths.json) with a generated GOLDEN_PATHS.md and a generated GitHub Actions workflow, and run against a local build or a deployed URL for an ALIVE/DEAD verdict. Use to set golden paths up in a repo ('init golden paths', 'add golden-path CI'), to migrate an older smoke.manifest.json or a hand-built smoke setup ('audit', 'migrate smoke'), to add, change, or remove a golden path, to ask 'is the build alive?' or run them before a PR or release, or when a change touches a flow listed in GOLDEN_PATHS.md. NOT for writing the Playwright specs themselves (e2e-test), deciding what a change must prove (ensure-coverage), or general workflow YAML (github-actions)."
4
4
  dependencies:
5
5
  - e2e-test
6
- release-version: 0.43.0
6
+ release-version: 0.43.1
7
7
  ---
8
8
  **Updates:** Once/session run `node <skill-base-dir>/release-check.mjs`.
9
9
  # Golden path
@@ -3,7 +3,7 @@ name: harness-runtime
3
3
  description: Internal import-only library shared by first-party engineering packages. Not a workflow skill; never select or invoke it as a user capability.
4
4
  disable-model-invocation: true
5
5
  user-invocable: false
6
- release-version: 0.43.0
6
+ release-version: 0.43.1
7
7
  ---
8
8
  **Updates:** Once/session run `node <skill-base-dir>/release-check.mjs`.
9
9
  # Harness Runtime
@@ -8,7 +8,7 @@ dependencies:
8
8
  - better-review
9
9
  - golden-path
10
10
  - harness-runtime
11
- release-version: 0.43.0
11
+ release-version: 0.43.1
12
12
  ---
13
13
  **Updates:** Once/session run `node <skill-base-dir>/release-check.mjs`.
14
14
  # Resolve issues
@@ -78,7 +78,7 @@ ships sooner at the same bar.
78
78
  `/rush-issues` runs this workflow with every answer defaulted ([shortcut mode](references/preflight.md#shortcut-mode)).
79
79
 
80
80
  **Bounds:** the harness times and stops workers · retry while cycles reach new lows; 2 without one,
81
- then [expire.md](references/expire.md) (a fix cycle progresses only on a new low; a resume, when it adds work the PR needs; diagnostics and records never) · workers within [live host capacity](references/implementation.md#live-capacity), one local emulator, queued for device-only work
81
+ then [expire.md](references/expire.md) (fixes and resumes progress through verified checkpoint advances or fewer established failures; added work, diagnostics and records alone do not reset counts) · workers within [live host capacity](references/implementation.md#live-capacity), one local emulator, queued for device-only work
82
82
  and non-CI emulator proof ([scheduling](references/implementation.md#scheduling); CI confirms, never debugs) · one PR per issue · every runnable unit in one run, in dependency order · blocking review hands back
83
83
  after 2 fix rounds without a new low of open P0/P1 path rows; no fixed round cap.
84
84
 
@@ -150,26 +150,17 @@ Read each procedure right before its stage; never substitute your own.
150
150
  steps are only the read-only warehouse canary (never blocks) and the isolated, run-owned resources
151
151
  [preflight.md](references/preflight.md#never-block-on-the-human) allows.
152
152
 
153
+ ## Delivery progress
154
+
155
+ Before briefing or continuing a unit, read [delivery-progress.md](references/delivery-progress.md).
156
+ Keep one existing acceptance checkpoint per unit, preserve failure history, justify new
157
+ infrastructure, and report verified behavior. Full acceptance and required CI still apply.
158
+
153
159
  ## Every brief contains
154
160
 
155
- - the source and criteria, as a file already in the run directory
156
- - the plan's `standingOrders`, verbatim, and the decisions that answer this unit's questions
157
- - absolute run, workspace, and findings paths; for implementers, the unit's
158
- findings entry and its parents' `contracts`
159
- - model id, effort, and a required read-back
160
- - an absolute skill path when the stage invokes a leaf skill; for validating, the unit's `proof.suite` `skill` (read it first) and `local`, when set
161
- - the outcome and validation, with no prescribed method or evidence format
162
- - the [Goal](#goal) and [Principles](#principles), verbatim (a reviewer gets review.md's two rules instead)
163
- - the result path, `<run>/results/<unit>-<label>.json` (`<label>`: kind and attempt, e.g. `fix-2`), with `unit` and `decisionNeeded` (null or a choice)
164
- - at the deadline: stop starting work, commit, and report
165
- - environment rules: write only inside the workspace (and the findings directory for the explorer),
166
- with tool caches and temp files there (`TMPDIR`, `npm_config_cache`, `UV_CACHE_DIR`); use the machine's
167
- installed JDK, Android SDK, system images, and browsers (`JAVA_HOME`, `ANDROID_HOME`) where they fit,
168
- or the repo's pinned Playwright image where the runner has no browser (`github-actions` runners.md);
169
- edit with the harness's tools, never a shell `apply_patch`
170
-
171
- Treat a missing or unreadable result as an incomplete stage: resume a dead
172
- spawn once in the same workspace, never with a success claim.
161
+ Use the full [brief checklist](references/delivery-progress.md#every-brief-contains),
162
+ including the Goal and Principles verbatim, checkpoint history and result contract.
163
+ Treat a missing or unreadable result as incomplete; resume a dead spawn once in its workspace.
173
164
 
174
165
  ## Workflow
175
166
 
@@ -0,0 +1,63 @@
1
+ # Delivery progress
2
+
3
+ For each active unit, name **one immediate acceptance checkpoint** from its existing
4
+ criteria: the next observable behavior or contract to prove. A narrow checkpoint guides
5
+ the next action; it does not replace the unit's full acceptance or required CI. Independent
6
+ units keep their own checkpoints and continue in parallel within actual resource limits.
7
+
8
+ - **Preserve an existing working baseline.** Keep its source/artifact identity, relevant
9
+ environment and passing result as a comparison. Reuse it while those inputs remain
10
+ valid; do not create a new baseline campaign when none exists or treat an old artifact
11
+ as acceptance of the candidate. Keep only what the repo's ownership/retention rules allow.
12
+ - **Debug the smallest failing behavior first.** Name the failing command and the
13
+ observation that would distinguish the remaining causes. Run the relevant host,
14
+ integration or device check before another broad acceptance cycle. After a correction,
15
+ run affected checks and the required delivery checks, not extra assurance work.
16
+ - **Justify infrastructure before adding it.** State which existing criterion requires
17
+ it, why the current path cannot provide that proof, and the smallest alternative.
18
+ Record the choice in the existing decision/note, within current authorization. Routine
19
+ choices need no new approval; shared-resource changes and changes to the acceptance
20
+ bar retain their existing authorization rules. A failed screen alone does not justify
21
+ a new service, transport layer or test platform.
22
+ - **Continue on evidence, not activity.** A handoff identifies what changed at the
23
+ checkpoint: a reproduction, a discriminating observation, a verified correction or
24
+ a concrete blocker, and the next test. A new worker, commit, diagnostic helper, test
25
+ count or green unrelated check is not delivery progress. Useful diagnostic evidence
26
+ can justify a bounded experiment; it does not reset acceptance/non-convergence counts.
27
+ - **Reassess repeated failure at the same checkpoint.** Carry prior evidence and
28
+ no-progress history across worker/model changes and new infrastructure. Follow
29
+ [expiry](expire.md); do not restart the same approach with a fresh brief or
30
+ count newly invented setup milestones as progress. Replan around a smaller case or a
31
+ different distinguishing test, keeping the original criteria and truthful blockers.
32
+ - **Report delivered behavior first.** Use existing plan notes/results to state criteria
33
+ completed and the current checkpoint. When available, include time to reproduction,
34
+ time to verified correction and full CI runs spent on this change. Do not invent
35
+ missing timings or create a separate reporting system to collect them.
36
+
37
+ These rules apply to briefs and coordinator decisions; they add no plan schema, check,
38
+ issue or automatic scheduler gate. They do not waive required validation.
39
+
40
+ ## Every brief contains
41
+
42
+ - the source and criteria, as a file already in the run directory
43
+ - the plan's `standingOrders`, verbatim, and the decisions that answer this unit's questions
44
+ - absolute run, workspace, and findings paths; for implementers, the unit's
45
+ findings entry and its parents' `contracts`
46
+ - model id, effort, and a required read-back
47
+ - an absolute skill path when the stage invokes a leaf skill; for validating, the unit's `proof.suite` `skill` (read it first) and `local`, when set
48
+ - the outcome and validation, with no prescribed method or evidence format
49
+ - the [immediate acceptance checkpoint](#delivery-progress), existing baseline (or none),
50
+ and, for a continuation, the last result, remaining uncertainty and next distinguishing
51
+ test; retain the same checkpoint/history when changing workers
52
+ - the [Goal](../SKILL.md#goal) and [Principles](../SKILL.md#principles), verbatim (a reviewer gets review.md's two rules instead)
53
+ - the result path, `<run>/results/<unit>-<label>.json` (`<label>`: kind and attempt, e.g. `fix-2`), with `unit` and `decisionNeeded` (null or a choice)
54
+ - at the deadline: stop starting work, commit, and report
55
+ - environment rules: write only inside the workspace (and the findings directory for the explorer),
56
+ with tool caches and temp files there (`TMPDIR`, `npm_config_cache`, `UV_CACHE_DIR`); use the machine's
57
+ installed JDK, Android SDK, system images, and browsers (`JAVA_HOME`, `ANDROID_HOME`) where they fit,
58
+ or the repo's pinned Playwright image where the runner has no browser (`github-actions` runners.md);
59
+ edit with the harness's tools, never a shell `apply_patch`
60
+
61
+ Treat a missing or unreadable result as an incomplete stage: resume a dead
62
+ spawn once in the same workspace, never with a success claim.
63
+
@@ -9,10 +9,12 @@ commit alone is not progress. Lows only fall, so the loop always ends.
9
9
  Example: CI fails 5 tests, then 3, then 3, then 3: expire after the fourth
10
10
  cycle. 3, 2, 3, 2 expires too: the second 2 is no new low. 5, 4, 3, 2, 1
11
11
  never expires. A failing journey run, local or dispatched, counts as one
12
- failing check, so count its furthest checkpoint instead (the last step its
13
- log reports passing): login, store, charge, charge, charge expires;
14
- login, store, charge, receipt keeps going. Checkpoints are finite, so this
15
- loop ends too.
12
+ failing check, so count its furthest **existing acceptance checkpoint** instead
13
+ (the last relevant step its log reports passing): login, store, charge, charge,
14
+ charge expires; login, store, charge, receipt keeps going. Extra instrumentation,
15
+ new infrastructure milestones or renaming a checkpoint do not extend this sequence.
16
+ Carry the comparison history across worker/model changes and retries; a genuinely
17
+ changed requirement needs an explicit scope decision, not an implicit reset.
16
18
 
17
19
  | Scope | Count that must reach a new low | Expire after |
18
20
  |---|---|---|
@@ -21,9 +23,17 @@ loop ends too.
21
23
  | Warehouse canary | distinct errors | 2 attempts without progress; record a follow-up, never block |
22
24
  | Review | open P0/P1 path rows | `review-verdict.mjs` verdict `handback` ([review.md](review.md#fix-loop)) |
23
25
  | CI and merge | failing checks and tests; a failing journey run (local or `gh workflow run`) is one check, so it progresses when it passes a checkpoint no earlier run of the attempt passed | 2 fix-and-watch cycles without progress |
24
- | Any worker the harness reports stuck, late, or at its ceiling | none: a resume [progresses](#retry-by-failure-mode) when it adds work the unit's PR needs (product code, tests, CI config, a fix of what blocks it) or meets another acceptance criterion; diagnostics and records alone are not progress | 2 resumes in a row that add neither |
26
+ | Any worker the harness reports stuck, late, or at its ceiling | a resume progresses when its verified result advances the existing checkpoint or reduces the established failure count; added product/test/CI code without that result is not progress, and diagnostics alone do not reset the count | 2 resumes in a row without such progress |
25
27
 
26
- Leave timing to the harness; never stop a worker still making progress.
28
+ Use [Delivery progress](../SKILL.md#delivery-progress) to choose the next bounded
29
+ experiment before applying this ladder. Reproducing a failure or collecting a missing
30
+ observation can be useful without advancing acceptance. Record that distinction; do
31
+ not count logs, helper code or a changed worker as a new low. On repeated non-convergence,
32
+ reassess the approach and preserve unpassed criteria rather than creating another setup
33
+ chain. Existing retry/block/replan rules below still apply.
34
+
35
+ Leave timing to the harness for worker lifetimes. Bound individual test/subprocess waits
36
+ explicitly with cleanup time; an outstanding tool call or heartbeat is not progress.
27
37
 
28
38
  ### Retry by failure mode
29
39
 
@@ -102,8 +112,9 @@ hours.
102
112
  wakes the run at the printed time.
103
113
  - `check-worker` means the worker changed no workspace file for
104
114
  `--quiet-minutes` (45 by default): read its latest output. Stuck: stop it
105
- and take the `timeout-task` response. Still working (a long test run with
106
- live output): let it run.
115
+ and take the `timeout-task` response. A long test with advancing test/phase results
116
+ inside its declared command deadline may continue. Repeated heartbeats, unchanged
117
+ logs or an unbounded child wait are not that evidence.
107
118
  - A watcher that ends with nothing new (a queue `STALLED` with no failing
108
119
  check) is a wait: restart it and report it in one line, or not at all.
109
120
 
@@ -202,14 +213,14 @@ logs, and record one line, with the reason code, in the unit's plan row.
202
213
 
203
214
  | Failure | Response |
204
215
  |---|---|
205
- | `timeout-task` or `spawn-death` | Resume in the kept workspace: commit what is there, then finish or report. Keep resuming while each resume makes [progress](#retry-by-failure-mode); after 2 in a row that add nothing, mark the unit `blocked` (`blockedReason: timeout-task` or `spawn-death`) and hand it back. A result with `decisionNeeded` is decided first ([Decide before you defer](#decide-before-you-defer)), and the resume that carries the decision always runs. Example: a fix worker loses its model stream twice but committed a fixture each time; start a third continuation. |
216
+ | `timeout-task` or `spawn-death` | Resume in the kept workspace: commit what is there, then finish or report. Keep resuming while each resume makes [progress](#retry-by-failure-mode); after 2 in a row without verified checkpoint/failure-count progress, mark the unit `blocked` (`blockedReason: timeout-task` or `spawn-death`) and hand it back. A result with `decisionNeeded` is decided first ([Decide before you defer](#decide-before-you-defer)), and the resume that carries the decision always runs. Example: a fix worker loses its model stream after its focused regression passes; resume the remaining work with that result. Two resumes that only add fixtures without advancing the existing checkpoint trigger reassessment. |
206
217
  | Environment or infrastructure (a check cannot run: cache, emulator, runner, network, credentials) | See [Infrastructure failures](#infrastructure-failures). |
207
218
  | Implement: a fix cycle without progress | Resume with the failing command and its output as the only target, using the escalation model. 2 cycles in a row without progress: `blocked` (`blockedReason: retry-implement`), deferred on its issue. |
208
219
  | Review: `review-verdict.mjs` verdict `fix` | Follow its `action` ([review.md](review.md#fix-loop)). |
209
220
  | Review: `review-verdict.mjs` verdict `handback` (`not-converging`) | Stop fixing; mark the unit `blocked` (`blockedReason: review-handback`) and defer the PR with its open findings on its issue. |
210
221
  | Review: `review-verdict.mjs` verdict `decide`, or a worker's `decisionNeeded` | [Decide before you defer](#decide-before-you-defer). |
211
222
  | CI: a fix cycle without progress | Treat the failing check as the failing test: the next fix worker runs on the escalation model with that check as its only target. 2 cycles in a row without progress: `blocked` (`blockedReason: retry-ci`), deferred on its issue. |
212
- | Too big for one attempt | Resume in the kept workspace while each resume makes [progress](#retry-by-failure-mode); after 2 in a row that make none, draft a split in `<run>/splits/`, file it into the spec's tree, and run the slices the sync adds ([preflight.md](preflight.md#put-every-filed-issue-in-the-tree)). |
223
+ | Too big for one attempt | Resume in the kept workspace while each resume makes [progress](#retry-by-failure-mode); after 2 in a row without verified checkpoint/failure-count progress, draft a split in `<run>/splits/`, file it into the spec's tree, and run the slices the sync adds ([preflight.md](preflight.md#put-every-filed-issue-in-the-tree)). |
213
224
  | A required proof the unit has no environment for yet | The unit builds it; see [Proof stays with its unit](#proof-stays-with-its-unit). |
214
225
  | Dependency | Fix the edge; resume when runnable. |
215
226
  | A capability the unit needs is missing and no unit builds it (a shared driver, fixture, or hook) | Build it inside the first unit that needs it; units that need it later get `dependsOn` on that unit. Only when that puts the unit past the size check's line limit, file it as its own issue beside them, with `blocked_by` on the units that use it, never on their parent issue. Example: three proof units each need a device-state reader: the first builds it, the other two depend on the first. |
@@ -229,7 +240,9 @@ dependents start while the parent still proves itself; only the unit's own
229
240
  merge waits for its proof.
230
241
 
231
242
  - **No working suite or environment yet? The unit builds what its proof
232
- needs**, with access the run already has (the run's local emulator, when
243
+ needs**, after recording why the existing path cannot prove that criterion and why
244
+ the proposed addition is the smallest suitable option ([Delivery progress](../SKILL.md#delivery-progress)),
245
+ with access the run already has (the run's local emulator, when
233
246
  [its queue](implementation.md#scheduling) hands it over, a
234
247
  disposable database, a container, a tunnel hostname), counted in its
235
248
  lines like a missing prerequisite. When two or more units need the same