fix: normalize section headers so OpenClaw SOUL.md isn't empty (15 agents) (#704)

convert.sh's OpenClaw conversion routes persona sections (Identity,
Communication, Critical Rules, Style, Learning & Memory) to SOUL.md and
everything else to AGENTS.md by matching `## ` header keywords. 15 agents
produced an empty SOUL.md because no header matched — the same class as the
#670 fix. Two distinct causes, two minimal fixes:

- 13 agents used a `##`-level persona section under a non-canonical name
  ("Role Definition" / "Core Expertise"). Renamed to "Identity & Role
  Definition" / "Identity & Core Expertise" — header text only, zero content
  change (each is a clean +1/-1 diff).
- 2 agents (french-consulting-market, salesforce-architect) had full persona
  sections but at `#` (H1) with no title — the literal #670 bug. Shifted every
  header one level deeper (fence-aware, so code-block content is untouched) and
  added a `# <Name>` title. These now lint 0/0.

Verified: 0 "no section headers map to SOUL.md" warnings remain (was 15);
regenerated OpenClaw output confirms all 15 SOUL.md files are now populated
with the persona; AGENTS.md retains operations; no agent content changed;
guards green. Total lint warnings 87 -> 59 (remaining are advisory
"missing Core Mission/Critical Rules", intentionally not forced).


Claude-Session: https://claude.ai/code/session_01WKnDRWM4izsB8WAXKszhsq

Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
Michael Sitarzewski
2026-07-09 15:32:59 -05:00
committed by GitHub
parent 94a37671ac
commit 9f3e401ccd
15 changed files with 47 additions and 43 deletions
+1 -1
View File
@@ -9,7 +9,7 @@ vibe: Distills a thousand user voices into the five things you need to build nex
# Product Feedback Synthesizer Agent
## Role Definition
## Identity & Role Definition
Expert in collecting, analyzing, and synthesizing user feedback from multiple channels to extract actionable product insights. Specializes in transforming qualitative feedback into quantitative priorities and strategic recommendations for data-driven product decisions.
## Core Capabilities
+1 -1
View File
@@ -9,7 +9,7 @@ vibe: Spots emerging trends before they hit the mainstream.
# Product Trend Researcher Agent
## Role Definition
## Identity & Role Definition
Expert market intelligence analyst specializing in identifying emerging trends, competitive analysis, and opportunity assessment. Focused on providing actionable insights that drive product strategy and innovation decisions through comprehensive market research and predictive analysis.
## Core Capabilities