@mmerterden/multi-agent-pipeline 16.18.0 → 16.19.0

package/pipeline/skills/shared/core/multi-agent-help/SKILL.md

@@ -59,7 +59,7 @@ How It Works (Phase 0  -  Interactive Flow):
 Pipeline (after Phase 0):
 
   Phase 0: Init      -> The 8 steps above
-  Phase 1: Analysis  -> Stack detection + codebase scan (Fable)
+  Phase 1: Analysis  -> Stack detection + codebase scan (Sonnet)
   Phase 2: Planning  -> Task breakdown + architecture review + Plan Approval Gate
   Phase 3: Dev       -> TDD: test -> code -> build (Sonnet) + build queue
   Phase 4: Review    -> Deterministic gates + parallel AI review + Fable triage
@@ -236,7 +236,7 @@ Nasıl Çalışır (Phase 0  -  İnteraktif Akış):
 Pipeline (Phase 0'dan sonra):
 
   Phase 0: Init      -> Yukarıdaki 8 adım
-  Phase 1: Analysis  -> Stack tespiti + codebase taraması (Fable)
+  Phase 1: Analysis  -> Stack tespiti + codebase taraması (Sonnet)
   Phase 2: Planning  -> Task kırılımı + mimari inceleme + Plan Onay Kapısı
   Phase 3: Dev       -> TDD: test -> kod -> build (Sonnet) + build queue
   Phase 4: Review    -> Deterministik kapılar + paralel AI review + Fable triage

package/pipeline/skills/shared/core/multi-agent-local/SKILL.md

@@ -26,7 +26,7 @@ The same 8 phases as the normal pipeline: Init → Analysis → Planning → Dev
 
 ## Delegation
 
-Delegates to the orchestrator skill (`multi-agent/SKILL.md`) with the `--local` flag. The Phase 0 Step 8 worktree step is skipped; all other phase contracts apply as is (Plan Approval Gate, 2-model/3-model review, triage, secret scan, PR creation).
+Delegates to the orchestrator skill (`multi-agent/SKILL.md`) with the `--local` flag. The Phase 0 Step 6 worktree step is skipped; all other phase contracts apply as is (Plan Approval Gate, three-reviewer review, triage, secret scan, PR creation).
 
 ## Examples
 

package/pipeline/skills/shared/core/multi-agent-local-autopilot/SKILL.md

@@ -25,7 +25,7 @@ Depth is a separate axis, asked at Phase 0 Step 7.5 rather than encoded in the c
 
 ## What changes
 
-- The Phase 0 Step 8 worktree step is skipped (local contract)
+- The Phase 0 Step 6 worktree step is skipped (local contract)
 - The Phase 2 Plan Approval Gate is skipped (autopilot contract)  -  `state.autopilot === true`
 - The Phase 5 test prompt is skipped, Phase 6 commit/PR does not wait for confirmation
 - **v7.0.0+**: The Phase 2 safety classifier (`classify-plan-safety.mjs`) always runs; if the score is ≥ 50 it asks for a single manual confirmation even in autopilot (`prefs.global.autopilotSafetyGate`, default on)
@@ -48,7 +48,7 @@ multi-agent-local-autopilot "#3"
 
 ## Delegation
 
-The orchestrator skill (`multi-agent/SKILL.md`) takes the `--local` + `"autopilot": true` state flags together. Contract: `refs/phases/phase-0-init.md` Step 8 (local branch) + `refs/phases/phase-2-planning.md` Step 5 (gate skip) + Step 5c (safety classifier, v7.0.0+).
+The orchestrator skill (`multi-agent/SKILL.md`) takes the `--local` + `"autopilot": true` state flags together. Contract: `refs/phases/phase-0-init.md` Step 6 (local branch) + `refs/phases/phase-2-planning.md` Step 5 (gate skip) + Step 5c (safety classifier, v7.0.0+).
 
 ## Required: outward-facing payload contracts
 

package/pipeline/skills/shared/core/multi-agent-review/SKILL.md

@@ -3,7 +3,7 @@ name: multi-agent-review
 language: en
 description: "Run parallel review on a branch diff or a Pull Request: 3 models on Claude Code (Fable + Opus + Sonnet), 3 models on Copilot CLI (GPT + Opus + Sonnet). On PR input, posts per-finding inline comments + approve/needs-work. With no input (interactive), lists open GitHub + Bitbucket PRs to multi-select. Use when a branch diff or a pull request needs reviewing before it merges."
 user-invocable: true
-argument-hint: "[#N | repo#N | PR-URL | branch]  -  PR by number/URL, repo+number, or branch (GitHub + Bitbucket Server). If omitted: interactive PR picker, else current branch."
+argument-hint: "[#N | repo#N | PR-URL | branch] [--with <path|owner/repo>]  -  PR by number/URL, repo+number, or branch (GitHub + Bitbucket Server). If omitted: interactive PR picker, else current branch. --with names the counterpart app repo for the platform-parity cross-check."
 ---
 
 # multi-agent review  -  Review Only Mode
@@ -31,17 +31,25 @@ Skip Phase 0-3 and review a diff only. Input shapes: a PR (`#N`, `repo#N`, GitHu
    # bitbucket PR: curl -u "$BB_USER:$BB_TOKEN" .../pull-requests/$N/diff?contextLines=10
    ```
 
-3. **Start parallel reviewers**  -  reviewer set depends on the host CLI:
+3. **Start parallel reviewers**  -  three on every host; only the second slot differs, because GPT-5.4 exists on Copilot and Codex but not on Claude Code, where Opus fills it:
 
    **Claude Code (3 in parallel):**
    - Agent 1: `claude-fable-5` → security + architecture
-   - Agent 2: `claude-sonnet-5` → general quality
+   - Agent 2: `claude-opus-5` → edge cases, different perspective
+   - Agent 3: `claude-sonnet-5` → general quality
 
    **Copilot CLI (3 in parallel):**
    - Agent 1: `claude-opus-5` → security + architecture (Fable 5 is not offered on Copilot CLI)
    - Agent 2: `gpt-5.4` → edge cases, different perspective
    - Agent 3: `claude-sonnet-5` → general quality
 
+   **Codex CLI (3 in parallel, single vendor):**
+   - Agent 1: `gpt-5.6` @ `xhigh` → security + architecture
+   - Agent 2: `gpt-5.4` @ `high` → edge cases, different perspective
+   - Agent 3: `gpt-5.6` @ `medium` → general quality
+
+   With the `fable` rung disabled by prefs the Claude Code panel is two reviewers (Opus + Sonnet); see `multi-agent-refs/features/model-fallback.md`.
+
 4. **Store-compliance cross-reference**  -  if iOS/Android release-relevant files changed, the matching catalog is loaded:
 
    | Platform | Trigger files | Catalog to load |
@@ -55,17 +63,18 @@ Skip Phase 0-3 and review a diff only. Input shapes: a PR (`#N`, `repo#N`, GitHu
 
    It does NOT invoke any binary/tool  -  the review stage only uses the catalog. For a full scan use `multi-agent-test "store-ready"`.
 
-4b. **Platform parity cross-check** (advisory, read-only)  -  when `state.siblings[]`
-   (written by the Phase 0 dev-context picker) holds a checked-out repo whose `stack` is
-   the other mobile platform and the diff touches a screen, a service, a request model
-   or a localization file, compare the change against that repo on four axes: endpoints
-   called, parameters sent, business rules around the call, localization keys used.
-   The counterpart is resolved automatically and in both directions (ios ↔ android):
-   a remembered `prefs.projects[<slug>].counterpartRoots[]`, then the primary checkout's
-   sibling directories, then `state.siblings[]`. One match is used and remembered;
-   several are asked about interactively and skipped in autopilot; none skips silently.
-   `--with <path|owner/repo>` overrides for a one-off. Stack comes from marker files,
-   never from the repo name.
+4b. **Platform parity cross-check** (advisory, read-only)  -  when a counterpart repo
+   resolves whose `stack` is the other mobile platform and the diff touches a screen, a
+   service, a request model or a localization file, compare the change against that repo
+   on four axes: endpoints called, parameters sent, business rules around the call,
+   localization keys used. The counterpart is resolved automatically and in both
+   directions (ios ↔ android) from four sources in this order, first hit wins:
+   `--with <path|owner/repo>` (a one-off override, remembered like any other resolution),
+   then a remembered `prefs.projects[<slug>].counterpartRoots[]`, then the primary
+   checkout's sibling directories, then `state.siblings[]` from the Phase 0 dev-context
+   picker. None of them is a precondition for the others. One match is used and
+   remembered; several are asked about interactively and skipped in autopilot; none
+   skips silently. Stack comes from marker files, never from the repo name.
 
    The counterpart is located through the code graph, capped at 8 files, and is **read
    only**  -  never edited, staged, committed, pushed or built. Output is its own

package/pipeline/skills/shared/core/multi-agent-sync/SKILL.md

@@ -32,7 +32,7 @@ Run all steps automatically:
 ```
 Step 1: DETECT      Compare timestamps, find stale targets
 Step 2: COPILOT     Claude Code -> Copilot CLI (instructions + 55 sub-command skills)
-Step 2b: CODEX      Claude Code -> Codex CLI (1 router skill + 51 specs as refs + 8 agent TOML)
+Step 2b: CODEX      Claude Code -> Codex CLI (1 router skill + 55 specs as refs + 8 agent TOML)
 Step 3: REPO        Claude Code -> pipeline repo (genericized, personal data scrub)
 Step 3d: DEV-TOOLKIT Companion MCP server -> detect movement, ship gates, commit + publish
 Step 4: WEBSITE     Version + phase/model counts -> {website-host} (i18n + projects.ts)
@@ -222,7 +222,7 @@ When invoked with the `release` argument:
 
 | Claude Code | Copilot CLI |
 |-------------|-------------|
-| `~/.claude/commands/multi-agent/{cmd}.md` | `~/.copilot/skills/multi-agent-{cmd}/SKILL.md` |
+| `~/.claude/commands/multi-agent/{cmd}/SKILL.md` | `~/.copilot/skills/multi-agent-{cmd}/SKILL.md` |
 
 **55 commands are synced** (canonical inventory  -  must match `cross-cli-contract.md` section 1; drift = contract violation):
 

package/pipeline/skills/shared/external/NOTICE-dimillian-skills.md

@@ -0,0 +1,56 @@
+# Vendored Skills - Dimillian/Skills
+
+8 skills under `pipeline/skills/shared/external/` carry `source: "Dimillian/Skills (MIT)"` in their frontmatter: app-store-changelog, ios-debugger-agent, macos-menubar-tuist-app, macos-spm-app-packaging, swift-concurrency-expert, swiftui-performance-audit, swiftui-ui-patterns, swiftui-view-refactor.
+
+## Upstream
+
+- Repository: https://github.com/Dimillian/Skills
+- Author: Thomas Ricouard
+- License: MIT (see LICENSE in upstream repo; text below)
+- SKILL.md bodies were adopted 2026-03-25; the companion files were vendored 2026-09-02 from commit `05ba982` (05ba982bfeb0d77d3c97d4542b0ee15034d05f84, 2026-03-29).
+
+## Vendored companion files (58)
+
+| Skill | Directories |
+|---|---|
+| `app-store-changelog/` | `references/` (1), `scripts/` (1) |
+| `macos-spm-app-packaging/` | `assets/templates/` (12, incl. `bootstrap/`), `references/` (3) |
+| `swift-concurrency-expert/` | `references/` (3) |
+| `swiftui-performance-audit/` | `references/` (7) |
+| `swiftui-ui-patterns/` | `references/` (30) |
+| `swiftui-view-refactor/` | `references/` (1) |
+
+Upstream `agents/` directories (Claude Code subagent definitions) are not vendored; no local SKILL.md references them.
+
+## Local modifications
+
+- Punctuation normalized to ASCII per pipeline humanizer policy (em-dash, en-dash, ellipsis, curly quotes).
+- Each SKILL.md carries a locally added `## When to Use` section and pipeline frontmatter (`risk`, `source`, `date_added`).
+- `swiftui-ui-patterns/references/components-index.md`: four upstream lines pointing at files that do not exist upstream either (`webview.md`, `composer.md`, `text-input.md`, `design-system.md`) were removed.
+- `macos-spm-app-packaging/SKILL.md`: a stray fetch-transcript trailer left by the original adoption was removed.
+
+## License (MIT, redistributed)
+
+```
+MIT License
+
+Copyright (c) 2026 Thomas Ricouard
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+```

package/pipeline/skills/shared/external/accessibility-compliance-accessibility-audit/SKILL.md

@@ -38,8 +38,4 @@ $ARGUMENTS
 - Perform manual checks (keyboard, screen reader, focus order, contrast).
 - Map findings to WCAG criteria, severity, and user impact.
 - Provide remediation steps and re-test after fixes.
-- If detailed procedures are required, open `resources/implementation-playbook.md`.
 
-## Resources
-
-- `resources/implementation-playbook.md` for detailed audit steps, tooling, and remediation examples.

package/pipeline/skills/shared/external/api-patterns/SKILL.md

@@ -11,26 +11,20 @@ date_added: "2026-02-27"
 > API design principles and decision-making for 2025.
 > **Learn to THINK, not copy fixed patterns.**
 
-## 🎯 Selective Reading Rule
+## 📑 Topics
 
-**Read ONLY files relevant to the request!** Check the content map, find what you need.
-
----
-
-## 📑 Content Map
-
-| File | Description | When to Read |
+| Topic | Covers | When it applies |
 |------|-------------|--------------|
-| `api-style.md` | REST vs GraphQL vs tRPC decision tree | Choosing API type |
-| `rest.md` | Resource naming, HTTP methods, status codes | Designing REST API |
-| `response.md` | Envelope pattern, error format, pagination | Response structure |
-| `graphql.md` | Schema design, when to use, security | Considering GraphQL |
-| `trpc.md` | TypeScript monorepo, type safety | TS fullstack projects |
-| `versioning.md` | URI/Header/Query versioning | API evolution planning |
-| `auth.md` | JWT, OAuth, Passkey, API Keys | Auth pattern selection |
-| `rate-limiting.md` | Token bucket, sliding window | API protection |
-| `documentation.md` | OpenAPI/Swagger best practices | Documentation |
-| `security-testing.md` | OWASP API Top 10, auth/authz testing | Security audits |
+| API style | REST vs GraphQL vs tRPC decision tree | Choosing API type |
+| REST | Resource naming, HTTP methods, status codes | Designing REST API |
+| Response shape | Envelope pattern, error format, pagination | Response structure |
+| GraphQL | Schema design, when to use, security | Considering GraphQL |
+| tRPC | TypeScript monorepo, type safety | TS fullstack projects |
+| Versioning | URI/Header/Query versioning | API evolution planning |
+| Auth | JWT, OAuth, Passkey, API Keys | Auth pattern selection |
+| Rate limiting | Token bucket, sliding window | API protection |
+| Documentation | OpenAPI/Swagger best practices | Documentation |
+| Security testing | OWASP API Top 10, auth/authz testing | Security audits |
 
 ---
 
@@ -75,11 +69,5 @@ Before designing an API:
 
 ---
 
-## Script
-
-| Script | Purpose | Command |
-|--------|---------|---------|
-| `scripts/api_validator.py` | API endpoint validation | `python scripts/api_validator.py <project_path>` |
-
 ## When to Use
 This skill is applicable to execute the workflow or actions described in the overview.

package/pipeline/skills/shared/external/app-store-changelog/references/release-notes-guidelines.md

@@ -0,0 +1,34 @@
+# App Store Release Notes Guidelines
+
+## Goals
+- Produce user-facing release notes that describe visible changes since the last tag.
+- Include all user-impacting changes; omit purely internal or refactor-only work.
+- Keep language plain, short, and benefit-focused.
+
+## Output Shape
+- Prefer 5 to 10 bullets total for most releases.
+- Group by theme if needed: New, Improved, Fixed.
+- Each bullet should be one sentence and start with a verb.
+- Avoid internal codenames, ticket IDs, or file paths.
+
+## Filtering Rules
+- Include: new features, UI changes, behavior changes, bug fixes users would notice, performance improvements with visible impact.
+- Exclude: refactors, dependency bumps, CI changes, developer tooling, internal logging, analytics changes unless they affect user privacy or behavior.
+- If a change is ambiguous, ask for clarification or describe it as a small improvement only if it is user-visible.
+
+## Language Guidance
+- Translate technical terms into user-facing descriptions.
+- Avoid versions of "API", "refactor", "nil", "crash log", or "dependency".
+- Prefer "Improved", "Added", "Fixed", "Updated" or action verbs like "Search", "Upload", "Sync".
+- Keep tense present or past: "Added", "Improved", "Fixed".
+
+## Examples
+- "Added account switching from the profile menu."
+- "Improved timeline loading speed on slow connections."
+- "Fixed media attachments not opening in full screen."
+
+## QA Checklist
+- Every bullet ties to a real change in the range.
+- No duplicate bullets that describe the same change.
+- No internal jargon or file paths.
+- Final list fits App Store text limits for the target storefront if provided.

package/pipeline/skills/shared/external/app-store-changelog/scripts/collect_release_changes.sh

@@ -0,0 +1,33 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+since_ref="${1:-}"
+until_ref="${2:-HEAD}"
+
+if [[ -z "${since_ref}" ]]; then
+  if git describe --tags --abbrev=0 >/dev/null 2>&1; then
+    since_ref="$(git describe --tags --abbrev=0)"
+  fi
+fi
+
+range=""
+if [[ -n "${since_ref}" ]]; then
+  range="${since_ref}..${until_ref}"
+else
+  range="${until_ref}"
+fi
+
+repo_root="$(git rev-parse --show-toplevel)"
+
+printf "Repo: %s\n" "${repo_root}"
+if [[ -n "${since_ref}" ]]; then
+  printf "Range: %s..%s\n" "${since_ref}" "${until_ref}"
+else
+  printf "Range: start..%s (no tags found)\n" "${until_ref}"
+fi
+
+printf "\n== Commits ==\n"
+git log --reverse --date=short --pretty=format:'%h|%ad|%s' ${range}
+
+printf "\n\n== Files Touched ==\n"
+git log --reverse --name-only --pretty=format:'--- %h %s' ${range} | sed '/^$/d'

package/pipeline/skills/shared/external/architecture/SKILL.md

@@ -10,17 +10,15 @@ date_added: "2026-02-27"
 
 > "Requirements drive architecture. Trade-offs inform decisions. ADRs capture rationale."
 
-## 🎯 Selective Reading Rule
+## 📑 Topics
 
-**Read ONLY files relevant to the request!** Check the content map, find what you need.
-
-| File | Description | When to Read |
+| Topic | Covers | When it applies |
 |------|-------------|--------------|
-| `context-discovery.md` | Questions to ask, project classification | Starting architecture design |
-| `trade-off-analysis.md` | ADR templates, trade-off framework | Documenting decisions |
-| `pattern-selection.md` | Decision trees, anti-patterns | Choosing patterns |
-| `examples.md` | MVP, SaaS, Enterprise examples | Reference implementations |
-| `patterns-reference.md` | Quick lookup for patterns | Pattern comparison |
+| Context discovery | Questions to ask, project classification | Starting architecture design |
+| Trade-off analysis | ADR templates, trade-off framework | Documenting decisions |
+| Pattern selection | Decision trees, anti-patterns | Choosing patterns |
+| Worked examples | MVP, SaaS, Enterprise examples | Reference implementations |
+| Patterns reference | Quick lookup for patterns | Pattern comparison |
 
 ---
 

package/pipeline/skills/shared/external/debugging-strategies/SKILL.md

@@ -30,8 +30,4 @@ Transform debugging from frustrating guesswork into systematic problem-solving w
 - Form hypotheses and design controlled experiments.
 - Narrow scope with binary search and targeted instrumentation.
 - Document findings and verify the fix.
-- If detailed playbooks are required, open `resources/implementation-playbook.md`.
 
-## Resources
-
-- `resources/implementation-playbook.md` for detailed debugging patterns and checklists.

package/pipeline/skills/shared/external/fastapi-pro/SKILL.md

@@ -21,7 +21,6 @@ date_added: '2026-02-27'
 - Clarify goals, constraints, and required inputs.
 - Apply relevant best practices and validate outcomes.
 - Provide actionable steps and verification.
-- If detailed examples are required, open `resources/implementation-playbook.md`.
 
 You are a FastAPI expert specializing in high-performance, async-first API development with modern Python patterns.
 

package/pipeline/skills/shared/external/github-actions-templates/SKILL.md

@@ -20,7 +20,6 @@ Production-ready GitHub Actions workflow patterns for testing, building, and dep
 - Clarify goals, constraints, and required inputs.
 - Apply relevant best practices and validate outcomes.
 - Provide actionable steps and verification.
-- If detailed examples are required, open `resources/implementation-playbook.md`.
 
 ## Purpose
 
@@ -79,8 +78,6 @@ jobs:
         files: ./coverage/lcov.info
 ```
 
-**Reference:** See `assets/test-workflow.yml`
-
 ### Pattern 2: Build and Push Docker Image
 
 ```yaml
@@ -134,8 +131,6 @@ jobs:
         cache-to: type=gha,mode=max
 ```
 
-**Reference:** See `assets/deploy-workflow.yml`
-
 ### Pattern 3: Deploy to Kubernetes
 
 ```yaml
@@ -208,8 +203,6 @@ jobs:
       run: pytest
 ```
 
-**Reference:** See `assets/matrix-build.yml`
-
 ## Workflow Best Practices
 
 1. **Use specific action versions** (@v4, not @latest)
@@ -334,13 +327,6 @@ jobs:
           }
 ```
 
-## Reference Files
-
-- `assets/test-workflow.yml` - Testing workflow template
-- `assets/deploy-workflow.yml` - Deployment workflow template
-- `assets/matrix-build.yml` - Matrix build template
-- `references/common-workflows.md` - Common workflow patterns
-
 ## Related Skills
 
 - `gitlab-ci-patterns` - For GitLab CI workflows

package/pipeline/skills/shared/external/hig-components-content/SKILL.md

@@ -26,18 +26,18 @@ Check for `.claude/apple-design-context.md` before asking questions. Use existin
 
 7. **Optimize for performance.** Use lazy loading, cell reuse, pagination, and prefetching for large datasets.
 
-## Reference Index
-
-| Reference | Topic | Key content |
-|---|---|---|
-| [charts.md](references/charts.md) | Charts | Swift Charts, bar/line/area/point marks, chart accessibility, audio graphs |
-| [collections.md](references/collections.md) | Collections | Grid/list layouts, compositional layout, selection, reordering, diffable data sources |
-| [image-views.md](references/image-views.md) | Image Views | Aspect ratio handling, content modes, SF Symbol images, accessibility |
-| [image-wells.md](references/image-wells.md) | Image Wells | Drag-and-drop image selection, macOS-specific, placeholder content |
-| [color-wells.md](references/color-wells.md) | Color Wells | Color selection UI, system color picker, custom color spaces |
-| [web-views.md](references/web-views.md) | Web Views | WKWebView, SFSafariViewController, navigation controls, content restrictions |
-| [activity-views.md](references/activity-views.md) | Activity Views | Share sheets, activity items, custom activities, action extensions |
-| [lockups.md](references/lockups.md) | Lockups | Image+text elements, tvOS card layouts, focus effects, shelf layouts |
+## Topics
+
+| Topic | Key content |
+|---|---|
+| Charts | Swift Charts, bar/line/area/point marks, chart accessibility, audio graphs |
+| Collections | Grid/list layouts, compositional layout, selection, reordering, diffable data sources |
+| Image Views | Aspect ratio handling, content modes, SF Symbol images, accessibility |
+| Image Wells | Drag-and-drop image selection, macOS-specific, placeholder content |
+| Color Wells | Color selection UI, system color picker, custom color spaces |
+| Web Views | WKWebView, SFSafariViewController, navigation controls, content restrictions |
+| Activity Views | Share sheets, activity items, custom activities, action extensions |
+| Lockups | Image+text elements, tvOS card layouts, focus effects, shelf layouts |
 
 ## Component Selection Guide
 
@@ -54,7 +54,7 @@ Check for `.claude/apple-design-context.md` before asking questions. Use existin
 
 ## Output Format
 
-1. **Component recommendation with rationale**, referencing the relevant HIG reference file.
+1. **Component recommendation with rationale**, referencing the relevant HIG topic.
 2. **Configuration guidance** -- key properties and setup.
 3. **Accessibility requirements** for the recommended component.
 4. **Platform-specific notes** for targeted platforms.

package/pipeline/skills/shared/external/hig-components-layout/SKILL.md

@@ -28,22 +28,22 @@ Check for `.claude/apple-design-context.md` before asking questions. Use existin
 
 8. **Prefer system components.** UINavigationController, UISplitViewController, NavigationSplitView, and TabView provide built-in adaptivity, accessibility, and state restoration.
 
-## Reference Index
-
-| Reference | Topic | Key content |
-|---|---|---|
-| [sidebars.md](references/sidebars.md) | Sidebars | Source lists, selection state, collapsible sections, iPad/Mac patterns |
-| [column-views.md](references/column-views.md) | Column Views | Finder-style browsing, progressive disclosure through columns |
-| [outline-views.md](references/outline-views.md) | Outline Views | Expandable hierarchies, disclosure triangles, tree structures |
-| [split-views.md](references/split-views.md) | Split Views | Two/three column layouts, NavigationSplitView, adaptive collapse |
-| [tab-views.md](references/tab-views.md) | Tab Views | Segmented tabs, page-style tabs, macOS tab grouping |
-| [tab-bars.md](references/tab-bars.md) | Tab Bars | Bottom tab bars (iOS), badge counts, max tab count |
-| [scroll-views.md](references/scroll-views.md) | Scroll Views | Paging, scroll indicators, content insets, pull-to-refresh |
-| [windows.md](references/windows.md) | Windows | macOS/visionOS window management, sizing, full-screen, restoration |
-| [panels.md](references/panels.md) | Panels | Inspector panels, utility panels, floating panels, macOS conventions |
-| [lists-and-tables.md](references/lists-and-tables.md) | Lists and Tables | Plain/grouped/inset-grouped styles, swipe actions, section headers |
-| [boxes.md](references/boxes.md) | Boxes | Content grouping containers, labeled boxes, macOS grouping |
-| [ornaments.md](references/ornaments.md) | Ornaments | visionOS toolbar attachments, positioning, visibility |
+## Topics
+
+| Topic | Key content |
+|---|---|
+| Sidebars | Source lists, selection state, collapsible sections, iPad/Mac patterns |
+| Column Views | Finder-style browsing, progressive disclosure through columns |
+| Outline Views | Expandable hierarchies, disclosure triangles, tree structures |
+| Split Views | Two/three column layouts, NavigationSplitView, adaptive collapse |
+| Tab Views | Segmented tabs, page-style tabs, macOS tab grouping |
+| Tab Bars | Bottom tab bars (iOS), badge counts, max tab count |
+| Scroll Views | Paging, scroll indicators, content insets, pull-to-refresh |
+| Windows | macOS/visionOS window management, sizing, full-screen, restoration |
+| Panels | Inspector panels, utility panels, floating panels, macOS conventions |
+| Lists and Tables | Plain/grouped/inset-grouped styles, swipe actions, section headers |
+| Boxes | Content grouping containers, labeled boxes, macOS grouping |
+| Ornaments | visionOS toolbar attachments, positioning, visibility |
 
 ## Navigation Pattern Selection
 

package/pipeline/skills/shared/external/hig-components-status/SKILL.md

@@ -46,13 +46,13 @@ Check for `.claude/apple-design-context.md` before asking questions. Use existin
 
 14. **Celebrate completions** with animation and haptics when rings close.
 
-## Reference Index
+## Topics
 
-| Reference | Topic | Key content |
-|---|---|---|
-| [progress-indicators.md](references/progress-indicators.md) | Progress bars and spinners | Determinate, indeterminate, inline placement, duration |
-| [status-bars.md](references/status-bars.md) | iOS/iPadOS status bar | System info, visibility, style, safe areas |
-| [activity-rings.md](references/activity-rings.md) | watchOS activity rings | Move/Exercise/Stand, HealthKit, fitness tracking, color |
+| Topic | Key content |
+|---|---|
+| Progress bars and spinners | Determinate, indeterminate, inline placement, duration |
+| iOS/iPadOS status bar | System info, visibility, style, safe areas |
+| watchOS activity rings | Move/Exercise/Stand, HealthKit, fitness tracking, color |
 
 ## Output Format
 

package/pipeline/skills/shared/external/hig-components-system/SKILL.md

@@ -58,19 +58,19 @@ Check for `.claude/apple-design-context.md` before asking questions. Use existin
 
 14. **Surface key actions to Siri and Spotlight.** Define shortcuts for frequent tasks. Use natural, conversational trigger phrases.
 
-## Reference Index
-
-| Reference | Topic | Key content |
-|---|---|---|
-| [widgets.md](references/widgets.md) | Widgets | Glanceable info, sizes, deep linking, timeline |
-| [live-activities.md](references/live-activities.md) | Live Activities | Real-time tracking, Dynamic Island, Lock Screen |
-| [notifications.md](references/notifications.md) | Notifications | Attention, actions, grouping, content |
-| [complications.md](references/complications.md) | Complications | Watch face data, families, budgeted updates |
-| [home-screen-quick-actions.md](references/home-screen-quick-actions.md) | Quick actions | Haptic Touch, common tasks, SF Symbols |
-| [top-shelf.md](references/top-shelf.md) | Top shelf | Featured content, showcase |
-| [app-clips.md](references/app-clips.md) | App Clips | Instant use, lightweight, focused task, NFC/QR |
-| [watch-faces.md](references/watch-faces.md) | Watch faces | Custom complications, face sharing |
-| [app-shortcuts.md](references/app-shortcuts.md) | App Shortcuts | Siri, Spotlight, voice triggers |
+## Topics
+
+| Topic | Key content |
+|---|---|
+| Widgets | Glanceable info, sizes, deep linking, timeline |
+| Live Activities | Real-time tracking, Dynamic Island, Lock Screen |
+| Notifications | Attention, actions, grouping, content |
+| Complications | Watch face data, families, budgeted updates |
+| Quick actions | Haptic Touch, common tasks, SF Symbols |
+| Top shelf | Featured content, showcase |
+| App Clips | Instant use, lightweight, focused task, NFC/QR |
+| Watch faces | Custom complications, face sharing |
+| App Shortcuts | Siri, Spotlight, voice triggers |
 
 ## Output Format
 

package/pipeline/skills/shared/external/hig-foundations/SKILL.md

@@ -28,28 +28,28 @@ Check for `.claude/apple-design-context.md` before asking questions. Use existin
 
 8. **Use motion purposefully.** Animation should communicate meaning and spatial relationships. Honor Reduce Motion by providing crossfade alternatives.
 
-## Reference Index
-
-| Reference | Topic | Key content |
-|---|---|---|
-| [accessibility.md](references/accessibility.md) | Accessibility | VoiceOver, Dynamic Type, color contrast, motor accessibility, Switch Control, audio descriptions |
-| [app-icons.md](references/app-icons.md) | App Icons | Icon grid, platform-specific sizes, single focal point, no transparency |
-| [branding.md](references/branding.md) | Branding | Integrating brand identity within Apple's design language, subtle branding, custom tints |
-| [color.md](references/color.md) | Color | System colors, Dynamic Colors, semantic colors, custom palettes, contrast ratios |
-| [dark-mode.md](references/dark-mode.md) | Dark Mode | Elevated surfaces, semantic colors, adapted palettes, vibrancy, testing in both modes |
-| [icons.md](references/icons.md) | Icons | Glyph icons, SF Symbols integration, custom icon design, icon weights, optical alignment |
-| [images.md](references/images.md) | Images | Image resolution, @2x/@3x assets, vector assets, image accessibility |
-| [immersive-experiences.md](references/immersive-experiences.md) | Immersive Experiences | AR/VR design, spatial immersion, comfort zones, progressive immersion levels |
-| [inclusion.md](references/inclusion.md) | Inclusion | Diverse representation, non-gendered language, cultural sensitivity, inclusive defaults |
-| [layout.md](references/layout.md) | Layout | Margins, spacing, alignment, safe areas, adaptive layouts, readable content guides |
-| [materials.md](references/materials.md) | Materials | Vibrancy, blur, translucency, system materials, material thickness |
-| [motion.md](references/motion.md) | Motion | Animation curves, transitions, continuity, Reduce Motion support, physics-based motion |
-| [privacy.md](references/privacy.md) | Privacy | Permission requests, usage descriptions, privacy nutrition labels, minimal data collection |
-| [right-to-left.md](references/right-to-left.md) | Right-to-Left | RTL layout mirroring, bidirectional text, icons that flip, exceptions |
-| [sf-symbols.md](references/sf-symbols.md) | SF Symbols | Symbol categories, rendering modes, variable color, custom symbols, weight matching |
-| [spatial-layout.md](references/spatial-layout.md) | Spatial Layout | visionOS window placement, depth, ergonomic zones, Z-axis design |
-| [typography.md](references/typography.md) | Typography | SF Pro, Dynamic Type sizes, text styles, custom fonts, font weight hierarchy, line spacing |
-| [writing.md](references/writing.md) | Writing | UI copy guidelines, tone, capitalization rules, error messages, button labels, conciseness |
+## Topics
+
+| Topic | Key content |
+|---|---|
+| Accessibility | VoiceOver, Dynamic Type, color contrast, motor accessibility, Switch Control, audio descriptions |
+| App Icons | Icon grid, platform-specific sizes, single focal point, no transparency |
+| Branding | Integrating brand identity within Apple's design language, subtle branding, custom tints |
+| Color | System colors, Dynamic Colors, semantic colors, custom palettes, contrast ratios |
+| Dark Mode | Elevated surfaces, semantic colors, adapted palettes, vibrancy, testing in both modes |
+| Icons | Glyph icons, SF Symbols integration, custom icon design, icon weights, optical alignment |
+| Images | Image resolution, @2x/@3x assets, vector assets, image accessibility |
+| Immersive Experiences | AR/VR design, spatial immersion, comfort zones, progressive immersion levels |
+| Inclusion | Diverse representation, non-gendered language, cultural sensitivity, inclusive defaults |
+| Layout | Margins, spacing, alignment, safe areas, adaptive layouts, readable content guides |
+| Materials | Vibrancy, blur, translucency, system materials, material thickness |
+| Motion | Animation curves, transitions, continuity, Reduce Motion support, physics-based motion |
+| Privacy | Permission requests, usage descriptions, privacy nutrition labels, minimal data collection |
+| Right-to-Left | RTL layout mirroring, bidirectional text, icons that flip, exceptions |
+| SF Symbols | Symbol categories, rendering modes, variable color, custom symbols, weight matching |
+| Spatial Layout | visionOS window placement, depth, ergonomic zones, Z-axis design |
+| Typography | SF Pro, Dynamic Type sizes, text styles, custom fonts, font weight hierarchy, line spacing |
+| Writing | UI copy guidelines, tone, capitalization rules, error messages, button labels, conciseness |
 
 ## Applying Foundations Together
 
@@ -67,7 +67,7 @@ Consider how principles interact:
 
 ## Output Format
 
-1. **Cite the specific HIG foundation** with file and section.
+1. **Cite the specific HIG foundation** by topic and section.
 2. **Note platform differences** for the user's target platforms.
 3. **Provide concrete code patterns** (SwiftUI/UIKit/AppKit).
 4. **Explain accessibility impact** (contrast ratios, Dynamic Type scaling, VoiceOver behavior).