FE-698: Design/spec/plan augmentation

[lunelson]

Stack Context

This FE-698 stack establishes the prompt/context scenario substrate and clarifies the adjacent semantic and agent-harness roadmap it unlocks.

What?

• Adds design docs for intent graph semantics, behavioral kernels, deferred reconciliations, and dev workflow evolution.
• Reconciles memory/SPEC.md / memory/PLAN.md with the expanded ontology, progressive checkability, behavioral-kernel, and agent mutation-surface direction.
• Clarifies that future agent-originated writes must route through Brunch-owned mutation handlers rather than direct ORM access.

Why?

The prompt/context substrate sits between current observer/interviewer code and several future agent capabilities. This PR captures the design context needed to sequence those next frontiers without mixing product ontology, dev workflow, and harness-adapter authority.

[lunelson]

• FE-705: Plan agent capability CLI frontier #127
• FE-698: On more context pack + spec for agent CLI v1 #114
• FE-698: Prompt/context scenario substrate foundation #111
• FE-698: Agent mutation audit; tool surface design #104
• FE-698: Design/spec/plan augmentation #103 👈 (View in Graphite)
• FE-698: Scenario runner + observer scenario composition #102
• FE-698: Prompt registry + observer context-pack foundation #101
• FE-698: Prompt/context substrate planning #98
• main

This stack of pull requests is managed by Graphite. Learn more about stacking.

[cursor]

PR Summary

Low Risk
Primarily documentation and roadmap/spec updates with no runtime code changes; risk is limited to alignment/interpretation issues that could affect future implementation planning.

Overview
Adds new canonical design references for upcoming intent-spec work: INTENT_GRAPH_SEMANTICS.md (typed claim kinds/subtypes, edge metadata, relation-policy registry, and progressive-checkability ladder) and BEHAVIORAL_KERNELS.md (kernel taxonomy, signal routing, kernel-card structure, and contrastive-question workflow for FE-702 probes).

Introduces DEV_WORKFLOW_EVOLUTION.md to explicitly separate dev-layer workflow/registry ideas from product-layer ontology, plus DEFERRED_RECONCILIATIONS.md as a trigger-based backlog for future SPEC/PLAN promotions.

Updates memory/PLAN.md and memory/SPEC.md to reference these docs, expand FE-698/FE-700/FE-702 recommended shapes, and add a new requirement/lexicon direction that agent-originated writes must go through a Brunch-owned typed mutation surface (no direct ORM mutations via harnesses/adapters).

^{Reviewed by Cursor Bugbot for commit 3f5a1fc. Bugbot is set up for automated code reviews on this repo. Configure here.}

[augmentcode]

🤖 Augment PR Summary

Summary: This PR expands the intent‑spec synthesis into focused canonical design references and updates the plan/spec to point at them.

Changes:

• Adds docs/design/INTENT_GRAPH_SEMANTICS.md defining the product‑layer intent‑graph ontology (kinds/subtypes), relation taxonomy, edge metadata, relation‑policy registry, and progressive‑checkability binding.
• Adds docs/design/BEHAVIORAL_KERNELS.md defining a v0.1 behavioral‑kernel taxonomy, signal‑phrase routing, kernel cards, contrastive question patterns, and the kernel‑driven interviewer workflow.
• Adds docs/design/DEV_WORKFLOW_EVOLUTION.md capturing the dev‑layer ln-* workflow, pressure points in markdown‑mediated SPEC/PLAN, and a proposed file‑backed spec registry trajectory (with a convergence discussion).
• Adds docs/design/DEFERRED_RECONCILIATIONS.md as an interim backlog of SPEC/PLAN/doc promotions gated by explicit trigger conditions.
• Updates docs/design/README.md and memory/PLAN.md to reference the new docs and refine FE‑698/FE‑700/FE‑702 “Recommended shape” guidance.
• Updates memory/SPEC.md with an explicit dev‑vs‑product layer note, a new requirement around a single Brunch‑owned agent mutation surface, a supporting decision, and related lexicon entries.

Technical Notes: The changes formalize “typed claims + typed edges + witness strength” as the substrate for upcoming kernel probes, topology‑driven question ranking, and scenario‑runner prompt experiments.

_{🤖 Was this summary useful? React with 👍 or 👎}

[augmentcode]

Review completed. 1 suggestion posted.

Comment augment review to trigger a new review at any time.

Latest approval commit d138c56 is not an ancestor of 3f5a1fc, indicating rewritten history after approval

[graphite-app]

Merge activity

• May 8, 11:02 AM UTC: Graphite rebased this pull request, because this pull request is set to merge when ready.