Give every agent durable design direction.
An Installed Design System connects Project instructions to one root Design Contract. Agents can find the same complete direction now, offline, and throughout future work.
One durable path
From Project entry point to every interface decision.
- Project instructions
AGENTS.md
Tell agents where direction lives
AGENTS.md is the durable entry point for coding agents. AgentKogei adds a managed instruction that tells them to read the root Design Contract before interface work.
- Root Design Contract
DESIGN.md
Hold the complete visual direction
DESIGN.md contains one complete Design System Release: principles, tokens, components, states, motion, accessibility direction, examples, and a validation checklist.
- Future agent work
Every session
Apply the same decisions again
Every agent that follows the Project instructions reaches the same source of truth, so later screens and interactions begin from shared direction instead of reconstructing it.
Installed Design System
A Project artifact, not a service dependency.
Installation writes the selected Design System Release to the Project root and adds its reference to the managed section of AGENTS.md. The Installed Design System then belongs to the Project.
Because the full release is local, it works offline after Installation. Future agent work does not depend on AgentKogei being available, and the direction remains inspectable in ordinary files.
What Installation does
- Selects the current Design System Release from one Published Design System
- Shows the exact target and change before writing
- Writes the complete release to root DESIGN.md
- Adds a managed AGENTS.md reference without replacing other instructions
- Leaves existing interface code unchanged
Compatibility
Know the fit before Installation.
AgentKogei Design Systems give implementation direction for React 18 and 19, Next.js 15 and 16, Tailwind CSS v4, and shadcn/ui.
Installation is declarative. It adds direction for agents but does not install application dependencies, execute generated code, or migrate an existing interface.
Choose direction
Inspect first. Install when the fit is clear.
Open a Design System Preview to assess its direction, complete Design Contract, compatibility, and Design System Evaluation. Then use the command for the Design System you chose from the Project root.
The CLI retrieves the selected public release anonymously and asks for normal file mutation approval before Installation.