Skip to content

docs(runbook): note the DCA cadence gotcha (signals=0, no preview) - #131

Merged
eaitbrahim merged 1 commit into
mainfrom
docs/runbook-dca-cadence-gotcha
Jul 23, 2026
Merged

docs(runbook): note the DCA cadence gotcha (signals=0, no preview)#131
eaitbrahim merged 1 commit into
mainfrom
docs/runbook-dca-cadence-gotcha

Conversation

@eaitbrahim

Copy link
Copy Markdown
Contributor

The go-live runbook's step 4 promises an order preview, but a DCA test vehicle only fires on its calendar cadence(latest_daily_bar_epoch_day % cadence_days) == 0, i.e. Thursdays (UTC) for the weekly default. Run the agent on any other day and you get signals=0 with no prompt, which reads as a failure (it isn't).

Adds:

  • a pointer in step 4 for when you see signals=0 instead of a preview;
  • a "What can still go wrong" bullet explaining the cadence gate, how to fire it on demand (cadence_days=1, reverted after — a one-row rules update that places no order), and that the risk-defined rules fire only on real market setups, so DCA on a cadence day is the controllable path for a first live order.

Docs-only; verified against keel/strategy/rules/dca.py.

🤖 Generated with Claude Code

The runbook's step 4 promises an order preview, but a DCA test vehicle only
emits a signal on its calendar cadence -- (latest_daily_bar_epoch_day %
cadence_days == 0), i.e. Thursdays for the weekly default. Running the agent on
any other day prints signals=0 and never reaches the confirm prompt, which reads
as a failure. Add a pointer in step 4 and a full 'What can still go wrong' bullet
explaining the gate and how to fire it on demand (cadence_days=1, reverted after)
vs the market-triggered risk-defined rules.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@eaitbrahim
eaitbrahim merged commit 64bd736 into main Jul 23, 2026
1 check passed
@eaitbrahim
eaitbrahim deleted the docs/runbook-dca-cadence-gotcha branch July 23, 2026 09:09
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