Skill Claude CodeCodex
Decide what to PERSIST in your data structures (graph nodes, DB tables, cache layouts) based on the QUERIES you must answer, not the DEFINITIONS that justify the data. Definitions tell you logical identity; storage strategy is independent. Materializing every definitional component leads to O(N×M) blow-ups that…
Skill Claude CodeCodex
Run automated QA checks on Grafema VS Code extension via Playwright + MCP cross-validation. Use when: (1) user says "/qa" to start or resume QA session, (2) user wants to validate extension panels against graph data, (3) user wants to re-check previously found bugs after a fix, (4) user wants to run a custom QA task.…
Skill Claude CodeCodex
A routine for examining decisions while work is happening and after it is finished. It uses established reflection frameworks and the listed KAMI values to question assumptions and reasoning.
Skill Claude CodeCodex
Fix nodes silently disappearing from RFDB when an enricher or post-resolution pass writes new nodes via BatchHandle. Use when: (1) writing a TypeScript enricher that should ADD nodes/edges to existing files, (2) after calling client.createBatch() + batch.addNode({file: 'X', ...}) + batch.commit() the original nodes in…
Skill Claude CodeCodex
Fix silent incorrect results in RFDB Datalog queries that share a variable between two edge atoms on opposite ends (e.g. self-join patterns like edge(M, C, "T1"), edge(C, M, "T2")). Use when: (1) a Datalog rule returns rows that look structurally wrong (e.g. a self-loop rule reports hits but pinning M to each reported…
Skill Claude CodeCodex
Diagnose and fix RFDB data disappearing after compaction, where rfdb-server reports a tiny node count (e.g. "15 nodes") on startup despite manifestindex.json showing hundreds of thousands of nodes and segment files existing on disk. Use when: (1) rfdb-server logs "Default database: N nodes" with N orders of magnitude…
Skill Claude CodeCodex
Recover from stale RFDB nodes that survive commitbatch cleanup despite having their file field listed in changedfiles. Use when: (1) re-running an enricher/orchestrator step but old data with the same file field stays in the graph, (2) commitbatch(changedfiles=[X], ...) reports success but a query later still returns…
Skill Claude CodeCodex
Fix RFDB V2 graph data silently not persisting to disk after analysis. Use when: (1) rfdb-server reports "0 nodes, 0 edges" on restart despite successful analysis, (2) segment directories exist but are empty (no .bin files), (3) manifestindex.json shows totalnodes: 0 despite analysis logging 70k+ nodes, (4) Docker…
Skill Claude CodeCodex
RFDB server becomes unresponsive (60s+ timeouts) during enricher addEdges write storms. Use when: (1) RFDB CPU spikes to 60-90% after addEdges calls; (2) subsequent reads time out at 60s; (3) server stays catatonic for 5-15 min after a write storm; (4) Tokio main thread parked (write-lock contention). Root cause…
Skill Claude CodeCodex
Speed up Rust development iteration when cargo build --release takes 10+ minutes even for one-line edits. Use when: (1) every release rebuild takes minutes despite tiny edits, (2) Cargo.toml has lto = "fat" and/or codegen-units = 1 in [profile.release], (3) you want a production- shaped build for testing without…
Skill Claude CodeCodex
Force rust-embed to re-embed assets from $GRAFEMAUIDIST (or any env-driven path) when cargo's incremental compilation skips the macro re-expansion. Use when: (1) you rebuilt the GUI bundle but the rust-server binary still serves the OLD bundle, (2) cargo build --release finishes in seconds (incremental hit) and…
Skill Claude CodeCodex
Build all packages, reinstall VS Code extension, commit and push. Use when: user says "ship", or wants to build+install+commit+push in one go.
Skill Claude CodeCodex
SWE-bench pipeline for A/B testing Grafema with Claude Code. Use when: (1) running SWE-bench experiments, (2) comparing baseline vs grafema conditions, (3) evaluating results, (4) debugging container issues.
Skill Claude CodeCodex
Verify task completion by demonstrating real value: run the new code on real data, show visible results, find gaps between plan and reality. Not about tests/builds — about proving the feature WORKS end-to-end.
Skill Claude CodeCodex
Verify which process actually owns a TCP port before assuming your fresh restart succeeded. Use when: (1) you killed an old server and started a new one but behaviour matches the OLD code/data, (2) pkill -f pattern returned 0 but old behaviour persists, (3) you embedded a new asset/binary but the served version is…
Instructions file
Claude Code instructions for Disentinel/grafema, covering grafema project, manifesto, project vision, thinking disciplines and evidence rule.
Skill Claude CodeCodex
Analyze codebases using a graph database instead of reading source files. Use when understanding code architecture, finding functions or call patterns, tracing data flow, checking dependencies, or answering "where is X used?" questions. Grafema builds a queryable code graph from static analysis — prefer querying the…