What problem does it solve? Writing to the PhyCool Context Memory SQLite database through MCP tools fails in six recurring ways: missing required fields, enum case violations, UTC versus UTC+8 timestamp drift, duplicate writes, UTF-8 BOM breaking JSON parsing, and SQLITE_BUSY errors from concurrent writes. This Skill provides the tool catalog, schema cheat-sheet, and mandatory call discipline to prevent all six failure modes. ## Core Features & Use Cases - 36-Tool Catalog with Required Fields: Complete reference of every phycool-context MCP tool (Add, Upsert, Search, Get, Workflow, Instinct, Worker Protocol, Ctrl-Channel) with required fields, enums, and CAS semantics. - 30+ Table Schema Cheat-Sheet: Column-level documentation for stories, intentional_decisions, tech_debt_items, worker_runs, ctrl_threads, and more, including hot-row conflict markers. - Six Root-Cause Error Patterns with Fixes: Concrete wrong/right examples for each failure mode, plus the Invoke-PhycoolMcpSafe PowerShell helper that bundles validation, UTF-8 No-BOM encoding, UTC+8 timestamps, and SQLITE_BUSY retry with exponential backoff. - Use Case: Before calling add_intentional_decision from a PowerShell pipeline, check the catalog to confirm sub_type is required, route the call through Invoke-PhycoolMcpSafe, and run a search-first dedup check to avoid polluting the database. ## Quick Start Ask the AI to write a new context entry to the memory database using the MCP discipline rules, verifying required fields and using search-first dedup before the add_context call.
