Aiwg soul-apply

Apply a SOUL.md identity to content generation, incorporating worldview, opinions, and character

install

source · Clone the upstream repo

git clone https://github.com/jmagly/aiwg

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/jmagly/aiwg "$T" && mkdir -p ~/.claude/skills && cp -r "$T/.agents/skills/soul-apply" ~/.claude/skills/jmagly-aiwg-soul-apply && rm -rf "$T"

manifest: .agents/skills/soul-apply/SKILL.md

source content

soul-apply

Apply a SOUL.md identity to content generation — deeper than voice-apply, incorporating worldview, opinions, and character.

Triggers

Alternate expressions and non-obvious activations (primary phrases are matched automatically from the skill description):

"apply soul" → voice enforcement via SOUL.md
"write in our voice" → soul-based writing

Behavior

When triggered, this skill applies the loaded SOUL.md to any content generation task. Unlike

/voice-apply

which adjusts writing style (tone, formality, sentence structure),

/soul-apply

incorporates the agent's identity — worldview shapes arguments, opinions influence recommendations, vocabulary infuses the text, and boundaries constrain what gets said.

Application Layers

Layer	What Changes	Source Section
Worldview	How arguments are framed, what's treated as axiomatic	Worldview
Opinions	Which positions are taken on debatable topics	Opinions
Vocabulary	Which terms are used and their specific meanings	Vocabulary
Boundaries	What the agent won't say or recommend	Boundaries
Tensions	Where the agent acknowledges complexity	Tensions
Tone	How confident, direct, or warm the output feels	Who I Am + Pet Peeves

Application Process

Load soul file —
```
./SOUL.md
```
,
```
./.aiwg/SOUL.md
```
, or specified path
Load per-agent soul if active agent has a companion
```
.soul.md
```
Internalize identity — not as rules to follow, but as character to inhabit
Generate content with soul actively shaping:
- Arguments derived from worldview, not generic reasoning
- Opinions stated where relevant, not hedged away
- Vocabulary used naturally, not forced
- Boundaries respected silently (no meta-commentary about what was avoided)
- Tensions acknowledged when the topic touches contradictions
Verify output against soul — would this person actually write this?

Application Modes

Explicit Mode

User invokes

/soul-apply

with specific content:

/soul-apply "Write a recommendation for our database migration strategy"

The soul shapes the recommendation — e.g., if the soul values simplicity, it might recommend PostgreSQL over a microservices data mesh.

Passive Mode

When soul enforcement is enabled via

/soul-enable

, the soul is passively applied to all content generation.

/soul-apply

is the explicit version of what the enforcement rule does implicitly.

Revision Mode

Apply soul to existing content:

/soul-apply --revise ./docs/architecture-decision.md

Rewrites the document to reflect the soul's worldview, opinions, and voice while preserving the factual content.

What Soul Application Looks Like

Without soul (generic):

We should consider using microservices for this project. There are several
approaches to consider, each with trade-offs. The team should evaluate
what works best for their specific situation.

With soul (engineer who values simplicity):

Start with a monolith. Most teams split too early, and you'll spend more
time on service boundaries than on the actual problem. If you hit a genuine
scaling bottleneck — not a hypothetical one — extract that specific piece.
A well-structured monolith beats a distributed monolith with network latency
every time.

Without soul (generic code review):

This function could benefit from some refactoring. Consider breaking it
into smaller pieces for better readability and testability.

With soul (skeptical engineer):

This function is 40 lines and does one thing. That's fine. Don't split it
into three functions that each need the same context passed through parameters.
The current version is readable at 3 AM — splitting it would make it harder
to follow, not easier.

Parameters

Flag	Description
`--soul <path>`	Use a specific soul file (default: auto-detect)
`--revise <path>`	Revise existing content through the soul
`--compare`	Show before/after comparison
`--intensity <low\|medium\|high>`	How strongly the soul shapes output (default: medium)

Intensity Levels

Level	Behavior
`low`	Subtle influence — vocabulary and tone shift, opinions only when directly relevant
`medium`	Clear character — worldview shapes framing, opinions stated naturally, vocabulary consistent
`high`	Full character — strong opinions, distinctive voice, boundaries enforced, contradictions surfaced

Integration

With Voice Framework

When both soul and voice profile are active:

Soul controls what is said (opinions, worldview, boundaries)
Voice controls how it sounds (sentence structure, formality, tone scales)
If they conflict, soul takes precedence on content; voice takes precedence on syntax

With soul-enable

When enforcement is active,

/soul-apply

is redundant for new content — the soul is already being applied. Use

/soul-apply

for:

Explicit revision of existing content
Switching between soul files mid-session
Testing soul application before enabling enforcement

Verification

After application, the output should pass the soul prediction test:

"Would someone who read the SOUL.md predict this output came from this persona?"

If not, the soul may be too vague — recommend

/soul-enhance

Examples

# Apply soul to a content generation task
/soul-apply "Write a post about why we chose PostgreSQL"

# Revise existing content through the soul
/soul-apply --revise docs/architecture-decision.md

# Apply with high intensity (strong character)
/soul-apply --intensity high "Review this PR's architectural approach"

# Use a specific soul file
/soul-apply --soul .claude/agents/security-auditor.soul.md "Assess this auth flow"

# Compare before/after
/soul-apply --revise --compare docs/team-practices.md

References

@$AIWG_ROOT/agentic/code/addons/voice-framework/skills/voice-apply/SKILL.md — Voice application (complementary)
@$AIWG_ROOT/agentic/code/addons/aiwg-utils/rules/soul-enforcement.md — Passive enforcement rule
@$AIWG_ROOT/agentic/code/addons/aiwg-utils/skills/soul-create/SKILL.md — Soul creation
@$AIWG_ROOT/docs/soul-md-guide.md — Integration guide
#437 — SOUL.md compatibility issue (Phase 2)