Kishu Stack
Give AI coding agents a consistent way to work without repeating the same guidance for every task.
- My contribution
- Combined existing engineering and design workflows with my own routing, preferences, and plugin packaging for Codex, Cursor, and Claude Code.
- Key decision
- Build from pinned upstream sources, keeping personal model preferences outside the generated bundle so updates preserve them.
- Evidence
- A reusable plugin and three working demos: a fictional MMO site, a trading dashboard, and a creative studio booking flow.
Open full-size preview A shared way of working for my AI coding agents
Tools Used: Python, Markdown, JavaScript
What it does
Kishu is a plugin I put together to give my coding agents a consistent way to work. It brings task routing, design guidance and the way I want progress explained into one mode, with packaging for Codex, Cursor and Claude Code.
The idea is to spend less time managing the agent. I want to describe the result, have it work out which guidance is useful, and get something back that I can actually inspect.
A small change should stay small. A tricky bug might need more investigation, and a new interface needs attention to how it looks and feels. Kishu’s instructions are set up to make that distinction, including bringing in other agents when there’s a useful reason to.
How it works
Most of the working mode is Markdown. The entrypoint loads a router, which picks the relevant playbook and references for the request. It doesn’t need to read every guide just to change a line of copy.
Kishu brings together three open-source projects:
- pstack, by Lauren Tan, provides the engineering workflows and routing foundations.
- Impeccable, by Paul Bakaus, provides the design guidance behind Kishu’s design taste engine.
- i-have-adhd, by Ayoub G., provides guidance adapted into clearer progress updates and answers that put the result first.
My part is the combination, the working preferences and the packaging around them. The original credits and licences stay in the bundle.
A Python script builds the plugin from pinned upstream versions and Kishu’s own source and overrides. It also handles installation, updates and exporting a standalone skill for other compatible tools. Keeping the generated bundle separate means I can update the source and rebuild it without manually maintaining several copies.
Keeping the useful parts
Model preferences live outside the generated plugin, so updating Kishu doesn’t wipe them. I can choose different models for implementation and review, or let delegated work use the current model. Those choices apply to delegated roles; they don’t change the model selected in the main chat.
The other part I care about is checking the result. Kishu asks for relevant tests when behaviour changes, and a look at the rendered page for visual work. It should also say when something couldn’t be checked.
These are instructions for an agent, so the actual tests and the tools’ permissions still matter. The useful bit is making those expectations part of the normal workflow instead of repeating them in every prompt.
Built with Kishu
The project includes its own website and three interactive examples. They’re different enough to show what the same workflow can produce without making every site look the same.
Veldrift is a fictional MMO website, with generated fantasy landscapes and an explorer for switching between destinations.
Meridian is a trading dashboard with charts, simulated moving prices and a demo order flow. It gives the workflow a denser interface to deal with, where the numbers and controls need to be easy to follow.
Stillroom is a creative studio site with generated workshop imagery, session selection and a local booking flow.
All three are working demos for fictional products. The market data is simulated, and no trades, payments or reservations are sent.
The site also has a build story with more detail on the process. You can find the plugin, installation instructions and the demo source on GitHub.
