How an0099/toothpaste-kit works
Toothpaste Kit is a human-governed toolkit for multi-agent work: skills guide agent and person workflows, while a relay protocol defines cross-surface handoffs and sensitivity-aware routing. Its main workflow is a person or lead agent invoking a skill or protocol to coordinate work, preserve legible state, and halt for human decisions at gates. The README documents substantial skills, orchestration, registry, schemas, and example-workspace capabilities; these are represented at their exact directories where implementation excerpts were unavailable. Sampled scripts are peripheral mechanical checks, not the product runtime.
Main entry points: protocol.md Relay Protocol · standing-documents.md Standing Documents · check-workspace-stubs.py Stub Checker · session-close Session Procedures
Components 23
Agent Skills
- Behavior Skills
skills/working-preferences - Document Skills
skills/document-standards - Surface Regimes
skills/surface-regimes - Skill Lifecycle
skills/skill-creation - Skill Discovery
skills/skill-discovery - Session Procedures
skills/session-close - Review Procedures
skills/daily-review - Capture Procedures
skills/session-log - Redaction Gate
skills/redaction-gate
Agent Relay
- Relay Protocol
orchestration/protocol.md - Sensitivity Routing
orchestration/ROUTING-THRESHOLD.md - Capability Taxonomy
orchestration/taxonomy.md - Surface Registry
orchestration/registry - Message Schemas
orchestration/schemas - Handoff Templates
orchestration/templates
Workspace State
- Workspace Stubs
examples/workspace - Standing Documents
docs/standing-documents.md
Mechanical Gates
- Hook Rules
hooks - Markdown Linter
scripts/mdlint.py - Markdown Reflow
scripts/reflow-md.py - Stub Checker
scripts/check-workspace-stubs.py
Other components
- Person
- Lead Agent
Connections 23
- Person → Session Procedures: invokes
README.md - Person → Review Procedures: invokes
README.md - Person → Redaction Gate: decides at
README.md - Lead Agent → Behavior Skills: loads
README.md - Lead Agent → Document Skills: loads
README.md - Lead Agent → Surface Regimes: detects regime
README.md - Lead Agent → Skill Lifecycle: uses
README.md - Lead Agent → Skill Discovery: uses
README.md - Lead Agent → Capture Procedures: records with
README.md - Lead Agent → Relay Protocol: relays work
README.md - Relay Protocol → Sensitivity Routing: gates dispatch
README.md - Relay Protocol → Message Schemas: uses messages
README.md - Relay Protocol → Surface Registry: consults surfaces
- Relay Protocol → Capability Taxonomy: classifies capability
- Relay Protocol → Handoff Templates: uses templates
- Session Procedures → Standing Documents: updates
README.md - Review Procedures → Standing Documents: reads
README.md - Workspace Stubs → Standing Documents: stubs describe
README.md - Hook Rules → Redaction Gate: warns on reads
- Person → Markdown Linter: checks documents
- Person → Markdown Reflow: reflows documents
- Stub Checker → Workspace Stubs: checks names
scripts/check-workspace-stubs.py - Stub Checker → Standing Documents: checks listing
scripts/check-workspace-stubs.py