Files
agentic-resources/workplans/AGENTIC-WP-0008-read-before-edit-reflex.md
tegwick 9e6f8a6e08 Register WP-0007 (Distribute), WP-0008 (Read-before-Edit), WP-0009 (Measure)
Three workplans queued and registered with the State Hub (via REST — MCP write
layer is erroring this session):
- AGENTIC-WP-0007 Phase 3 Distribute: per-flavor distributor adapters render
  approved catalog patterns into proposed (HITL) artifacts, scoped by repo/domain.
- AGENTIC-WP-0008 Read-before-Edit reflex: act on the #1 friction finding.
- AGENTIC-WP-0009 Phase 4 Measure: baseline + before/after effectiveness + trend.
Proceeding in that order.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-07 14:58:03 +02:00

2.1 KiB

id, type, title, domain, repo, status, owner, topic_slug, created, updated, state_hub_workstream_id
id type title domain repo status owner topic_slug created updated state_hub_workstream_id
AGENTIC-WP-0008 workplan Act on #1 friction — Read-before-Edit reflex helix_forge agentic-resources ready codex helix-forge 2026-06-07 2026-06-07 6aac5cfc-4799-4d07-9537-42a203af2d1b

Act on #1 Friction — Read-before-Edit Reflex

The error-body mining (AGENTIC-WP-0006) found that the single most common error across real coding sessions is File has not been read yet. Read it first before writing to it. — Edit/Write before Read, in 12 of 27 sessions across 8 repos — followed by the stale-read File has been modified since read (6 sessions). See ASSESSMENT-infra-friction.md.

This is the cheapest high-value fix surfaced by the whole analysis: a short behavioural reflex in the agent instructions. We also capture it as a curated SolutionPattern so Phase 3 Distribute can propose it to other repos/flavors — closing the assess → curate → distribute loop by hand for one real pattern.

Add Read-before-Edit Reflex to Agent Instructions

id: AGENTIC-WP-0008-T01
status: todo
priority: high
state_hub_task_id: "549c84c1-5bd8-4ff6-b61d-1c72946b8b8e"

Add a concise, data-cited Read-before-Edit / re-read-on-"modified since read" reflex to AGENTS.md (and note for CLAUDE.md), targeting the #1 and #2 recurring errors. Keep it short to avoid context bloat (cf. PRD OQ6 — pattern bloat degrades context budgets).

Capture as Curated SolutionPattern for Distribute

id: AGENTIC-WP-0008-T02
status: todo
priority: medium
state_hub_task_id: "c007baf9-db14-40fa-b944-d1f1a71ea28b"

Promote the recurring "file not read" problem into a curated SolutionPattern in the Pattern Catalog with per-flavor rendering_hints, so Phase 3 Distribute can render and propose it across repos/flavors. Links assess → curate → distribute end to end on a real pattern. After updates, notify the operator to run make fix-consistency REPO=agentic-resources.