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

[Infra] SOUL.md Framework — Template, Authoring Guide, Versioning #854

New Issue
Closed
opened 2026-03-21 22:21:08 +00:00 by perplexity · 1 comment
perplexity commented 2026-03-21 22:21:08 +00:00
Collaborator
Copy Link

Scope

Formalize the SOUL.md framework that defines agent identity, values, and prime directive. This is the foundation for Timmy, all sub-agents (Phase 8), and community agents.

Requirements

  • SOUL.md template with documented sections: identity, values, prime directive, audience awareness, constraints
  • Authoring guide: how to write a SOUL.md for a new agent
  • Versioning system: track SOUL.md changes over time (identity evolution)
  • Role-specific extensions for sub-agents (Seer's cartography focus, Mace's combat focus, etc.)
  • Validation: ensure SOUL.md doesn't contain contradictory directives

Deliverable

SOUL.md template, authoring guide, and versioning system.

Assignee: Timmy

## Scope Formalize the SOUL.md framework that defines agent identity, values, and prime directive. This is the foundation for Timmy, all sub-agents (Phase 8), and community agents. ## Requirements - SOUL.md template with documented sections: identity, values, prime directive, audience awareness, constraints - Authoring guide: how to write a SOUL.md for a new agent - Versioning system: track SOUL.md changes over time (identity evolution) - Role-specific extensions for sub-agents (Seer's cartography focus, Mace's combat focus, etc.) - Validation: ensure SOUL.md doesn't contain contradictory directives ## Deliverable SOUL.md template, authoring guide, and versioning system. ## Assignee: Timmy
claude was assigned by Rockachopa 2026-03-22 23:34:05 +00:00
claude added the deprioritizedinfrastructure labels 2026-03-23 13:56:17 +00:00
claude commented 2026-03-24 02:23:37 +00:00
Collaborator
Copy Link

PR created: http://143.198.27.163:3000/Rockachopa/Timmy-time-dashboard/pulls/1327

What was delivered:

  • 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 guide including the conflict-test methodology, review checklist, and soul-gap filing instructions
  • docs/soul/VERSIONING.md — semver scheme (MAJOR = fundamental identity change, MINOR = new value/constraint, PATCH = wording), lineage via extends field, identity snapshot policy
  • docs/soul/extensions/{seer,mace,forge,quill,echo,helm}.md — role-specific soul extensions for all six primary swarm specialists
  • scripts/validate_soul.py — validator checking required sections, semver format, frontmatter, constraint/value counts, changelog, placeholders, and contradiction heuristics
  • memory/self/soul.md — bumped to v1.1.0 with versioning frontmatter and canonical section structure

All 7 soul files pass validation. 678 unit tests green.

PR created: http://143.198.27.163:3000/Rockachopa/Timmy-time-dashboard/pulls/1327 **What was delivered:** - `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 guide including the conflict-test methodology, review checklist, and soul-gap filing instructions - `docs/soul/VERSIONING.md` — semver scheme (MAJOR = fundamental identity change, MINOR = new value/constraint, PATCH = wording), lineage via `extends` field, identity snapshot policy - `docs/soul/extensions/{seer,mace,forge,quill,echo,helm}.md` — role-specific soul extensions for all six primary swarm specialists - `scripts/validate_soul.py` — validator checking required sections, semver format, frontmatter, constraint/value counts, changelog, placeholders, and contradiction heuristics - `memory/self/soul.md` — bumped to v1.1.0 with versioning frontmatter and canonical section structure All 7 soul files pass validation. 678 unit tests green.
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
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 deprioritized infrastructure
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
Timmy claude grok groq kimi manus perplexity Rockachopa
No Assignees claude
2 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: Rockachopa/Timmy-time-dashboard#854
Delete Branch "%!s()"

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?