Turn a bug or a feature idea into a GitHub issue detailed enough that an implementer can start work from it alone — investigate the real code first, cite file:line, bound the scope, then file it with gh once the user confirms. Use whenever the user reports…
Router and shared ground rules for ANY work in the Kanna repo — read this first to find the specialist skill for the task. Use whenever the work touches this codebase: adding a feature or a field, changing a type or contract shared between server and client,…
Instrument Kanna's code with spans, counters and gauges, and operate the collector that receives them. Read this BEFORE writing any instrumentation — Kanna has one permitted import path for it and a naming convention, so hand-rolled timing code gets rejected…
Read a Kanna chat's on-disk transcript and event logs to find out what actually happened in a session. Scope — this reads Kanna's OWN chat transcripts, identified by a chat/session id; an ordinary stack trace, exception, or application log from any other…
React + TypeScript coding style for Kanna's client (src/client/**). Apply when creating or editing any .tsx/.ts file under src/client, src/shared, or src/server that ships UI behavior. Covers component shape, props typing, state-aware label and tone helpers,…
How to verify a change in the Kanna repo — running tests, and clearing the lint, ast-grep, and design gates that block merges. Use whenever you are about to run tests or report work as done, when a test passes locally but fails on CI, when you hit an ESLint…
Publish a new Kanna version to npm — pick the version bump from what changed since the last tag, push, and create the GitHub release whose structured changelog triggers the publish workflow. Use whenever the user says "cut a release", "ship a new version",…
Review a pull request for malicious or unsafe content and summarize its changes, working entirely through the GitHub API so no untrusted code is ever fetched or run locally. Use whenever a PR URL or number appears with a request to review, check, audit, or…