Skip to content

refactor(prompts): defer cron mechanics to the scheduling-tasks skill - #3683

Merged
cpacker merged 2 commits into
mainfrom
refactor/defer-cron-detail-to-skill
Aug 5, 2026
Merged

refactor(prompts): defer cron mechanics to the scheduling-tasks skill#3683
cpacker merged 2 commits into
mainfrom
refactor/defer-cron-detail-to-skill

Conversation

@cpacker

@cpacker cpacker commented Aug 5, 2026

Copy link
Copy Markdown
Collaborator

Summary

  • Deletes the cron mechanics from the Working across time section of both system prompts: the letta cron add invocation templates, flag documentation, $AGENT_ID plumbing note, and the schedule-placement paragraph.
  • Replaces them with one line deferring to the scheduling-tasks skill, with a warning against relying on remembered flag behavior (it changes across versions).
  • Everything else in the section is untouched — the concept paragraph, trigger list, proactivity requirement, and cost guidance are unchanged from main.

Why

The prompt copy of cron mechanics drifts from the CLI: the placement paragraph alone needed edits in three consecutive PRs (#3665, its hotfix commit, and the pending #3682). Because the prompt copy is always in context, agents trust it over the skill even when the CLI has moved on — a stale prompt is worse than no prompt. The skill is versioned with the CLI it documents; that is the single source of truth for mechanics.

The invocation templates were deliberately not kept: an agent pattern-matching a remembered template instead of loading the skill is exactly the drift failure mode this removes.

Sequencing: lands before #3682 (stacked on this branch), which changes placement behavior again — with this merged, that PR only needs to update the skill.

Test plan

  • Markdown-only; bun run check green on the branch

👾 Generated with Letta Code

The Working-across-time section restated cron CLI mechanics (invocation
templates, flag behavior, schedule placement rules) that the
scheduling-tasks skill also documents. The CLI copy changes across
versions while the prompt copy is always in context, so agents keep
trusting stale mechanics — the placement paragraph alone needed edits in
three consecutive PRs (#3665 and follow-ups). The prompt now owns the
durable concept: no future invocation happens unless the agent schedules
it, when to create crons, proactivity, and cost. One line defers all
mechanics to the skill and warns against relying on remembered flag
behavior.

👾 Generated with [Letta Code](https://letta.com)

Co-Authored-By: Letta Code <noreply@letta.com>
…agraph

The deferral change is deletion-only plus one pointer line; the opening
paragraph paraphrase was scope creep.

👾 Generated with [Letta Code](https://letta.com)

Co-Authored-By: Letta Code <noreply@letta.com>
@cpacker
cpacker merged commit 3dd0d85 into main Aug 5, 2026
22 checks passed
@cpacker
cpacker deleted the refactor/defer-cron-detail-to-skill branch August 5, 2026 02:15
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