GSkillPacks

Add `bin/skillpacks.mjs`.

Add `CHANGELOG.md` entries for v0.1 in each skill directory.

Add `doctor --fix --agent-docs [--dry-run]` for marker-bounded generated block replacement only.

Add `doctor --fix` to clean generated skill-root drift without touching agent docs.

Add `game-afps` to `packages/skillpacks/scripts/build-skillpacks-manifest.mjs`.

Add `packages/skillpacks/package.json` with the publishable package metadata.

Add `packages/skillpacks/scripts/build-skillpacks-manifest.mjs`.

Add `packs/product-design/codex/user-flow-map/` and `packs/product-design/claude/user-flow-map/`.

Add `Report-First Approval Gate`, `Staged Research Workflow`, and `Evidence And Feedback Handling`.

Add `scripts/catalog/*.mjs` helpers for frontmatter parsing, pack/skill scanning, archive discovery, benchmark report discovery, and content hashing.

Add `scripts/researchish-skill-lifecycle-audit.mjs`.

Add `skillpacks install-deck <deck>` and `skillpacks install-deck business-afps --full`.

Add `skillpacks list --json` using the manifest.

Add `src/cli/run-pack-script.mjs` or equivalent dispatcher.

Add `ui-interview`-specific alignment guidance requiring a visible interview-stage explainer.

Add `user-flow-map` to the alignment generator and regenerate alignment-page stubs.

Add a `Deck Fit Handoff` rule that reads canonical deck metadata and `.agents/project.json` `saved_decks` / `decks`.

Add a clear review-stage answer: `requirements-only` review now, full interview only when the skill is run interactively or rerun without `--requirements-only`.

Add a dated history entry and ship manifest.

Add a dated Product Design & Spec card for the walkthrough page.

Add a lesson for future addenda that introduce new decisions.

Add a lesson preventing future alignment-page chart clipping.

Add a lesson preventing research synthesis before alignment-scope approval.

Add a Node-owned `skillpacks init` command that installs global-scope skills as project-local base skills under `.claude/skills` and `.codex/skills`.

Add a package build script that stages only package-owned code, canonical skill sources, required install scripts, and selected docs into `packages/skillpacks/build/`.

Add a package test that asserts Game AFPS resolves to the `game` pack and carries the right registry tags.

Add a Playwright spike test or document a dependency/install blocker before shipping.

Add a required deck-installation approval gate covering COA A/B/C behavior.

Add a root `scripts/init-agentic-skills.sh` wrapper that delegates to the bundled `init-agentic-skills` launcher.

Add active roadmap and todo entries before substantive audit work.

Add active roadmap and todo entries before substantive edits.

Add active roadmap and todo tracking before implementation.

Add AFPS graduation output requirements to `consolidate-prototypes`.

Add alignment-page metadata, TTS includes, and index entries for the two untracked alignment pages.

Add benchmark coverage metadata or an explicit deferred coverage path.

Add current npm registry preflight findings for `skillpacks` and `agentic-skills`.

Add dependency checks for `bash` and write-command `jq`.

Add deprecated `consolidate-variations` compatibility aliases for Claude and Codex.

Add focused Layer 1 coverage for malformed Codex `state-model` paths and missing chunked progress copy.

Add focused lifecycle fixtures for legacy and foreign marker cases.

Add focused lifecycle tests for base init, refresh, and prune expectations.

Add focused lifecycle tests.

Add Game AFPS to `docs/decks.md`.

Add Game AFPS to `docs/skillpacks-npm-distribution.md`.

Add layer1 coverage for staged markers, skip-list bundles, non-research `_working` misuse, and stable JSON categories/counts.

Add lifecycle coverage for read-only doctor, fix-only cleanup, dry-run agent-doc diff, backup/write migration, text preservation, and refusal cases.

Add lifecycle coverage proving `skillpacks install exec` installs the individual `exec` skill and does not enable `exec-loop`.

Add manifest `--check` validation for existing paths, version fields, deck pack references, package-list fields, and registry-tag fields.

Add migration guidance for users moving from a local clone to `npx skillpacks`.

Add npm script entry points for package and root invocation.

Add or extend package-owned tests that pin the release-readiness documentation language.

Add or update focused layer1 checks that pin the fallback contract.

Add package changelog and task review records for the pending `0.1.10` release.

Add package-owned Node helpers for `.agents/project.json` reads and writes.

Add package-owned tests that run with `PATH` emptied to prove no shell/JQ dependency.

Add Playwright as local implementation proof tooling if dependency installation succeeds.

Add prevention lesson.

Add review notes to `tasks/todo.md`.

Add review notes to `tasks/todo.md`.

Add review notes to `tasks/todo.md`.

Add root `package.json` for `skillpacks`.

Add targeted executable checks for manifest generation and deck install resolution.

Add targeted lifecycle/CLI regression tests.

Add the `0.1.9` package changelog entry and correct the stale `0.1.8` publication wording.

Add the active roadmap and todo entries before implementation.

Add the downstream portability addendum covering macOS stock Bash compatibility and Bash 3.2 failures in inventory scripts.

Add the pack-install script surface follow-up covering `pack.sh`, no-hot-reload/install visibility guidance, downstream/manual runnable readiness, and the `scripts/init-agentic-skills.sh` path mismatch.

Add the plain-text clarification that deterministic repeatable primitives should become scripts or script-backed utilities, with `compile-central-alignment` as the primary extraction candidate.

Add the smallest route spike that proves shallow `pushState`, `usePathname`, `popstate`, and `/deck/[slug]` hard-load behavior.

Add the standard `## Alignment Page` stub.

Add troubleshooting for npm package semver vs skill-level pinning.

Add unit coverage for `exec`, `exec-loop`, exact pack title, rejected aliases, rejected fuzzy names, and exact skill names.

Add visible amendment notes to the three active pages.

Add workspace recognition for `apps/skills-showcase` and `packages/skillpacks`.

Add/adjust lifecycle tests and changelog entry.

Archive `alignment/idea-scope-brief-npm-distribution.html`.

Archive `alignment/idea-scope-brief-skills-showcase.html`.

Archive `alignment/workflow-design-three-pipelines.html`.

Archive `global/codex/idea-scope-brief/SKILL.md` with `scripts/skill-archive.sh`.

Archive and bump active skills whose behavior changes before publish.

Archive and bump existing skill mirrors before editing their `SKILL.md` contracts.

Archive and bump mirrored `state-model` skills from `v0.3` to `v0.4`; fix Codex malformed paths and add explicit progress-handoff requirements.

Archive and bump mirrored `ux-variations` skills from `v0.23` to `v0.24`; add explicit progress-handoff requirements.

Archive and bump versions for every active skill whose behavior/output guidance changes, and update `CHANGELOG.md`.

Archive and rename mirrored primary consolidation skills to `consolidate-prototypes`.

Archive changed active `SKILL.md` files before version bumps.

Archive current Codex and Claude `v0.4` skill mirrors.

Archive current skill versions before contract edits.

Archive the current active page before replacement.

Archive the current review page and non-canonical working packet under `docs/history/archive/2026-06-11/142531/`.

Archive the prior review alignment page and convert the active page to `confirmed`.

Assert npm metadata against the package name/version/license.

Audit `tasks/todo.md`, `tasks/roadmap.md`, manual/advisory task docs, phase archives, history, and recent git commits.

Avoid skill/pack catalog generated-data changes when tracked `SKILL.md` / `PACK.md` metadata does not change.

Build `alignment/devtool-docs-audit-docs-freshness.html`.

Build `alignment/ui-interview-skill-execution-handoff.html` in `review` state with the full working packet rendered inline and required gates.

Build a `review` alignment page with evidence matrix, assumptions, gaps, and approval/feedback controls.

Bump `version:` from `v0.15` to `v0.16`.

Bump active mirrors to `v0.5` and add the `Pack Availability Guard`.

Bump changed skill versions and update each skill `CHANGELOG.md`.

Bump each active scan skill from `version: v0.0` to `version: v0.1`.

Capture prompt history and local package context.

Capture prompt history for the active skill update.

Capture prompt history for the active skill-building workflows.

Capture the visible `$exec p1 and p2 again` invocation.

Capture the visible `$investigate` invocation under `prompts/investigate/`.

Capture the visible `$investigate` invocation under `prompts/investigate/`.

Capture the visible `$reconcile-dev-docs fix tasks` invocation.

Capture the visible `$ship-end` invocation under `prompts/ship-end/`.

Capture the visible `devtool-docs-audit` invocation in `prompts/devtool-docs-audit/`.

Capture the visible `devtool-docs-audit` invocation under `prompts/devtool-docs-audit/`.

Capture the visible `exec` invocation in `prompts/exec/`.

Capture the visible `exec` invocation under `prompts/exec/`.

Capture the visible `idea-scope-brief` approval YAML under `prompts/idea-scope-brief/`.

Capture the visible `idea-scope-brief` approval YAML under `prompts/idea-scope-brief/`.

Capture the visible `investigate` invocation under `prompts/investigate/`.

Capture the visible `investigate` invocation under `prompts/investigate/`.

Capture the visible `targeted-skill-builder` invocation under `prompts/targeted-skill-builder/`.

Capture the visible Browser verification invocation under `prompts/browser/`.

Capture the visible Computer Use verification invocation under `prompts/computer-use/`.

Capture the visible invocation under `prompts/exec/` and `prompts/animation-design-planner/`.

Capture the visible invocation under `prompts/exec/`.

Capture the visible invocation under `prompts/exec/`.

Capture the visible invocation under `prompts/pack/`.

Capture the visible invocation under `prompts/pack/`.

Capture the visible invocation under `prompts/targeted-skill-builder/`.

Capture the visible invocation under `prompts/targeted-skill-builder/`.

Capture the visible prompt under `prompts/ui-interview/`.

Capture the visible user invocation under `prompts/create-agentic-skill/`.

Capture visible `$ui-interview --requirements-only skill-execution-handoff` handoff prompt history.

Capture visible `$user-flow-map skills-showcase skill-execution-handoff` prompt history.

Carry corrected persona wording into the proposed spec and interview log.

Check canonical workflow/routing docs against active skill contracts and recent rename/routing work.

Check docs that mention missing or moved paths, stale commands, retired skill names, or generated-file conventions.

Check git status and package metadata.

Check npm auth and skip `./publish.sh --dry-run patch` because `npm whoami --registry https://registry.npmjs.org/` currently fails with npm `E401`.

Check README/AGENTS/setup docs against current scripts, pack commands, init flow, and skill layout.

Check whether any existing skill already owns user-flow mapping.

Check working tree cleanliness and tracked alignment pages.

Clarify `new` marker behavior with dated meta text.

Classify core routing skills separately from repeated pack-availability guard updates.

Classify each in-scope skill into exactly one category: `staged-research`, `alignment-document`, `direct-utility`, or `misclassified`.

Commit and push intended audit artifacts without staging unrelated pre-existing work.

Commit and push intended changes on `master`.

Commit and push intended changes on `master`.

Commit and push intended changes on the primary branch.

Commit and push intended changes on the primary branch.

Commit and push intended changes on the primary branch.

Commit and push intended changes only, leaving unrelated worktree changes untouched.

Commit and push intended changes only.

Commit and push intended changes.

Commit and push intended files on `master`.

Commit and push intended files on the primary branch.

Commit and push intended Phase 4 changes only.

Commit and push intended Phase 5 changes only.

Commit and push intended readiness artifacts on the primary branch if validation allows.

Commit and push intended source, report, task, and generated-data changes on the primary branch.

Commit and push intended tracked changes if validation passes.

Commit and push intended tracked changes.

Commit and push intended tracked changes.

Commit and push intended tracked changes.

Commit and push intended tracked changes.

Commit and push intended tracked changes.

Commit and push metadata cleanup before any real publish attempt.

Commit and push on `master`.

Commit and push only prompt/task/history/manifest files.

Commit and push task-doc reconciliation changes.

Commit and push the intended changes only.

Commit and push the intended changes.

Commit and push the intended changes.

Commit and push the intended tracked changes while leaving unrelated work untouched.

Commit and push the intended tracked changes.

Commit and push the publish-prep source state so the real `./publish.sh patch` can run from a clean tree.

Commit the convention and regenerated files together.

Compare alignment-page convention requirements across canonical docs, generated bundles, active HTML pages, and audit scripts.

Compare CLI command names and npm/package usage across root docs, package docs, skill docs, and alignment pages.

Compare deck/pack names and counts across docs, manifests, generated maps, and package tests.

Compare related YouTube pack skills for routing and naming overlap.

Compare the new approval against the previously shipped roadmap prompt.

Compare workflow/git/shipping instructions across `AGENTS.md`, `CLAUDE.md`, and repo docs.

Confirm `alignment/index.html` is untracked and should remain a local convenience artifact.

Confirm `packages/skillpacks/build/package.json` is `0.1.1`.

Confirm current docs define `npx skillpacks install <pack-or-skill>` and `npx skillpacks install-deck <deck>` as the package install routes.

Confirm existing source-checkout routes remain valid.

Confirm generated bundles are exact with `node scripts/upgrade-alignment-page.mjs --check`.

Confirm generated count terms still match current generated data.

Confirm it is already tracked in `7ac9ebc3 docs: audit skillpacks cli routing gaps`.

Confirm it is prompt-history bookkeeping only and contains no obvious secret.

Confirm license/package metadata choice based on repository files.

Confirm repository context and working-tree state.

Confirm the compiled gate list includes the new deck-installation gate.

Confirm the dry-run reports `skillpacks@0.1.1`.

Confirm the exact publish boundary: `skillpacks@0.1.0`, public access, MIT metadata, npm links, and `packages/skillpacks/build` as the publish root.

Confirm the public registry does not already contain `skillpacks@0.1.1`.

Convert `alignment/animation-design-planner-deck-builder-transitions.html` to confirmed with read-only decision records and the approval YAML preserved.

Convert the full working packet from raw Markdown preview into readable HTML sections and tables.

Copy each target page to `docs/history/archive/2026-06-07/180623/alignment/` before editing.

Cover prerequisites, first-use flow, generated files, remove/update flow, versioning, published-package verification, and troubleshooting.

Create `alignment/skillpacks-npm-package-walkthrough.html` with confirmed status, document-tier metadata, responsive viewport, TTS include, and current `skillpacks@0.1.0` / `latest` package status.

Create a reusable script under `packages/skillpacks/scripts/`.

Create mirrored Codex and Claude `youtube-video-prelaunch-audit` skill directories in `packs/youtube-ops/`.

Create the `prompts/ship/` capture for `$ship`.

Decide and implement the focused validation rule that prevents install-route text from omitting `npx skillpacks install` or `npx skillpacks install-deck` unless explicitly allowlisted.

Define acceptable treatments such as inline badges, highlighted blocks, or side-by-side before/after sections.

Define compiled responses as a mixed YAML payload containing answered gates, selected `section_feedback`, and unanswered required gate count/status for partial responses.

Define count terms from generated data: platform entries, unique mirrored skills, unique pack skills, unique global skills, active packs, and display cards.

Define persona, goal, success condition, and triggering context.

Define runner-specific dual-route wording for Claude, Codex, individual skill installs, pack installs, source-checkout maintenance, and deck installs.

Document that real `npm publish` is out of scope for this pass.

Draft Flow Assumptions Checkpoint from evidence.

Draft the separate-repo `$idea-scope-brief` prompt.

Draft the UI Assumptions Manifest, content requirements manifest, page/entity/action/state matrices, coverage checkpoint, and interview record.

Ensure the skill outputs `specs/user-flow-[topic].md`, `user-flow-[topic]-interview.md`, and `alignment/user-flow-map-{topic}.html`.

Enumerate active `SKILL.md` files under `global/` and `packs/`, excluding `archive/**`.

Enumerate Markdown, HTML alignment, package docs, skill docs, prompt/task docs, and generated docs that should be checked.

Extract the approved proposed spec and interview log from `alignment/user-flow-map-skill-execution-handoff.html`.

Fix MIT license metadata, npm repository links, staged package metadata, and package metadata coverage.

Fix publish-blocking contract/version inconsistencies found during release prep.

Flow coverage was reviewed in the prior conversation context.

For confirmed true research producers, keep the 4-step staged workflow and correct lifecycle metadata.

For misclassified skills, change `type:` to the correct existing category while preserving intended behavior.

Forward current `pack.sh` commands while preserving consumer project `cwd`.

Generate `packages/skillpacks/dist/skillpacks-manifest.json` from `global/`, `packs/`, `PACK.md`, and `SKILL.md` frontmatter.

Generate `research/researchish-skill-lifecycle-audit.md` from audit output.

Identify any active skill that still requires `pack` to install packs or skills.

Identify canonical sources versus generated or historical artifacts to avoid false positives.

Identify install-routing, pack-availability guard, and missing-skill fallback references.

Identify minimal high-confidence cleanup actions and larger follow-up remediation work.

Identify non-blocking legacy/fallback references that should be rewritten before archival.

Identify that the tracked CLI entrypoint imports an untracked `update-check.mjs` module.

Identify the root cause and affected layout rules.

Implement `init-global` by invoking packaged `init.sh`.

Implement `uninstall-global --reinstall-base`.

Implement change-count refresh behavior and dry-run planner summary.

Implement the global install detector and refresh warning/exit behavior.

In a fresh temp project, install one pack, one individual skill, and one deck from the published package.

Include `packages/skillpacks/dist/skillpacks-manifest.json` in the package allowlist.

Include `SKILL.md`, `CHANGELOG.md`, `agents/openai.yaml`, and generated `ALIGNMENT-PAGE.md` for both mirrors.

Include approval gates for evidence coverage, assumptions, flow map, branch/state/handoff coverage, artifact destination, proposed file changes, and downstream route.

Include counts by category.

Include deck metadata for `vard`, `ord`, `business-afps`, and `devtool-afps` with package-list and registry-tag fields.

Include pack names, skill names, tools, versions, content hashes, archive versions, source paths, and status.

Inspect active consolidation, research-roadmap, spec-interview, routing, and generated catalog contracts.

Inspect active mirrors, changelogs, archive state, routing audit expectations, and git status.

Inspect current `skillpacks` CLI, pack lifecycle, init, docs, and git history.

Inspect current release metadata, task tracking, package version state, and release runbook.

Inspect existing pack, deck, install, and versioning docs.

Inspect git status, unpushed commits, task docs, manual tasks, advisory tasks, and deploy contract.

Inspect install resolution code, tests, and recent history.

Inspect lifecycle CLI, provision templates, routing audit, docs, and existing task state.

Inspect lifecycle implementation and tests for refresh/install/remove behavior.

Inspect release state, package version, generated artifacts, and changed skill contracts.

Inspect relevant research, existing user-flow specs, UX decisions, app routes, and handoff/operating-mode docs.

Inspect relevant skill contracts, schema, task docs, and repo states.

Inspect the approved npm distribution design and existing script contracts.

Inspect the current `ui-interview` review page and working packet.

Inspect the Graduation Path chart markup and CSS.

Inspect the staged tarball boundary and denied paths.

Inspect the three target alignment pages and `compile-central-alignment` contract.

Inventory entry points, preconditions, happy path, alternate paths, branch rules, screens/routes, failures, recovery, and handoffs.

Keep `init-global` as the explicit user-home global install path.

Keep `npx skillpacks doctor` read-only.

Keep `pack.sh` and Node command output aligned for supported aliases.

Keep `scripts/pack.sh` as a wrapper or tested fallback.

Keep `scripts/skill-pack-routing-audit.sh` focused on cross-pack availability guards unless extending it is cleaner than adding a dedicated npm-route check.

Keep canonical UI requirements files unwritten.

Keep COA A as the first package transport while making `install-deck` a resolver over COA B/C-compatible metadata.

Keep command ownership/dependency docs aligned with the CLI compatibility matrix.

Keep downstream research routing as secondary context after deck selection.

Keep existing `pnpm --dir apps/skills-showcase ...` commands working during the transition.

Keep final approval limited to `approval_status: ready-for-agent-review` only when all required gates are answered and no unresolved negative or clarification feedback remains.

Keep generated outputs under `apps/skills-showcase/public/assets/`, the temporary `docs/skills-showcase/assets/` mirror, and the website-owned benchmark matrix.

Keep index counts and metadata consistent with the existing card format.

Keep the audit script read-only except when report generation is explicitly redirected by the agent.

Keep the catalog layer read-only.

Leave `alignment/skills-inventory.html` untouched as a generated/static catalog.

Leave P1/P2 remediation files unchanged when no drift is found.

Leave remove behavior unchanged.

Link to the current Markdown docs for deeper reference.

List every `misclassified` skill.

List every alignment-page skill that appears to belong in `scripts/alignment-skip-list.txt`.

List every marker-compliant `type: research` skill that is semantically suspicious.

List every non-research skill with `research/` output language.

List tracked Markdown/HTML/docs artifacts across root docs, research, specs, alignment, tasks, benchmark, and pack/global skill docs.

Load the `pack` skill instructions because the request names the skill.

Locate the existing `youtube-video-audit` skill and confirm its post-release performance-audit scope.

Make `doctor` and `prune` account for project-local base skills without deleting unmanaged user content.

Make `research-roadmap --post-prototype` graduation-aware and keep cleanup narrowly scoped.

Make clear that change indicators must be visible in the HTML itself.

Make high-confidence deck fit the primary `## Next Steps` recommendation, with canonical deck installs using `npx skillpacks install-deck <deck>`.

Make source-checkout CLI execution and staged package execution both resolve `pack.sh` and `init.sh` correctly.

Make the fallback order explicit: helper script when present, WSL PowerShell `file://wsl.localhost/<distro>/...` bridge when available, `xdg-open` when available, then `failed` with absolute path.

Mark docs as current, needs update, duplicate/superseded, generated/local-only, or archive candidate.

Mark the old npm distribution strategy page and index card as historical/superseded for package usage, with the current walkthrough as the usage reference.

Mark unambiguous completed task sections as previous/completed.

Move Skills Showcase data generators and validator under `apps/skills-showcase/scripts/`.

Move the `skillpacks` CLI and source code under `packages/skillpacks/`.

Move the deck-based installation section before the review gates so it is part of the reviewed body.

Open or attempt to open the alignment page in the browser.

Patch `ux-variations` and `prototype` contracts and changelogs.

Patch active `SKILL.md` report-first and staged-research wording to require scope approval before synthesized research.

Patch archive filtering with focused tests.

Patch the canonical alignment-page convention.

Patch uninstall ownership and marker checks.

Port `.agents/.pack.lock` handling.

Port `doctor`, `pin`, `unpin`, and `prune`.

Port pack alias normalization and hibernated-pack diagnostics.

Port pack and individual skill install/remove/refresh logic.

Preserve `.agentic-skills-managed` marker creation and content hash behavior.

Preserve `pack.sh` forwarding for all existing commands.

Preserve `scripts/pack.sh` where the text is explicitly about source-checkout maintenance.

Preserve `skillpacks init` project-local install behavior.

Preserve approved decisions: `skillpacks`, hybrid COA A first, skill-level pinning, deck presets first.

Preserve existing entry dates and define how to fill missing dates.

Preserve existing status reporting semantics: `focused`, `opened`, `fallback-opened`, `blocked`, or `failed`.

Preserve explicit "no real publish in Phase 4" language.

Preserve hibernated pack/skill safety diagnostics before unknown-name failure.

Preserve historical counts only when explicitly labeled historical/prototype scope.

Preserve layout/styling and implementation as non-goals.

Preserve lightweight VARD/ORD scan criteria while moving candidate ranking into approved preliminary packets.

Preserve partial response behavior when at least one gate answer or one section feedback item exists.

Preserve rejection for unsupported `init` arguments such as `--bad`.

Preserve runner syntax exactly: Claude gets `/pack ...`; Codex gets `$pack ...`; shell guidance gets `npx skillpacks ...`.

Preserve the no-context-loss requirement without using one raw `<pre><code>` Markdown dump as the primary review surface.

Preserve the non-research `research/` and alignment skip-list candidate queues as report inventory for a later review batch instead of applying broad heuristic edits.

Preserve unrelated project config fields on writes.

Preview bundle changes with `node scripts/upgrade-alignment-page.mjs --dry-run`.

Preview bundle changes with `node scripts/upgrade-alignment-page.mjs --dry-run`.

Print unified diffs before writes and create timestamped `.agents/backups/` copies before agent-doc mutation.

Rank deck candidates by domain, tempo, and concept signals.

Re-check npm registry state for `skillpacks`.

Re-check safe npm registry/account information for `skillpacks` without publishing.

Re-read the shared alignment-page convention, existing tests, and active affected skill list.

Re-run dry-run and confirm no pending updates.

Re-run scoped stale-count and retired-route scans.

Re-run scoped stale-route, install-wording, publication-wording, historical-label, wrapper, alignment-page, generated-bundle, focused layer1, and whitespace checks.

Re-run skill-map generator syntax and regeneration.

Read `$exec`, `animation-design-planner` approval handling, task docs, app docs, and the approved alignment page.

Read `$targeted-skill-builder`, active lessons, current `idea-scope-brief`, deck docs, repo config, and task docs.

Read `prompts/pack/skill-prompt-20260610-195858-skillpack-routing-audit.md`.

Read active `ui-interview` instructions and bundled alignment contract.

Read active lessons and relevant task docs.

Read active lessons and task docs.

Read active repo instructions, lessons, task docs, and relevant alignment-page/test context.

Read current init/init-global routing, docs/help, tests, and package scripts.

Read product-design skill conventions, routing docs, research-roadmap rules, alignment generator, and benchmark coverage patterns.

Read relevant lessons and task state.

Read source evidence from the confirmed flow spec, Skills Showcase idea brief, deck-creation flow, operating-mode/approval-packet docs, and relevant app route/component files.

Read the active `$targeted-skill-builder` and `$session-triage` contracts.

Read the active `pack` skill instructions.

Read the active `ui-interview` skill instructions and bundled alignment-page contract.

Read the active `user-flow-map` skill instructions.

Read the approved alignment page and gate answers.

Read the four active scan skills and the reference staged research pattern.

Receive confirmation or corrections.

Recommend whether archiving/sunsetting is safe now or after specific follow-up edits.

Reconcile stale task bookkeeping for the already-shipped install-destination output correction.

Record active task tracking in task docs.

Record archive paths and replacement rationale in task history.

Record current handoff checklist in task docs.

Record current-phase work and review notes in `tasks/todo.md`.

Record current-phase work in `tasks/todo.md`.

Record dry-run output in the ship manifest.

Record history and the quality-gate manifest.

Record implementation progress and validation results in `tasks/todo.md`.

Record prompt history and task tracking.

Record prompt history and task tracking.

Record release evidence in a ship manifest.

Record release-readiness status and the remaining npm-auth human action in task tracking.

Record review notes and ship only intended review-page changes.

Record review notes in `tasks/todo.md`.

Record review notes in `tasks/todo.md`.

Record review notes in `tasks/todo.md`.

Record review notes in `tasks/todo.md`.

Record review notes in `tasks/todo.md`.

Record review notes in `tasks/todo.md`.

Record review notes, commit, and push intended artifacts.

Record review notes, commit, and push intended changes on `master`.

Record review notes, commit, and push intended changes on the primary branch unless blocked.

Record review notes, commit, and push intended changes.

Record review notes, commit, and push intended changes.

Record review notes, history, and a quality-gate ship manifest.

Record review notes, history, and quality-gate manifest.

Record review notes, history, and ship manifest.

Record review notes, update history, commit, and push intended changes only.

Record review notes, update history, commit, and push intended remediation artifacts only.

Record the active implementation phase in `tasks/todo.md`.

Record the audit plan in `tasks/roadmap.md` and `tasks/todo.md`.

Record the clean rerun in task docs, history, and ship manifest.

Record the revision plan in `tasks/roadmap.md` and `tasks/todo.md`.

Record the task plan in task docs.

Record the task plan in task docs.

Record this active roadmap/todo plan before implementation.

Record this plan and the active todo before implementation.

Record this roadmap and active todo before implementation.

Record this roadmap and active todo before implementation.

Record this roadmap/todo plan before implementation.

Record this validation plan before repo-wide scanning.

Record validation and review results in `tasks/todo.md`.

Record validation results in `tasks/todo.md`.

Refresh fixtures to prove valid/invalid install route behavior.

Refresh generated showcase data if required by skill metadata changes.

Refresh page/index metadata only where needed.

Refresh Skills Showcase data if required by changed skill metadata.

Refresh Skills Showcase generated data if active `SKILL.md` behavior/metadata changes require it.

Refuse missing, duplicate, malformed, or unknown provision markers safely.

Regenerate `DESIGN-TREE-LOOP.md` bundles from the convention.

Regenerate `packages/skillpacks/dist/skillpacks-manifest.json`.

Regenerate and validate Skills Showcase data.

Regenerate bundled `ALIGNMENT-PAGE.md` files from the canonical convention.

Regenerate bundled `ALIGNMENT-PAGE.md` files from the canonical source.

Regenerate bundled `ALIGNMENT-PAGE.md` files.

Regenerate generated `ALIGNMENT-PAGE.md` bundles.

Regenerate or verify `alignment/index.html` locally and keep it untracked unless repo convention forces otherwise.

Regenerate package and Skills Showcase generated artifacts from the staged skill boundary.

Regenerate package build docs/manifest if `build:check` requires it.

Regenerate showcase data and validate the public skill catalog artifacts.

Regenerate skill-map artifacts after moving `game` into its own Game AFPS row.

Regenerate Skills Showcase assets and the skillpacks manifest.

Render the full proposed interview log inline in the review alignment page.

Render the full proposed spec inline in the review alignment page.

Repair Alignmeant active artifacts with archive preservation.

Replace retired executable `icp` route examples in current docs, specs, and indexed alignment pages with `customer-discovery`, while preserving `enterprise-icp` and `research/icp.md` artifact references.

Replace the separate bottom `Compile Feedback YAML` and `Compile Answers` model with one bottom `Compile Responses` control.

Reproduce or confirm the right-edge clipping at relevant viewport widths.

Reproduce the leak path or identify the exact stale package boundary.

Require `YYYY-MM-DD` dates in muted meta spans after index links.

Require confirmed pages to remove the final `Compile Responses` button, response counters, input controls, and approval-blocking UI.

Require local section feedback textarea, local compile/copy controls, and read-only YAML output to be hidden until emphasize, thumbs-down, or clarification is selected for that section.

Require structured HTML rendering of the working packet sections, especially Markdown tables.

Research current competitor and adjacent product surfaces.

Resolve active product path to `skills-showcase`.

Resolve active product path to `skills-showcase`.

Resolve exact active pack slugs next.

Resolve exact active pack titles using trimmed/collapsed whitespace title matching.

Resolve install tokens by exact active skill name first.

Resolve the published package through `npx --package skillpacks@latest`.

Reuse the existing YouTube research-stage, feedback, alignment, handoff, and pack-availability conventions.

Review generated diff and run whitespace checks.

Review the diff for unintended generated drift.

Review the diff for unrelated changes and intended scope.

Revise `docs/alignment-page-convention.md` inside the `alignment-convention` markers.

Revise `docs/alignment-page-convention.md` inside the `alignment-convention` markers.

Rewrite the root `package.json` as private workspace metadata for `agentic-skills`.

Route `list-packs`, `status`, `set-mode`, and `set-update-mode` through Node without requiring `bash` or `jq`.

Route `skillpacks init --global` to packaged `init.sh` through the same global-core path as `init-global`.

Run `git diff --check`.

Run `git diff --check`.

Run `git diff --check`.

Run `git diff --check`.

Run `git diff --check`.

Run `git diff --check`.

Run `git diff --check`.

Run `git diff --check`.

Run `git diff --check`.

Run `git diff --check`.

Run `git diff --check`.

Run `git diff --check`.

Run `git diff --check`.

Run `node scripts/audit-alignment-pages.mjs`.

Run `node scripts/audit-alignment-pages.mjs`.

Run `node scripts/audit-alignment-pages.mjs`.

Run `node scripts/upgrade-alignment-page.mjs --check`.

Run `node scripts/upgrade-alignment-page.mjs --dry-run`.

Run `node scripts/upgrade-alignment-page.mjs` to refresh generated bundles.

Run `node scripts/upgrade-alignment-page.mjs`.

Run `node scripts/upgrade-alignment-page.mjs`.

Run `npm --workspace skillpacks run build:check`.

Run `npm --workspace skillpacks run build:check`.

Run `npm --workspace skillpacks run build:check`.

Run `npm --workspace skillpacks run build`.

Run `npm --workspace skillpacks run test:node`.

Run `npm --workspace skillpacks run test:node`.

Run `npm --workspace skillpacks run test:node`.

Run `npm --workspace skillpacks run verify:package`.

Run `npm --workspace skillpacks run verify:package`.

Run `npm pack --dry-run`.

Run `npm publish --access public` only after explicit confirmation.

Run `npm publish --dry-run --json` from `packages/skillpacks/build`.

Run `npm publish --dry-run` locally without publishing.

Run `npm whoami` against the npm registry and record whether auth is ready.

Run `pnpm --dir tests exec vitest run --project layer1 layer1/alignment-gates.test.ts`.

Run `pnpm --dir tests exec vitest run --project layer1 layer1/audit-alignment-pages.test.ts`.

Run `pnpm --dir tests exec vitest run --project layer1 layer1/upgrade-alignment-pages.test.ts`.

Run `scripts/skill-archive.sh` for the four scan skill directories.

Run `scripts/skill-install-routing-audit.sh --active`.

Run `scripts/skill-install-routing-audit.sh --fixtures tests/fixtures/skill-install-routing`.

Run alignment-page audit, root wrapper smoke checks, and whitespace checks.

Run alignment-page audit.

Run benchmark coverage validation and focused layer1 setup tests.

Run dry-run publish check without publishing.

Run focused and package verification, then review diff.

Run focused app validation, Playwright proof when available, the active alignment-page audit, and `git diff --check`.

Run focused Node test files.

Run focused package tests and package manifest/build checks.

Run focused package tests and whitespace checks.

Run focused route text checks and `./scripts/skill-install-routing-audit.sh`.

Run focused search commands and `git diff --check`.

Run focused skill metadata and route checks.

Run focused tests.

Run focused validation and record the shipping manifest.

Run generated alignment bundle, layer1, archive/version/dependency, showcase, and whitespace checks.

Run generated bundle drift checks, skill hygiene checks, focused tests, showcase refresh if needed, and whitespace checks.

Run generated bundle drift, active `type: research` staged-workflow audit, targeted marker scans, archive/changelog checks, and whitespace checks.

Run generated-bundle drift checks.

Run generated-data parsing, alignment-page audit, targeted count scans, and whitespace checks.

Run malformed-path, progress-handoff, convention, and focused test checks; fix any failures.

Run package docs tests, package staging checks, dry-run release checks, and whitespace checks.

Run package dry-run and temp consumer install checks.

Run package staging and tarball dry-run inspection.

Run package syntax/package tests, alignment audit, whitespace checks, and ship-boundary review.

Run package tests and manifest/build checks.

Run package tests and package staging checks.

Run package verification and diff hygiene.

Run package verification and review diff hygiene.

Run release gates without publishing.

Run relevant documentation and alignment validators.

Run requested verification gates and inspect generated diff.

Run requested verification gates and targeted routing checks.

Run routing audits, dependency checks, targeted Layer 1 tests, and diff hygiene.

Run skill integrity checks, generated drift checks, benchmark coverage, tests, targeted `rg` route checks, and `git diff --check`.

Run stale deck wording scans and `git diff --check`.

Run standard skill validation and benchmark coverage.

Run targeted active-skill route scans.

Run targeted drift scans for stale install wording, missing helper path, retired executable routes, and historical npm page labeling.

Run targeted existing repository checks appropriate for package metadata.

Run targeted static checks and `git diff --check`.

Run targeted string/structure checks and `git diff --check`.

Run targeted verification and `git diff --check`.

Run targeted verification commands and `git diff --check`.

Run temp-repo parity tests against Node and bash paths before removing any fallback dependency.

Run the existing cross-pack routing audit.

Run the new script against the published npm package.

Run the package test script if available.

Run the release gates in order: package tests, package verify, convention bundle audit, alignment audit, interrogation audit, and npm registry checks.

Run the requested generator, test, version, archive, dependency, showcase, and diff checks.

Run whitespace checks and review the diff.

Run whitespace checks and review the diff.

Run whitespace checks.

Run whitespace/diff checks and focused convention verification.

Scan changed pages for preserved titles/context, decisions, gates, assumptions, proposed file changes, and TTS script.

Search active skills for `$pack`, `pack install`, `scripts/pack.sh install`, `scripts/pack.sh refresh`, and missing-skill fallback references.

Search docs/package sources for user-facing pack-install guidance.

Separate active contracts from archives, generated data, and the `pack` skill implementation itself.

Separate active operating docs from generated artifacts, prompt history, archives, and historical reports.

Spot-check command examples and package-version wording.

Stage only intended files.

Step 3.1: Node Project Config Parity.

Step 3.2: Pack Normalization And Alias Parity.

Step 3.3: Install/Remove/Refresh Parity.

Step 3.4: Locking And Drift Parity.

Step 3.5: Compatibility Closure.

Step 4.1: Documentation readiness.

Step 4.2: Documentation contracts.

Step 4.3: Dry-run release checks.

Step 4.4: Ship.

Step 5.1: Release preflight.

Step 5.1b: MIT metadata prepublish fix.

Step 5.2: External publish gate after metadata validation.

Step 5.3: Public npm publish.

Step 5.4: Published-package verification.

Step 5.5: Commit and push post-publish evidence.

Support `--json` machine-readable output for tests.

Support default human summary mode without file writes.

Track base installation in `.agents/project.json` so `skillpacks refresh` rebuilds base skills from the current package snapshot.

Update `alignment/index.html` metadata if confirmation state/date changes require it.

Update `alignment/index.html` title/search metadata for the amended pages.

Update `alignment/index.html` to mark the entry confirmed.

Update `alignment/index.html` with the new review page entry.

Update `CHANGELOG.md` for `v0.16`.

Update `docs/alignment-page-convention.md` so Stage 1 is minimal scope discovery, not synthesized research.

Update `docs/skillpacks-npm-distribution.md` so deck installation is modeled as manifest metadata, not opaque monolith presets.

Update `PACK.md`, the YouTube router if needed, and benchmark coverage fixtures.

Update `spec-interview` gates to accept graduation readiness while preserving prototype and cleanup blockers.

Update active `SKILL.md` install guidance; keep `/pack`, `$pack`, and `scripts/pack.sh` only as explicit legacy/source-checkout behavior.

Update active route docs, design-tree convention/schema, UAT handoffs, maps, and generated bundles.

Update both changelogs.

Update CLI help and docs/changelog.

Update commands, comments, and documentation to identify these files as website-owned.

Update focused layer1 assertions for unified response compilation, local feedback visibility, generated bundle wording, and upgrade-page feature wording.

Update focused layer1 tests for scope-approval-before-research behavior.

Update help/docs without changing global install semantics.

Update Layer 1 regression assertions.

Update live Skills Showcase research references from four decks to five decks.

Update npm distribution docs and quickstart wording to explain base versus global install paths.

Update only the alignment page styles/markup needed to keep the chart within the viewport.

Update pack workflow docs, skill next-step contracts, skills reference, product-design `PACK.md`, and global skill browser mappings.

Update package changelog.

Update package-included docs with npm usage and git-checkout usage.

Update positioning, UI interview, UX variations, prototype, spec interview, and research-roadmap routing.

Update review notes and history.

Update review notes and history.

Update review notes, commit, and push intended changes only.

Update review notes, history, commit, and push intended changes.

Update root generated blocks, provisioner templates, package docs, and routing contract to standardize on `npx skillpacks install <pack-or-skill>`.

Update routing audit so active `/pack install` and `$pack install` guidance fails unless allowlisted.

Update setup/troubleshooting/script docs so track-latest installs are described as managed copies/directories and pinned archives are the symlink case.

Update stale count references in current Skills Showcase docs and indexed alignment pages, including `tasks/pack-card-hierarchy.md`, `alignment/skillmap.html`, `apps/skills-showcase/docs/deck-builder-ux.md`, `research/skills-showcase/idea-brief.md`, `research/skills-showcase/idea-brief-interview.md`, and `alignment/idea-scope-brief-skills-showcase.html` as confirmed by fresh scans.

Update task/history notes and manifest.

Update the 14 global files listed in the audit: `pack`, `skills`, `init-agentic-skills`, `provision-agentic-config`, `afps-status`, `codebase-status`, and `idea-scope-brief` for both Claude and Codex where present.

Update the canonical Browser open paragraph in `docs/alignment-page-convention.md`.

Update the canonical design-tree loop convention with a required Progress Handoff Block for chunked setup, per-unit, and assemble stops.

Update the central alignment index and task review notes.

Update the live deck documentation sentence that referenced npm install presets.

Update the npm distribution page's deck-installation section and gate to include Game AFPS.

Update the Skills Showcase deck-builder page to use five canonical decks.

Update the website generators and package staging script to read through this internal catalog layer.

Update the workflow-design page to the five-deck model: VARD, ORD, Business AFPS, Devtool AFPS, and Game AFPS.

Use `/tmp/skillpacks-npm-cache` by default and isolated `mktemp` project directories.

Validate the `exec` alias/skill precedence claim against the current manifest.

Validate the archive-install claim against source, generated metadata, and git history.

Validate the reconciliation diff.

Validate the user claim against the alignment page and recent deck documentation.

Validate whether `refresh` touches global/user-home skills.

Verify `list`, pack install, individual skill install, deck install, and `doctor`.

Verify `node bin/skillpacks.mjs list`.

Verify `npx skillpacks@latest list` against npm.

Verify archive snapshots exist for all three edited pages.

Verify each edited page contains its dated addendum and required key findings.

Verify every active page has a matching archive copy.

Verify final compiled YAML is complete and has no negative section feedback.

Verify no `specs/skills-showcase/user-flow-deck-creation*` files are modified.

Verify pack, individual skill, and deck-backed pack removal.

Verify skill-level pin to `v0.0`, unpin back to latest, and unsupported direct `install name@version` syntax.

Verify source links and diff hygiene.

Verify temp consumer repo install/status/doctor behavior.

Verify the alignment page visually in the browser.

Verify the alignment-page audit passes for the active page set.

Verify the design doc contains the revised deck approval, manifest resolver, package-list fields, and registry-tag fields.

Verify the doc contains the approved decisions, phase roadmap, and no implementation drift.

Verify the git-checkout install path remains functional.

Verify the proposed canonical markdown files remain unwritten.

Verify UI canonical files remain unwritten before final UI approval.

Write `apps/skills-showcase/docs/animation-plan-deck-builder.md` from the approved page content and gate answers.

Write `docs/skillpacks-npm-distribution.md`.

Write `research/devtool-docs-audit.md` findings-first.

Write `tasks/reconciliation-report.md` with fixed, deferred, and remaining findings.

Write canonical user-flow spec and interview log under `specs/skills-showcase/`.

Write findings-first documentation audit output.

Write the draft only to `research/skills-showcase/_working/preliminary-ui-interview-research.md`.

Write the findings and remediation order to `research/skillpack-cli-routing-audit.md`.

Add package boundary checks so package verification does not mutate website-owned generated assets.

Apply the canonical wording consistently across mirrored Claude/Codex pack skills.

Avoid one oversized commit by grouping related pack buckets into reviewable batches.

Commit and push intended files on `master`.

Commit and push intended tracked changes in both repos.

Commit and push intended tracked changes.

Commit and push the intended changes only.

Commit and push the intended remediation batches.

Distinguish pack installs from deck installs; use `npx skillpacks install-deck <deck>` only when the desired install unit is a deck.

Publish patch release and verify npm behavior.

Record review notes in `tasks/todo.md` and history, then commit and push intended changes.

Record review notes, task history, and shipping metadata.

Refresh Skills Showcase data if any `SKILL.md` metadata or content changes affect generated showcase surfaces.

Replace repeated pack-availability guard language across the pack-skill buckets listed in the audit.

Run package, website, repository integrity, boundary, and tarball exclusion checks.

Run skill version, archive, dependency, routing, and whitespace checks.

Run verification gates and publish dry run.

Sweep high-traffic workflow skills with custom follow-up route language: `customer-discovery`, `competitive-analysis`, `journey-map`, `positioning`, `user-flow-map`, `ui-interview`, `ux-variations`, `roadmap`, `plan-phase`, `ship`, and `ship-end`.