Rockachopa/Timmy-time-dashboard
1
0
Fork 2
Code Issues 7 Pull Requests Actions Packages Projects Releases Wiki Activity

[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
Conversation 0 Commits 1 Files Changed 11 +1516 -12
claude commented 2026-03-24 02:23:28 +00:00
Collaborator
Copy Link

Fixes #854

What this PR does

Formalizes the SOUL.md framework that defines agent identity, values, and prime directive.

New files

  • docs/soul/SOUL_TEMPLATE.md — canonical blank template with all required sections: identity, prime directive, values, audience awareness, constraints, changelog
  • docs/soul/AUTHORING_GUIDE.md — section-by-section authoring guide with conflict-test methodology, review checklist, community agent rules, and soul-gap filing instructions
  • docs/soul/VERSIONING.md — semver versioning scheme (MAJOR/MINOR/PATCH rules), lineage tracking via extends field, identity snapshots on MAJOR version bumps
  • docs/soul/extensions/seer.md — research/cartography specialist soul
  • docs/soul/extensions/mace.md — security/threat-intel specialist soul
  • docs/soul/extensions/forge.md — software engineering specialist soul
  • docs/soul/extensions/quill.md — documentation/writing specialist soul
  • docs/soul/extensions/echo.md — memory recall specialist soul
  • docs/soul/extensions/helm.md — workflow orchestration specialist soul
  • scripts/validate_soul.py — validator: required sections, semver format, frontmatter completeness, constraint/value counts, changelog presence, placeholder detection, contradiction heuristics

Updated files

  • memory/self/soul.md — bumped to v1.1.0; added versioning frontmatter; restructured into the canonical SOUL.md section format

Validation

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

Fixes #854 ## What this PR does Formalizes the SOUL.md framework that defines agent identity, values, and prime directive. ### New files - **`docs/soul/SOUL_TEMPLATE.md`** — canonical blank template with all required sections: identity, prime directive, values, audience awareness, constraints, changelog - **`docs/soul/AUTHORING_GUIDE.md`** — section-by-section authoring guide with conflict-test methodology, review checklist, community agent rules, and soul-gap filing instructions - **`docs/soul/VERSIONING.md`** — semver versioning scheme (MAJOR/MINOR/PATCH rules), lineage tracking via `extends` field, identity snapshots on MAJOR version bumps - **`docs/soul/extensions/seer.md`** — research/cartography specialist soul - **`docs/soul/extensions/mace.md`** — security/threat-intel specialist soul - **`docs/soul/extensions/forge.md`** — software engineering specialist soul - **`docs/soul/extensions/quill.md`** — documentation/writing specialist soul - **`docs/soul/extensions/echo.md`** — memory recall specialist soul - **`docs/soul/extensions/helm.md`** — workflow orchestration specialist soul - **`scripts/validate_soul.py`** — validator: required sections, semver format, frontmatter completeness, constraint/value counts, changelog presence, placeholder detection, contradiction heuristics ### Updated files - **`memory/self/soul.md`** — bumped to v1.1.0; added versioning frontmatter; restructured into the canonical SOUL.md section format ### Validation All 7 soul files pass `python3 scripts/validate_soul.py`. 678 unit tests green.
claude added 1 commit 2026-03-24 02:23:28 +00:00
feat: SOUL.md framework — template, authoring guide, versioning (#854)
Some checks failed
Tests / lint (pull_request) Failing after 34s
Details
Tests / test (pull_request) Has been skipped
Details
280e48d3fa 
- 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>
claude merged commit c0fad202ea into main 2026-03-24 02:23:47 +00:00
claude deleted branch claude/issue-854 2026-03-24 02:23:47 +00:00
Sign in to join this conversation.
Reviewers
No Reviewers
Labels
Clear labels
222-epic
Workshop: Timmy as Presence (Epic #222)
 actionable
Has a concrete code/config task extracted
 assigned-claude
Issue currently assigned to Claude agent — do not assign to another agent
 assigned-gemini
Issue currently assigned to Gemini agent — do not assign to another agent
 assigned-groq
assigned-kimi
Issue currently assigned to Kimi agent — do not assign to another agent
 assigned-manus
Issue currently assigned to Manus agent — do not assign to another agent
 claude-ready
consolidation
Part of a consolidation epic
 deprioritized
Keep open but not blocking P0 work
 deprioritized
Keep open but not blocking P0 work
 duplicate
Duplicate of another issue
 gemini-review
Auto-generated by Gemini, needs relevance review
 groq-ready
harness
Core product: agent framework, heartbeat, inference, memory
 heartbeat
Harness: Agent heartbeat loop
 inference
Harness: Inference and model routing
 infrastructure
Supporting stage: dashboard, CI/CD, deployment, DNS
 kimi-ready
Scoped and ready for Kimi to pick up
 memory-session
Harness: Memory and session crystallization
 morrowind
Harness: Morrowind embodiment
 needs-design
Needs architectural design before implementation
 needs-extraction
Philosophy with unextracted engineering work
 p0-critical
Priority 0: Must fix now
 p1-important
Priority 1: Important, next sprint
 p2-backlog
Priority 2: Backlog, do when time permits
 philosophy
Philosophical foundation — informs architecture decisions
 rejected-direction
Closed: rejected or superseded direction
 seed:know-purpose
Three Seeds: KNOW YOUR PURPOSE
 seed:serve-real
Three Seeds: SERVE THE REAL
 seed:tell-truth
Three Seeds: TELL THE TRUTH
 sovereignty
Harness: Sovereignty stack
No Label
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
Timmy claude grok groq kimi manus perplexity Rockachopa
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: Rockachopa/Timmy-time-dashboard#1327
Delete Branch "claude/issue-854"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?