Skip to content

feat(effort-graph): ship agent runtime, skills, and planning graph#222

Merged
tonyketcham merged 1 commit into
mainfrom
stack/tonyketcham/feat/effort-graph-agent-runtime/ship-agent-runtime-skills-planning-graph--bb417555
Jul 19, 2026
Merged

feat(effort-graph): ship agent runtime, skills, and planning graph#222
tonyketcham merged 1 commit into
mainfrom
stack/tonyketcham/feat/effort-graph-agent-runtime/ship-agent-runtime-skills-planning-graph--bb417555

Conversation

@tonyketcham

@tonyketcham tonyketcham commented Jul 19, 2026

Copy link
Copy Markdown
Collaborator

Promote the Effort Graph from write-only memory into an agent-facing
runtime: digests/read APIs, flatbread effort CLI, versioned skill
packaging with sync/pack CI gates, and a dogfooded .flatbread-efforts
planning authority that replaces the ADR/roadmap docs stack.

Also hardens publish/bump versioning for skill release metadata, updates
onboarding to the unified watch loop, and adds the root Flatbread config
used to query this repo's own effort graph.

Note

Follow-up graph update after the initial push: accept Crumb Trail as
the product/brand name for agent memory (supersedes Crumb Graph as the
product name). Crumb Graph stays as the datamodel explainer; Effort Graph
remains an allowed technical alias. Package/CLI/path renames stay deferred
under a new implementation issue.

Summary

  • Add effort digests, generation-aware reads, and flatbread effort CLI
  • Package effort-graph / effort-modeling / grill-with-efforts skills with sync + pack checks in CI
  • Commit the dogfooded .flatbread-efforts graph; retire ADRs, roadmap, and stale proposal docs
  • Improve bump/publish scripts for skill release pinning; refresh CONTRIBUTING and public READMEs
  • Brand decision: Crumb Trail (product) vs Crumb Graph (datamodel explainer)

Test plan

  • pnpm skills:check && pnpm skills:pack-check
  • pnpm verify (or at least build + effort-graph / flatbread effort CLI tests)
  • pnpm exec flatbread effort list / get against root flatbread.config.js
  • Spot-check CONTRIBUTING + package READMEs for watch-loop / effort skill install paths
  • Confirm Crumb Trail / Crumb Graph branding records resolve cleanly via flatbread effort

Co-authored-by: Cursor [email protected]

@mergify

mergify Bot commented Jul 19, 2026

Copy link
Copy Markdown
Contributor

Queued — the merge queue status continues in this comment ↓.

@tonyketcham
tonyketcham force-pushed the stack/tonyketcham/feat/effort-graph-agent-runtime/ship-agent-runtime-skills-planning-graph--bb417555 branch from bc93b78 to 8270fab Compare July 19, 2026 04:01
@tonyketcham

Copy link
Copy Markdown
Collaborator Author

Revision history

# Type Changes Reason Date
1 initial bc93b78 2026-07-19 04:02 UTC
2 content bc93b78 → 8270fab (raw) Fold Crumb Trail branding decision/finding/issue into the dogfood graph; note product vs datamodel naming in the PR body. 2026-07-19 04:02 UTC

Promote the Effort Graph from write-only memory into an agent-facing
runtime: digests/read APIs, `flatbread effort` CLI, versioned skill
packaging with sync/pack CI gates, and a dogfooded `.flatbread-efforts`
planning authority that replaces the ADR/roadmap docs stack.

Also hardens publish/bump versioning for skill release metadata, updates
onboarding to the unified watch loop, and adds the root Flatbread config
used to query this repo's own effort graph.

## Note
Follow-up graph update after the initial push: accept **Crumb Trail** as
the product/brand name for agent memory (supersedes Crumb Graph as the
product name). Crumb Graph stays as the datamodel explainer; Effort Graph
remains an allowed technical alias. Package/CLI/path renames stay deferred
under a new implementation issue.

## Summary
- Add effort digests, generation-aware reads, and `flatbread effort` CLI
- Package effort-graph / effort-modeling / grill-with-efforts skills with sync + pack checks in CI
- Commit the dogfooded `.flatbread-efforts` graph; retire ADRs, roadmap, and stale proposal docs
- Improve bump/publish scripts for skill release pinning; refresh CONTRIBUTING and public READMEs
- Brand decision: Crumb Trail (product) vs Crumb Graph (datamodel explainer)

## Test plan
- [ ] `pnpm skills:check && pnpm skills:pack-check`
- [ ] `pnpm verify` (or at least build + effort-graph / flatbread effort CLI tests)
- [ ] `pnpm exec flatbread effort list` / `get` against root `flatbread.config.js`
- [ ] Spot-check CONTRIBUTING + package READMEs for watch-loop / effort skill install paths
- [ ] Confirm Crumb Trail / Crumb Graph branding records resolve cleanly via `flatbread effort`

Co-authored-by: Cursor <[email protected]>

Change-Id: Ibb417555cd91d868417671c56fe4d4613f932041
@tonyketcham
tonyketcham enabled auto-merge July 19, 2026 04:04
@tonyketcham

Copy link
Copy Markdown
Collaborator Author

@Mergifyio queue

@mergify

mergify Bot commented Jul 19, 2026

Copy link
Copy Markdown
Contributor

Merge Queue Status

  • Entered queue2026-07-19 04:05 UTC · Rule: owner-bypass · triggered by @tonyketcham with the @mergifyio queue command
  • Checks skipped · PR is already up-to-date
  • Merged2026-07-19 04:05 UTC · at 8270fab38c473c98814ef3ee306543cb2e7ea76a

This pull request spent 24 seconds in the queue, including 6 seconds running CI.

Required conditions to merge
  • author = tonyketcham
  • check-success = build (20.x, ubuntu-latest)
  • check-success = build (22.x, ubuntu-latest)
  • check-success = integration-nextjs (20.x, macos-latest)
  • check-success = integration-nextjs (20.x, ubuntu-latest)
  • check-success = integration-nextjs (20.x, windows-latest)
  • check-success = integration-nextjs (22.x, macos-latest)
  • check-success = integration-nextjs (22.x, ubuntu-latest)
  • check-success = integration-nextjs (22.x, windows-latest)
  • check-success = integration-sveltekit (20.x, macos-latest)
  • check-success = integration-sveltekit (20.x, ubuntu-latest)
  • check-success = integration-sveltekit (20.x, windows-latest)
  • check-success = integration-sveltekit (22.x, macos-latest)
  • check-success = integration-sveltekit (22.x, ubuntu-latest)
  • check-success = integration-sveltekit (22.x, windows-latest)
  • check-success = lint (20.x, ubuntu-latest)
  • check-success = lint (22.x, ubuntu-latest)
  • check-success = test (20.x, ubuntu-latest)
  • check-success = test (22.x, ubuntu-latest)

@mergify mergify Bot added the queued label Jul 19, 2026
@tonyketcham
tonyketcham merged commit 05bf78e into main Jul 19, 2026
19 checks passed
@tonyketcham
tonyketcham deleted the stack/tonyketcham/feat/effort-graph-agent-runtime/ship-agent-runtime-skills-planning-graph--bb417555 branch July 19, 2026 04:05
@mergify mergify Bot removed the queued label Jul 19, 2026
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