Guides / Claude Code

Connect Claude Code to your Design Contract.

Claude Code needs one explicit Project instruction to reach the same shared direction as other coding agents. The result preserves one root Design Contract and one AgentKogei managed reference.

One explicit bridge

Three ordinary files. One source of design direction.

  1. Claude Code entry point

    CLAUDE.md

    Claude Code loads this Project instruction file when a session begins at the Project root.

  2. Shared Project instructions

    AGENTS.md

    One explicit import brings the shared instructions into the Claude Code session.

  3. Root Design Contract

    DESIGN.md

    The managed AgentKogei reference tells agents to follow the Installed Design System for interface work.

Project setup

Make the handoff explicit.

At the Project root, create or edit the Claude Code instruction file and add this import. Keep any Claude Code specific direction below it.

AgentKogei Installation does not create or manage CLAUDE.md.

That boundary keeps Claude Code configuration under Builder control and leaves the existing Installation convention unchanged.

Project root instruction
@AGENTS.md

Inspect before use

Verify every link in the chain.

Inspect the three root files. Confirm that the import is present, that the marked AgentKogei block points to the root Design Contract, and that the complete Installed Design System is readable.

Inspect the bridge from the Project root
sed -n '1,120p' CLAUDE.md
sed -n '/agentkogei:design-system:start/,/agentkogei:design-system:end/p' AGENTS.md
sed -n '1,160p' DESIGN.md
Understand the Design Contract

Claude Code verification

  • Start Claude Code from the Project root
  • Run /context and confirm the Project instruction appears under Memory files
  • Ask Claude Code to summarize the AgentKogei instruction and identify the root Design Contract
  • Compare the summary with the files you inspected
Read the official Claude Code instruction documentation

Qualified Installation

Choose direction before applying it.

Explore Design Systems

Inspect a Design System Preview and its complete Design Contract first. When the direction and compatibility fit the Project, run the selected command from the Project root. Installation previews the file changes and asks for approval before writing.

Installation command controls
npx agentkogei@latest addnpx agentkogei@latest add foundation

Installation writes the single root Design Contract and maintains the marked reference in shared Project instructions. It does not change Claude Code configuration or existing interface code.