← ClaudeAtlas

kintsugi-backend-apilisted

Focused backend-api anti-patterns and verified code templates compiled by Kintsugi Harness.
tunguyen1993/kintsugi-harness · ★ 0 · AI & Automation · score 73
Install: claude install-skill tunguyen1993/kintsugi-harness
# kintsugi-backend-api (`@KML/1` Machine-Native AST-IR) ```bash kintsugi scan --staged --fail-on HIGH ``` ## `@KML/1` Symbolic Guardrail Specifications (`NEG_AST => POS_AST`) ### `KL-API-002` · `Multi-Tenant Cache & Secondary Query Isolation: Always prefix cache keys with tenant_id` - `@WIRE`: `@KML/1|id=KL-API-002|sev=C|cat=backend-api|lang=py,ts|op=MULTI-TENANT_CACHE_SECONDARY_QUERY_I|guard=RX#43051a0a|neg=«cached = redis_client.get(f"record:{record_id}") # UNSCOPED_MULTI_TENANT_CACHE_KEY»|pos=«cached = redis_client.get(f"tenant:{tenant_id}:record:{record_id}")»|fp=f0b833c7f6a70e70` - `@TRAP`: `[Cognitive Trap] Filtered the primary SQL query by `tenant_id`, but keyed the Redis cache lookup by bare `record_id` (`cache.get(f'record:{record_id}')`), leaking cached records across tenants.` - `@LAW`: `[Mental Model] Every secondary retrieval path, cache key, and export job must bind the authenticated `tenant_id` (`f'tenant:{tenant_id}:record:{record_id}'`); row-level security on the DB does not protect an unscoped cache hit.` `@NEG_AST` (`❌ FORBIDDEN`): ```python cached = redis_client.get(f"record:{record_id}") # UNSCOPED_MULTI_TENANT_CACHE_KEY ``` `@POS_AST` (`✅ REQUIRED`): ```python cached = redis_client.get(f"tenant:{tenant_id}:record:{record_id}") ``` ### `KL-API-001` · `Never call synchronous time.sleep() inside an async def coroutine` - `@WIRE`: `@KML/1|id=KL-API-001|sev=H|cat=backend-api|lang=py|op=fn:backoff!enforce_invariant|guard=RX#c488f400|neg=«async def back