Skip to content

feat: compiled base44-platform skills synced from apper (validator, auto-merge, CODEOWNERS, docs) - #169

Merged
carmelc merged 15 commits into
mainfrom
agent-skills-sync
Nov 2, 2026
Merged

carmelc merged 15 commits into
mainfrom
agent-skills-sync

Conversation

@carmelc

@carmelc carmelc commented Oct 20, 2026 •

Copy link
Copy Markdown
Contributor

Summary

Introduces the compiled platform skills: skills/base44-platform-*, generated from the Base44 builder's own system prompt by Base44's internal compiler and synced here by a manually dispatched, IP-gated workflow. Nine skills (platform, entities, backend-functions, workflows, agents, actors, integrations-sdk, connectors, frontend), each with one reference per app shape (Vite SPA, TanStack Start, native mobile; a game app is a Vite SPA and reads the web-spa references) and routed by GET /api/apps/{app_id}/agent-profile.

This PR carries the first compiled tree (pinned in SOURCE_COMMIT) plus the machinery and docs for the ongoing process:

  • scripts/validate-base44-platform.mjs + Validate base44-platform skills workflow: a sync PR must carry exactly what the compiler emitted (header, manifest sha256s, frontmatter, links, pin).
  • Auto-merge compiled skill updates workflow: squash auto-merge for a labeled sync PR from the sync app whose diff is confined to the generated tree and the pin.
  • .github/CODEOWNERS for the generated tree and the two workflows (@base44/devs; change the team if another one owns this).
  • README and CONTRIBUTING sections: what these skills are, how the pipeline works, and how to change a compiled skill (change the source prompt, never the files here).
  • Plugin manifests list the nine skills; the Slack notifier comment mentions the new sync source.

Not done here (needs repo admin)

  • Enable auto-merge in repository settings and make Validate base44-platform skills a required check on main.
  • Nothing to provision for the bot: sync PRs come from the existing base44-github-actions app, which sync-cli-skill.yml / sync-sdk-skill.yml already trust; the auto-merge guard names base44-github-actions[bot] directly.

Testing

  • node scripts/validate-base44-platform.mjs: 9 skills, 35 files, pin verified.
  • node scripts/validate-template.mjs: passes with the updated plugin manifests.
  • The tree is byte-identical to python -m backend.scripts.agent_skills --out at the pinned source commit (--check passes there: deterministic, denylist-clean, no internal names).

🤖 Generated with Claude Code

https://claude.ai/code/session_01YLKGecSgMqR14kYQTrugoR

carmelc and others added 5 commits October 20, 2026 07:18
…or, auto-merge, CODEOWNERS and docs

Adds the `skills/base44-platform-*` tree compiled from the Base44 builder's
prompt tree (base44-dev/apper, backend/scripts/agent_skills) at the pinned
APPER_COMMIT, the validator that proves a sync PR carries exactly what the
compiler emitted, the auto-merge workflow for labeled sync PRs confined to
the generated tree, CODEOWNERS for that tree, plugin manifests listing the
ten skills, and the README / CONTRIBUTING sections describing the pipeline
and how to change a compiled skill (edit the prompt partial in apper).

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01YLKGecSgMqR14kYQTrugoR
…ger and activity

Pinned to the apper commit that sets the workflow rollout payloads to `all`,
matching production.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01YLKGecSgMqR14kYQTrugoR
Main folded the paginated / count / aggregate / upsert entities SDK into the
default prompt, so the compiled entities references now teach it.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01YLKGecSgMqR14kYQTrugoR
…ync PRs

The apper sync opens its PRs with the base44-github-actions app, which this
repo's CLI and SDK sync workflows already trust, so the auto-merge guard
names that bot directly and no SKILLS_SYNC_BOT_LOGIN variable is needed.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01YLKGecSgMqR14kYQTrugoR
…816ecd2112c)

Regenerated from apper feat/agent-skills-compiler at 816ecd2112c. New apps are
created with core-integration control on, so the integrations-sdk and
backend-functions references now teach Core calls inside backend/server
functions with asServiceRole, name the agent-profile value
core_integrations: backend_functions_only | client_allowed, and the
integrations-sdk web reference is split into web-spa and web-tanstack.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01C2pKgYtPwVgNkRKbWFPUcB
@carmelc

carmelc commented Oct 20, 2026

Copy link
Copy Markdown
Contributor Author

Regenerated the tree from apper feat/agent-skills-compiler at 816ecd2112c (APPER_COMMIT updated).

What changed and why: new Base44 apps are created with core-integration control on, and the runtime rejects client-side base44.integrations.Core calls other than uploads and signed URLs. The previous compile taught the client-side InvokeLLM call. Now:

  • base44-platform-integrations-sdk and base44-platform-backend-functions references teach Core calls inside backend / server functions with asServiceRole, and name the agent-profile value core_integrations: backend_functions_only | client_allowed.
  • base44-platform-integrations-sdk/references/web.md is split into web-spa.md and web-tanstack.md; the SKILL.md routing table follows.
  • 79 compiled files; manifest hashes verified locally. The Validate base44-platform skills check covers the rest.

https://claude.ai/code/session_01C2pKgYtPwVgNkRKbWFPUcB

carmelc and others added 5 commits October 22, 2026 10:33
The compiled tree now comes from a manually dispatched sync behind an IP gate (internal-name
scan plus a review of the publishable tree), so the docs, validator, workflows and CODEOWNERS
drop the nightly cadence and no longer name the private source repository. The pin file is
SOURCE_COMMIT (a bare commit sha); the generated header matches. Tree recompiled from
7acabe324ef.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01YLKGecSgMqR14kYQTrugoR
Internal-only passages are now cut at the source (dispatcher route and auth, actor key
seeding), builder-only mechanics are rephrased for external agents (Phaser reference files
instead of injected sections, npm install, the Dashboard's Webhooks page), and the two
social-post activities that need a builder-only tool leave the workflows guide and index.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01YLKGecSgMqR14kYQTrugoR
The workflows guide now lists the connector webhook events (compiled with the connector
seed installed), the external connector pointer says what list_connectors returns, secrets
and connector instructions name the Dashboard → Secrets and Workspace settings → Connectors
pages, and CONTRIBUTING describes the hold-until-approved path for review findings.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01YLKGecSgMqR14kYQTrugoR
…freshed)

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01YLKGecSgMqR14kYQTrugoR
@claude

claude Bot commented Oct 22, 2026

Copy link
Copy Markdown
Contributor

README check ran. 2 issue(s) found and applied: base44-troubleshooter row didn't mention workflow run history / scheduled-job diagnosis (now added); base44-platform-games row mentioned analytics, which isn't part of that skill (corrected to scenes/physics/input/cameras/assets/HUD). README.md has been updated in this branch.

carmelc and others added 3 commits October 22, 2026 14:07
Mobile apps on the workflows pipeline read references/backend-functions.md (renamed from
web-spa.md); mobile-automations.md is for legacy-pipeline apps only. Rate-limit wording on the
profile endpoint follows the enforced per-caller budget.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01YLKGecSgMqR14kYQTrugoR
Nine compiled skills now: a game app is a Vite SPA and reads the web-spa
references. The entities reference for mobile is renamed mobile.md, the
plugin manifests and docs no longer list base44-platform-games.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01C2fHMwsHuKC2HxRkojwH2X
@claude

claude Bot commented Oct 25, 2026

Copy link
Copy Markdown
Contributor

README check ran. No issues found — the Available Skills table, install commands, and CONTRIBUTING/LICENSE links all match the current repo state.

carmelc and others added 2 commits November 1, 2026 11:28
… label skips auto-merge

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01C2fHMwsHuKC2HxRkojwH2X
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01C2fHMwsHuKC2HxRkojwH2X
@carmelc
carmelc merged commit c908bfe into main Nov 2, 2026
3 checks passed
@carmelc
carmelc deleted the agent-skills-sync branch November 2, 2026 14:07
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