SPIKE: menke-5 guide ingest for agent-context store (SPIKE-001 T01) by jmjava · Pull Request #24 · jmjava/sdlc-spdd-orchestrator

jmjava · 2026-07-05T15:00:08Z

SPIKE-001 — Guide as optional DICE context backend

Status: Draft — do not merge until T06 go/no-go.

This PR (orchestrator)

Leg 2 scaffold: menke-5 profile, append-orchestrator-context, operator runbook
Leg 3 operator path: projection helpers, dual-ingest docs, DICE runbook + guide-flow
Runtime-resolved Guide backend: resolve-context-backend.sh + optional agent-context/harness/guide-dice.md (init-project.sh --with-guide); slash commands augment with spdd_* only when live
T07: examples/retrieval-fixture/ + resolver gold test (CI)
T05: A/B ledger filled for modes (a)/(b)/(c) spot-checks
Docs: docs/guide-flow.md, docs/dice-projection-runbook.md, README Current work

Paired guide branch (leg 3)

Repo	Branch	Tip	PR
`jmjava/guide`	`cursor/spike-spdd-dice-projection-17f4`	`9b8fbaf`	jmjava/guide#2

Not the DICE proposition pipeline. Leg 3 = structured markdown → __Entity__ via projection API + spdd_* MCP tools.

Test status (2026-07-11)

Gate	Result
CI on tip `bfa7f68` (8 workflows)	✅ all success (adapters, canvas, mermaid, fixture gold, posture, SDLC pointer/workflow, adapter install)
Docgen workflows	⛔ removed on purpose (no docgen actions in this repo)
Mode (a) resolver baseline (C01–C03)	✅ ledger filled
Mode (b) embedding MCP on fixture corpus	✅ billing / canvas / pitfalls hits; payments negative control
Mode (c) domain graph `GET …/work/{workId}`	✅ typed-edge subgraph
Runtime backend probe	✅ `CONTEXT_BACKEND=guide-dice` when Guide up; `files` when not
Cursor `.cursor/commands` install	✅ dogfooded in this repo

Canvas ops

Complete: T01, T02, T03, T04, T05, T07, T08. Remaining: T06 go/no-go.

Operator flow

See docs/guide-flow.md and docs/dice-projection-runbook.md.

# Guide tip 9b8fbaf
cd ~/github/jmjava/guide && git checkout cursor/spike-spdd-dice-projection-17f4
GUIDE_PROFILE=menke-5 GUIDE_PORT=21337 ./scripts/append-ingest.sh

cd ~/github/jmjava/sdlc-spdd-orchestrator
git checkout cursor/spike-guide-ingest-agent-context-17f4
./scripts/resolve-context-backend.sh --target . --project --work-id SPIKE-001-guide-rag-context-backend
./scripts/guide/verify-spike-guide-setup.sh

Add exploration branch artifacts for SPIKE-001 T01 — append-ingesting orchestrator agent-context and spdd into the existing Guide/Neo4j corpus (leg 2 RAG chunks) using the ingest-to-hub branch's git incremental ingest. - menke-5 profile template pointing at memory, canvas, and analysis dirs - append-orchestrator-context.sh helper and operator runbook - exploration log template for MCP spot-checks after ingest - SPIKE-001 canvas and guide-rag docs updated with menke-5 references Co-authored-by: John Menke <jmjava@gmail.com>

- Add canonical analysis artifact with branch isolation, experiment design, and mock fixture plan (T07) - Create agent-context/features/SPIKE-001 workspace (requirement, analysis context, progress log, canvas pointer) - Update canvas with T07/T08, safeguards for staying off main until T06 - Link operator runbook and exploration log to SPDD analysis chain - Register Work ID on spike branch in work-registry.tsv Co-authored-by: John Menke <jmjava@gmail.com>

Co-authored-by: John Menke <jmjava@gmail.com>

- Add examples/retrieval-fixture mock project (SPIKE-FIX-001) with seeded indexes - Gold test: tests/test-retrieval-fixture-resolver.sh (15 assertions, 3 cases) - Fixtures: spike-001-retrieval-gold.tsv, spike-001-mcp-queries.tsv - menke-fixture Guide profile + append-retrieval-fixture.sh for mode B - CI: test-retrieval-fixture-resolver workflow - Update canvas T07, progress log, TESTING.md Co-authored-by: John Menke <jmjava@gmail.com>

- Add retrieval A/B ledger stub and mode (a) baseline capture - run-retrieval-ab-fixture.sh: --capture-a, --check-mcp, expect match/no_match - verify-spike-guide-setup.sh for local Guide prereq checks - Commit generated spike-001-mode-a-baseline.tsv (3 fixture cases) - CI: test-retrieval-ab-baseline.sh smoke in retrieval fixture workflow Co-authored-by: John Menke <jmjava@gmail.com>

Document leg 2 RAG vs leg 3 structured markdown projection (not DICE proposition pipeline). Add project-spdd-entities.sh, extend verify script for spdd-projection API, update canvas T03 and operator runbook. Co-authored-by: John Menke <jmjava@gmail.com>

Co-authored-by: John Menke <jmjava@gmail.com>

Leg 3 exercised end-to-end: 9 WorkId / 9 Canvas / 12 Area / 21 typed relationships projected, WorkId subgraph read verified over HTTP, and MCP spot-checks recorded showing embedding-only auditability gaps vs typed-edge domain reads. Also documents guide branch build friction (snapshot drift, drivine bump, ONNX native crash during ingest). Co-authored-by: Cursor <cursoragent@cursor.com>

- docs/dice-projection-runbook.md: shareable e2e runbook for running the orchestrator against jmjava/guide cursor/spike-spdd-dice-projection-17f4 - Schema contract: decision/pitfall/pattern + about edges, /area cross-run retrieval, hardening notes, design verification table - Canvas T04: spdd_* MCP tools verified via JSON-RPC Co-authored-by: Cursor <cursoragent@cursor.com>

…acks Not every install has Guide + Neo4j, so DICE is never assumed: new resolve-context-backend.sh probes opt-in marker (agent-context/harness/ guide-dice.md) then endpoint liveness, reporting CONTEXT_BACKEND=guide-dice or files (files is a valid answer, never an error). Command templates in all three adapter packs gain a runtime-gated Context Backend section mapping guide-dice to the spdd_* MCP tools; retro/sync re-project on the persist side. init-project.sh --with-guide opts installs in; grounding rules updated; orchestrator repo dogfoods its own .cursor command pack. Co-authored-by: Cursor <cursoragent@cursor.com>

…internal docgen workflows (check-docgen-dev-boundary, docgen-lint) removed per owner decision - no docgen actions in this repo. SPIKE-FIX-001 fixture canvas gains the Review Checklist / Sync Notes / Final Status sections validate-canvas requires. spike-guide-ingest-agent-context.md marked orchestrator-only so the local-only operator doc stops shipping into target installs. Co-authored-by: Cursor <cursoragent@cursor.com>

…statuses docs/guide-flow.md explains the Guide flow end to end: dual ingest (chunks vs typed entities), runtime backend resolution, per-phase spdd_* usage, and the cross-run persist loop. README leads with a Current Work section pointing at it. Canvas T01/T03/T04/T08 marked complete to match delivered state. Co-authored-by: Cursor <cursoragent@cursor.com>

menke-fixture must clear content.versioned.versions/supplementary — urls: [] is ignored (urls is computed), so FORCE_STARTUP_INGEST was re-embedding the whole Embabel docs corpus. Append script now regenerates the profile with absolute paths and refuses non-empty versions. Mode (b) MCP queries verified live (billing/canvas/pitfalls hits; payments negative control). Co-authored-by: Cursor <cursoragent@cursor.com>

jmjava · 2026-07-12T03:00:06Z

Sync / test status — 2026-07-11

Branch tip bfa7f68 is pushed and in sync with origin/cursor/spike-guide-ingest-agent-context-17f4.

What was verified

CI: all 8 remaining workflows green on this tip (REASONS canvas, command adapters, mermaid, retrieval-fixture gold, posture, SDLC pointer/workflow, adapter install). Docgen workflows removed by design.
T05 mode (b): fixture ingest fixed (empty content.versioned.versions — urls: [] is a no-op); live MCP vector/text search hits src/billing / spdd/canvas; payments negative control holds. Ledger updated.
Runtime DICE opt-in: resolve-context-backend.sh + --with-guide; commands do not assume Guide is present.
Paired Guide PR Add onboarding documentation path #2 tip 9b8fbaf: Spring Neo4j health auth fix; health UP; spdd_* tools live.

Remaining

T06 go / no-go recommendation only.

Guide PR: jmjava/guide#2

…pike branch Point the primary flow doc at the spike-branch blob URL so readers on main still reach the WIP guide-flow write-up. Co-authored-by: Cursor <cursoragent@cursor.com>

cursoragent and others added 6 commits July 5, 2026 14:59

Policy: all SPIKE-001 PRs must remain draft until T06 go/no-go

45af6ec

Co-authored-by: John Menke <jmjava@gmail.com>

jmjava mentioned this pull request Jul 5, 2026

SPIKE: SPDD leg 3 entity projection (structured markdown → __Entity__) jmjava/guide#2

Draft

cursoragent and others added 7 commits July 5, 2026 15:35

Note guide spike branch pushed (PR jmjava/guide#2)

e3a8703

Co-authored-by: John Menke <jmjava@gmail.com>

README: rename Current work to Work in progress; link guide-flow on s…

8f2fb7a

…pike branch Point the primary flow doc at the spike-branch blob URL so readers on main still reach the WIP guide-flow write-up. Co-authored-by: Cursor <cursoragent@cursor.com>

This was referenced Jul 15, 2026

Catch-up: branch evaluation and next-step priorities (2026-07-15) #26

Closed

Integration: workflow commands + catch-up docs + FEAT-001 analysis #27

Draft

cursor Bot mentioned this pull request Jul 15, 2026

Merge integration branch to main (workflow commands + FEAT-001 lib refactor) #28

Open

4 tasks

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

SPIKE: menke-5 guide ingest for agent-context store (SPIKE-001 T01)#24

SPIKE: menke-5 guide ingest for agent-context store (SPIKE-001 T01)#24
jmjava wants to merge 14 commits into
mainfrom
cursor/spike-guide-ingest-agent-context-17f4

jmjava commented Jul 5, 2026 •

edited

Loading

Uh oh!

jmjava commented Jul 12, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Conversation

jmjava commented Jul 5, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

SPIKE-001 — Guide as optional DICE context backend

This PR (orchestrator)

Paired guide branch (leg 3)

Test status (2026-07-11)

Canvas ops

Operator flow

Uh oh!

jmjava commented Jul 12, 2026

Sync / test status — 2026-07-11

What was verified

Remaining

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

jmjava commented Jul 5, 2026 •

edited

Loading