AGENTS.md

Core Rules

• Kotlin Multiplatform: Always consider all platforms: JS, WASM, Desktop JVM, Android, iOS
• Build & Test: Always run build and tests before completing tasks
• Preserve Intent: If existing solution doesn't work, preserve its intent
• Module Clean: Use ./gradlew :module:clean instead of global clean
• Test Scripts: Put temporary scripts under docs/test-scripts
• Logs: Check ~/.autodev/logs/autodev-app.log for debugging

KMP Best Practices

• Use expect/actual for platform-specific code, for example Platform
• @JsExport: Use concrete classes (not interfaces), Promise (not Flow)
• WASM: Avoid emoji and UTF-8 in code
• i18n: Run ./gradlew :mpp-ui:generateI18n4kFiles

Renderer System

When modifying CodingAgentRenderer, update ALL implementations:

• Kotlin: DefaultCodingAgentRenderer, ComposeRenderer, JewelRenderer, ServerSideRenderer, JsRendererAdapter
• TypeScript: BaseRenderer.ts, CliRenderer.ts, ServerRenderer.ts, TuiRenderer.ts
• VSCode: mpp-vscode/src/bridge/mpp-core.ts, mpp-vscode/src/providers/chat-view.ts
• JVM CLI: CodingCliRenderer, ConsoleRenderer

Design System

• CLI/TUI: Use semanticInk/semanticChalk from mpp-ui/src/jsMain/typescript/design-system/
• Compose: Use AutoDevColors or MaterialTheme.colorScheme
• NO hardcoded colors - always use design tokens
• Docs: docs/design-system-color.md, docs/design-system-compose.md

Quick Commands

CLI Test:

./gradlew :mpp-core:assembleJsPackage
cd mpp-ui && npm run build && npm run start

IDEA Plugin:

cd mpp-idea && ../gradlew compileKotlin
cd mpp-idea && ../gradlew test --tests "cc.unitmesh.devins.idea.renderer.JewelRendererTest"
cd mpp-idea && ../gradlew buildPlugin

Release:

# 1. Update version in gradle.properties
# 2. CLI: cd mpp-ui && npm publish:remote
# 3. Desktop: git tag compose-vX.X.X && git push origin compose-vX.X.X
# 4. gh release create compose-vX.X.X --draft