BAZINGA-DB (Deprecated Router)
This skill is deprecated. Use domain-specific skills instead:
| Domain |
Skill |
Use For |
| Sessions & State |
bazinga-db-core |
Sessions, state snapshots, dashboard |
| Tasks & Plans |
bazinga-db-workflow |
Task groups, development plans, success criteria |
| Agent Tracking |
bazinga-db-agents |
Logs, reasoning, tokens, skill output, events |
| Context & Learning |
bazinga-db-context |
Context packages, error patterns, strategies |
Command Routing Table
| Command |
Target Skill |
create-session, get-session, list-sessions |
bazinga-db-core |
update-session-status, save-state, get-state |
bazinga-db-core |
dashboard-snapshot, query, integrity-check |
bazinga-db-core |
recover-db, detect-paths |
bazinga-db-core |
create-task-group, update-task-group, get-task-groups |
bazinga-db-workflow |
save-development-plan, get-development-plan, update-plan-progress |
bazinga-db-workflow |
save-success-criteria, get-success-criteria, update-success-criterion |
bazinga-db-workflow |
log-interaction, stream-logs |
bazinga-db-agents |
save-reasoning, get-reasoning, reasoning-timeline |
bazinga-db-agents |
check-mandatory-phases |
bazinga-db-agents |
log-tokens, token-summary |
bazinga-db-agents |
save-skill-output, get-skill-output, get-skill-output-all |
bazinga-db-agents |
check-skill-evidence |
bazinga-db-agents |
save-event, get-events |
bazinga-db-agents |
save-context-package, get-context-packages, mark-context-consumed |
bazinga-db-context |
update-context-references |
bazinga-db-context |
save-consumption, get-consumption |
bazinga-db-context |
save-error-pattern, get-error-patterns |
bazinga-db-context |
update-error-confidence, cleanup-error-patterns |
bazinga-db-context |
save-strategy, get-strategies |
bazinga-db-context |
update-strategy-helpfulness, extract-strategies |
bazinga-db-context |
Quick Reference
⚠️ DO NOT use CLI directly. Instead, invoke the domain-specific skill:
| Need |
Invoke |
| Session/state ops |
Skill(command: "bazinga-db-core") |
| Task groups/plans |
Skill(command: "bazinga-db-workflow") |
| Logging/reasoning |
Skill(command: "bazinga-db-agents") |
| Context packages |
Skill(command: "bazinga-db-context") |
Reference docs (for skill authors only):
- Schema:
.claude/skills/bazinga-db/references/schema.md
- Examples:
.claude/skills/bazinga-db/references/command_examples.md
If You're Here By Mistake
- Identify what you're trying to do
- Invoke the correct domain skill:
- Session ops? →
Skill(command: "bazinga-db-core")
- Task groups? →
Skill(command: "bazinga-db-workflow")
- Logging/reasoning? →
Skill(command: "bazinga-db-agents")
- Context packages? →
Skill(command: "bazinga-db-context")
Migration Notes
The original monolithic bazinga-db skill (v1.x, 887 lines) has been split into 4 domain-focused skills for better maintainability and to stay within file size limits.
All scripts remain in this directory:
scripts/bazinga_db.py - Main CLI (unchanged)scripts/init_db.py - Database initializationscripts/init_session.py - Session creation helper
All references remain in this directory:
references/schema.md - Full database schemareferences/command_examples.md - Detailed command examples
Technical Notes
Event Idempotency (v17+)
Events support idempotency keys via idx_logs_idempotency unique index:
- Index:
(session_id, event_subtype, group_id, idempotency_key) WHERE idempotency_key IS NOT NULL AND log_type = 'event'
- Pattern: INSERT-first, catch IntegrityError, return existing row
- Recommended key format:
{session_id}|{group_id}|{event_type}|{iteration}
Group ID Validation (v18+)
Three explicit validators for group_id scope (See: research/domain-skill-migration-phase6-ultrathink.md):
| Validator |
Allows 'global' |
Use For |
validate_scope_global_or_group |
✅ Yes |
Events, reasoning, state (session-level) |
validate_scope_group_only |
❌ No |
Investigation state, consumption, strategies |
validate_task_group_id |
❌ No (+ reserved) |
Task group creation (rejects 'session', 'all', 'default') |
Reserved identifiers (cannot be used as task_group_id): global, session, all, default
Legacy Data Diagnostic
# Scan for invalid group_ids (CI/CD)
python3 .claude/skills/bazinga-db/scripts/bazinga_db.py diagnose-group-ids
# Auto-fix issues
python3 .claude/skills/bazinga-db/scripts/bazinga_db.py diagnose-group-ids --fix
Converted and distributed by TomeVault — claim your Tome and manage your conversions.
1---2name: bazinga-db3description: DEPRECATED - Use domain-specific skills instead. Routes to bazinga-db-core, bazinga-db-workflow, bazinga-db-agents, or bazinga-db-context. Use when this capability is needed.4---56# BAZINGA-DB (Deprecated Router)78**This skill is deprecated.** Use domain-specific skills instead:910| Domain | Skill | Use For |11|--------|-------|---------|12| Sessions & State | `bazinga-db-core` | Sessions, state snapshots, dashboard |13| Tasks & Plans | `bazinga-db-workflow` | Task groups, development plans, success criteria |14| Agent Tracking | `bazinga-db-agents` | Logs, reasoning, tokens, skill output, events |15| Context & Learning | `bazinga-db-context` | Context packages, error patterns, strategies |1617## Command Routing Table1819| Command | Target Skill |20|---------|--------------|21| `create-session`, `get-session`, `list-sessions` | `bazinga-db-core` |22| `update-session-status`, `save-state`, `get-state` | `bazinga-db-core` |23| `dashboard-snapshot`, `query`, `integrity-check` | `bazinga-db-core` |24| `recover-db`, `detect-paths` | `bazinga-db-core` |25| `create-task-group`, `update-task-group`, `get-task-groups` | `bazinga-db-workflow` |26| `save-development-plan`, `get-development-plan`, `update-plan-progress` | `bazinga-db-workflow` |27| `save-success-criteria`, `get-success-criteria`, `update-success-criterion` | `bazinga-db-workflow` |28| `log-interaction`, `stream-logs` | `bazinga-db-agents` |29| `save-reasoning`, `get-reasoning`, `reasoning-timeline` | `bazinga-db-agents` |30| `check-mandatory-phases` | `bazinga-db-agents` |31| `log-tokens`, `token-summary` | `bazinga-db-agents` |32| `save-skill-output`, `get-skill-output`, `get-skill-output-all` | `bazinga-db-agents` |33| `check-skill-evidence` | `bazinga-db-agents` |34| `save-event`, `get-events` | `bazinga-db-agents` |35| `save-context-package`, `get-context-packages`, `mark-context-consumed` | `bazinga-db-context` |36| `update-context-references` | `bazinga-db-context` |37| `save-consumption`, `get-consumption` | `bazinga-db-context` |38| `save-error-pattern`, `get-error-patterns` | `bazinga-db-context` |39| `update-error-confidence`, `cleanup-error-patterns` | `bazinga-db-context` |40| `save-strategy`, `get-strategies` | `bazinga-db-context` |41| `update-strategy-helpfulness`, `extract-strategies` | `bazinga-db-context` |4243## Quick Reference4445⚠️ **DO NOT use CLI directly.** Instead, invoke the domain-specific skill:4647| Need | Invoke |48|------|--------|49| Session/state ops | `Skill(command: "bazinga-db-core")` |50| Task groups/plans | `Skill(command: "bazinga-db-workflow")` |51| Logging/reasoning | `Skill(command: "bazinga-db-agents")` |52| Context packages | `Skill(command: "bazinga-db-context")` |5354**Reference docs (for skill authors only):**55- Schema: `.claude/skills/bazinga-db/references/schema.md`56- Examples: `.claude/skills/bazinga-db/references/command_examples.md`5758## If You're Here By Mistake59601. Identify what you're trying to do612. Invoke the correct domain skill:62 - Session ops? → `Skill(command: "bazinga-db-core")`63 - Task groups? → `Skill(command: "bazinga-db-workflow")`64 - Logging/reasoning? → `Skill(command: "bazinga-db-agents")`65 - Context packages? → `Skill(command: "bazinga-db-context")`6667## Migration Notes6869The original monolithic bazinga-db skill (v1.x, 887 lines) has been split into 4 domain-focused skills for better maintainability and to stay within file size limits.7071**All scripts remain in this directory:**72- `scripts/bazinga_db.py` - Main CLI (unchanged)73- `scripts/init_db.py` - Database initialization74- `scripts/init_session.py` - Session creation helper7576**All references remain in this directory:**77- `references/schema.md` - Full database schema78- `references/command_examples.md` - Detailed command examples7980## Technical Notes8182### Event Idempotency (v17+)8384Events support idempotency keys via `idx_logs_idempotency` unique index:85- Index: `(session_id, event_subtype, group_id, idempotency_key)` WHERE `idempotency_key IS NOT NULL AND log_type = 'event'`86- Pattern: INSERT-first, catch IntegrityError, return existing row87- Recommended key format: `{session_id}|{group_id}|{event_type}|{iteration}`8889### Group ID Validation (v18+)9091Three explicit validators for group_id scope (See: research/domain-skill-migration-phase6-ultrathink.md):9293| Validator | Allows 'global' | Use For |94|-----------|-----------------|---------|95| `validate_scope_global_or_group` | ✅ Yes | Events, reasoning, state (session-level) |96| `validate_scope_group_only` | ❌ No | Investigation state, consumption, strategies |97| `validate_task_group_id` | ❌ No (+ reserved) | Task group creation (rejects 'session', 'all', 'default') |9899Reserved identifiers (cannot be used as task_group_id): `global`, `session`, `all`, `default`100101### Legacy Data Diagnostic102103```bash104# Scan for invalid group_ids (CI/CD)105python3 .claude/skills/bazinga-db/scripts/bazinga_db.py diagnose-group-ids106107# Auto-fix issues108python3 .claude/skills/bazinga-db/scripts/bazinga_db.py diagnose-group-ids --fix109```110111---112> Converted and distributed by [TomeVault](https://tomevault.io/claim/mehdic) — claim your Tome and manage your conversions.113<!-- tomevault:4.0:skill_md:2026-04-11 -->
tomevault-io