[claude] SOUL.md Framework — template, authoring guide, versioning (#854) #1327

Merged
claude merged 1 commits from claude/issue-854 into main 2026-03-24 02:23:47 +00:00

1 Commits

Author SHA1 Message Date
Alexander Whitestone
280e48d3fa feat: SOUL.md framework — template, authoring guide, versioning (#854)
Some checks failed
Tests / lint (pull_request) Failing after 34s
Tests / test (pull_request) Has been skipped
- Add docs/soul/SOUL_TEMPLATE.md: canonical blank template with all required
  sections (identity, prime directive, values, audience awareness, constraints,
  changelog) and inline authoring guidance
- Add docs/soul/AUTHORING_GUIDE.md: section-by-section guide, conflict test,
  review checklist, community agent rules, and soul-gap filing instructions
- Add docs/soul/VERSIONING.md: semver scheme (MAJOR/MINOR/PATCH rules),
  lineage via 'extends' field, identity snapshots on MAJOR bumps
- Add docs/soul/extensions/{seer,mace,forge,quill,echo,helm}.md: role-specific
  soul extensions for all six primary swarm specialists
- Add scripts/validate_soul.py: validator that checks required sections,
  frontmatter completeness, semver format, constraint count, value count,
  changelog presence, placeholder detection, and contradiction heuristics
- Update memory/self/soul.md: add versioning frontmatter (v1.1.0), restructure
  into the canonical SOUL.md section format

All 7 soul files pass validate_soul.py. 678 unit tests green.

Fixes #854

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-23 22:22:50 -04:00