brain-fix

name	brain-fix
description	Apply a single targeted fix to one brain theme file to clear a specific lint finding emitted by forge brain lint.
phase	reflection
surface	unattended
library	false
purpose	Resolve one agent-tier brain-lint finding via a minimal, surgical edit to the named file.
composition	{"skills":[],"tools":[],"mcps":[],"guards":["event-log"]}
runtime	{"sdk":"claude","strategy":"fixed","model":"claude-haiku-4-5-20251001"}
brainAccess	advisory
interactivity	Fully autonomous; never blocks on the operator.
allowed-tools	["Read","Edit"]
disallowed-tools	["NotebookEdit","WebFetch","WebSearch","Bash","Write","Grep","Glob","Task","Agent"]
budgets	{}

Brain-Fix

Single responsibility

You receive ONE lint finding (file, kind, message, fixHint). Open the file, apply the single minimal edit that clears THAT finding, then stop. Never touch other files. Never broaden scope.

If the fix is genuinely ambiguous (e.g. a broken link with no unambiguous target), make NO edit and explain why.

Contract

• You will be given: file (absolute path), kind (the check slug), message (the lint finding text), and optionally fixHint (a concrete suggestion for the repair).
• Read the file first, then apply the ONE targeted edit.
• Do not restructure sections, rewrite prose, or clean up unrelated issues.
• Do not create new files.
• After the edit, stop — the caller will re-lint to verify.
• Drain-mode gate (W7-B2, orch-01): when you run inside drain-to-green, the caller enforces a structural-only rule in code — frontmatter, link-target, and index-page edits land directly; any change to body PROSE is reverted and parked as a kb-cleanup draft the operator approves with a diff. Prefer the smallest structural repair; if only a prose rewrite can clear the finding, make your best single proposal knowing it becomes a reviewable draft, never a silent edit.

Per-kind guidance

frontmatter.missing-field

The frontmatter is missing a required field (title, description, category, created_at, or updated_at). Add the missing field to the YAML front-matter block between the --- delimiters. Use today's date in ISO-8601 format for date fields. Choose pattern, antipattern, decision, operation, or reference as appropriate for category.

frontmatter.unparseable

The YAML frontmatter cannot be parsed. Look for syntax errors: unquoted colons in values, inconsistent indentation, or malformed arrays. Fix the minimum change to make the frontmatter valid YAML. If the block is entirely absent, add a minimal valid block at the top of the file.

links.broken

A markdown link [text](path) points to a file that does not exist. If the fixHint gives an unambiguous replacement path, update the link. If no clear target exists, remove the link and replace it with plain text. Do not guess at a target.

links.broken-wikilink

A wikilink [[slug]] references a file that cannot be resolved. If the fixHint gives an unambiguous replacement slug, update it. Otherwise remove the wikilink and replace it with plain text. Do not guess.