Skip to content

[codex] Clarify sparse Fabric provenance guidance#9

Merged
lutefd merged 1 commit into
mainfrom
codex/docs-sparse-provenance-skills
Jul 2, 2026
Merged

[codex] Clarify sparse Fabric provenance guidance#9
lutefd merged 1 commit into
mainfrom
codex/docs-sparse-provenance-skills

Conversation

@lutefd

@lutefd lutefd commented Jul 2, 2026

Copy link
Copy Markdown
Owner

Summary

  • Clarifies that Fabric session workflows should record causal provenance only at meaningful checkpoints with stable provider object IDs.
  • Tightens the provenance skill so informed_by and implements relations stay sparse and are not inferred from available context.
  • Updates the direction-recording skill to explicitly exclude provenance, exposure receipts, and 'I used this direction' facts from direction notes.
  • Adds template regression checks for the provenance/direction boundary.

Rationale

Fabric Lens and similar visualizers need causal edges to exist, but those edges should not pollute direction. This change makes the agent-facing guidance more explicit: direction remains reusable project guidance, while exposure and causality belong in provenance relations.

Impact

Agents generated from these templates should be less likely to either skip meaningful causal receipts or incorrectly store provenance as direction. Existing users only see documentation/skill behavior changes.

Validation

  • go test ./...
  • git diff --check
  • fabric sync reported no new relevant direction for the active visualizer/provenance thread.

@lutefd lutefd marked this pull request as ready for review July 2, 2026 17:28
@lutefd lutefd merged commit b297205 into main Jul 2, 2026
2 checks passed
@lutefd lutefd deleted the codex/docs-sparse-provenance-skills branch July 2, 2026 17:52
@lutefd lutefd mentioned this pull request Jul 2, 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