How lvninety9/soulmate-4 works
Soulmate 4 is a Kilo Code harness for guiding local-model work through small sub-tasks and enforcing handoffs. The principal workflow starts with a user request: Kilo loads project rules, the agent follows the matching protocol, and the sub-task gate blocks further mutations after a handoff unless the user deliberately waives the standing checkpoint. Separate capabilities support bootstrapping, cap enforcement, and two-layer sub-task review. Relationships below follow README statements only; source excerpts were not available, so implementation details beyond those documented are omitted.
Main entry points: AGENTS.md Project instructions · subtask-gate.ts Sub-task gate · post-commit-subtask-report Post-commit hook · subtask-report.sh Evidence report
Components 16
Work workflow
- Project instructions
AGENTS.md - Workflow protocols
wiki/protocols - Session handoff
wiki/handoffs/SESSION_PRIMER.md - Project knowledge
wiki/PROJECT_BACKGROUND.md - Rules and evidence
wiki/rule-archive.md
Guardrails
- Sub-task gate
.kilo/plugins/subtask-gate.ts - Cap enforcement
scripts/check-caps.sh - Pre-commit check
scripts/pre-commit-check-caps
Sub-task review
- Evidence report
scripts/subtask-report.sh - Local-model review
scripts/subtask-review-llm.sh - Boundary resolver
scripts/lib/subtask-range.sh - Post-commit hook
scripts/post-commit-subtask-report
Project adoption
- Project bootstrap
scripts/bootstrap.sh - Adoption templates
templates
Other components
- User
- Kilo Code
Connections 14
- User → Kilo Code: requests work
README.md - Kilo Code → Project instructions: loads instructions
README.md - Project instructions → Workflow protocols: directs agent
README.md - Kilo Code → Workflow protocols: reads matching step
README.md - Sub-task gate → Session handoff: checks handoff boundary
README.md - Sub-task gate → Kilo Code: blocks mutation
README.md - Pre-commit check → Cap enforcement: enforces caps
README.md - Post-commit hook → Evidence report: runs layer one
README.md - Post-commit hook → Local-model review: runs layer two
README.md - Evidence report → Boundary resolver: resolves boundary
README.md - Local-model review → Boundary resolver: resolves boundary
README.md - Project bootstrap → Adoption templates: copies templates
README.md - Project instructions → Project knowledge: maps project context
README.md - Project instructions → Rules and evidence: records rule evidence
README.md