Skip to content

feat(agentkit): refresh publication guidance - #42

Closed
thieung wants to merge 25 commits into
mainfrom
codex/agentkit-v2-4-guide-refresh
Closed

thieung wants to merge 25 commits into
mainfrom
codex/agentkit-v2-4-guide-refresh

Conversation

@thieung

@thieung thieung commented Jul 20, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Refreshes publication guidance without reproducing the full AgentKit CLI catalog.
  • Documents stable 2.4.0 with 2.4.0-beta.7 provenance and no active beta.
  • Adds curated bilingual scenarios and closes the publication guidance lifecycle.

Safety / behavior facts

  • Keeps executable guidance curated instead of presenting a full CLI catalog.
  • Uses a fail-closed release payload parser and preserves stable-first channel behavior.
  • Covers publication closure while retaining support-assisted boundaries for ambiguous ownership or payload state.
  • Excludes user artifacts: engineer/, pnpm-lock.yaml, and pnpm-workspace.yaml were not staged or included.

Test plan / results

  • Local full build: 184 total, 183 passed, 1 intentional skip.
  • Toolchain contract: 8/8 passed.
  • npm audit --omit=dev: 0 vulnerabilities.
  • Truth and archive gates: green.
  • GitHub CI using exact Node 22.21.1 / npm 10.9.4 is expected to run on this PR and is pending at creation.

thieung and others added 19 commits July 12, 2026 01:47
* fix(guides): align AgentKit migration UI states

* test(guides): add AgentKit UI smoke runner

* docs(agentkit): record UI consistency validation

* fix(guides): pair related-guide panel themes
* feat(guides): document AgentKit Desktop App

* feat(guides): clarify legacy skill cleanup

* feat(guides): expand ClaudeKit compatibility primer
Clarify Desktop App vs kit entitlements, correct stable ak 2.1.0 CLI commands (list-kits, migrate/refresh flags, CLI vs App auth), and surface a Continuity FAQ before the App waitlist CTA.
Drop the unused CI path card, keep CLI tokens as inline code, clarify
Desktop App limits, and align Hooks page copy with AgentKit naming.
Shorten nav to CK→AK, restore light Codex/CCS and coexistence guidance via adapters, and add How AgentKit Works primer accents.
Capture ak 2.2.0-beta.17 new/init/build-only fixtures and typed structure facts so Claude Mechanics can teach ownership + plugin trees instead of CK-era ck init layouts.
Add catalog index, noindex archive layout, bilingual stubs for all In slugs, and manifest/audit wiring while keeping the 72-route baseline and sitemap free of legacy URLs.
Move coexistence and ck-with-codex CK sections under legacy/, copy Claude Mechanics trees, and render full frozen pages for those three archive slugs.
Archive cli/commands/workflows/flowchart/finding-unknowns/what-is/how-ck-works/inside-* under /legacy via a shared router, marking 16 catalog entries frozen while remaining config/provider stubs wait for batch C.
Complete the /legacy/guides ClaudeKit archive: permissions, hooks, CCS, migrate, and other remaining stubs now render shared CK bodies so every catalog entry is frozen before AgentKit mechanics rewrite.
Replace the CK-era ck init project tree on /guides/claude-mechanics with probe-backed onboarding + plugin kit facts; keep the historical tree under /legacy/guides/claude-mechanics and gate the live page as agentkit-active.
Restore CK-era guide trees from 56524c9 into src/legacy-ck so /legacy/guides no longer mirrors live AgentKit (/ak:) content. Wire Batch B/C routers + mechanics i18n to the isolated dictionary; mark catalog freezeStatus as isolated.
@vercel

vercel Bot commented Jul 20, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
vividkit-web Error Error Jul 23, 2026 9:59am

Ship What is AgentKit / CLI / migrate surfaces, keep beta channel useful with shared install-setup-migrate steps, and rewrite CK→AK migration copy for practical stage-by-stage cutover.
@cursor

cursor Bot commented Jul 23, 2026

Copy link
Copy Markdown

Bugbot is not enabled for your account, so this pull request was not reviewed.

Enable Bugbot in the Cursor dashboard to get automatic reviews on future PRs.

@thieung

thieung commented Jul 24, 2026

Copy link
Copy Markdown
Contributor Author

Closing in favor of a template-based rebuild (plan `plans/260724-0303-agentkit-guides-restructure/`).

PR #42 scope diverged (audit scripts, CI fixtures) from the guides-only goal. Facts from the PR body may inform copy, but no code cherry-picks. Replacement work ships as atomic PR 1 (two-lane nav + what-is-agentkit + agentkit-install), then cheatsheets and `/vk:audit-ak`.

This branch had an error being deployed

1 failed deployment
Preview — 67b9d523 Deployed Jul 23, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant