Skip to content

Restore the template and Worker agent instruction files and point them at the changelog - #553

Merged
zackbart merged 1 commit into
mainfrom
restore/template-agent-files
Sep 17, 2026
Merged

zackbart merged 1 commit into
mainfrom
restore/template-agent-files

Conversation

@zackbart

Copy link
Copy Markdown
Owner

#552 removed templates/node/AGENTS.md, its CLAUDE.md symlink, and examples/worker/AGENTS.md. That was a mistake: they are what an agent reads inside a generated deployment, where none of connecta's own documentation is in view. This restores them and everything that depended on them.

Restored

  • The three files, byte-identical to before Cut the documentation to four guides and move provider rationale into code #552 apart from the audit fixes below.
  • connecta init recreating the CLAUDE.md symlink (npm strips symlinks from a packed dependency), with the copy fallback where symlinks are disallowed.
  • scripts/check-package.mjs asserting the packed template ships AGENTS.md and that a generated deployment has both files with CLAUDE.md a symlink.
  • test/deployment-shapes.test.ts pinning the template inventory and the three hosted-MCP callback URIs in the Worker AGENTS.md.
  • The pointers to them in templates/node/README.md, examples/worker/README.md, examples/worker/src/index.ts, and the root AGENTS.md.

Audit fixes

Every claim in both files was checked against the template and example source (executor: quickJsExecutor(), the typecheck and doctor scripts, CONNECTA_TOKEN, src/file-activity.ts, cloudflareAccessAuth(), the loader-only DynamicWorkerExecutor, CREDENTIAL_ENCRYPTION_KEY). Two were wrong:

  • The template file sent upgraders to documentation/upgrading.md, which Cut the documentation to four guides and move provider rationale into code #552 deleted. It now says to bump the exact pin and read the changelog for every release in between, online or at node_modules/@zackbart/connecta/CHANGELOG.md, which does ship.
  • The Worker file told a copied deployment to run npm run check:examples, a script that exists only in the connecta repository. It now names that for in-repo work and tsc --noEmit for a copy.

Also removes a stray blank line that split the template's bullet list, and drops the Unreleased changelog line announcing the removal, since the released behavior is unchanged.

npm run release:check passes locally: 119 files, 3267 tests passed, 37 skipped. The Docker container smoke was skipped locally and runs here.

🤖 Generated with Claude Code

…m at the changelog

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
@zackbart
zackbart merged commit 0f892de into main Sep 17, 2026
1 check passed
@zackbart
zackbart deleted the restore/template-agent-files branch September 17, 2026 21:58
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