AI Agent

Claude Code

ProjectArchitecture.ktShow moreShow less

@file:OptIn(ExperimentalKatachiApi::class)

import me.tbsten.katachi.ExperimentalKatachiApi
import me.tbsten.katachi.dsl.architecture

val projectArchitecture = architecture {
    "AiAgent".group {
        claudeCode()
    }
}

// roles/ClaudeCode.kt
@file:OptIn(ExperimentalKatachiApi::class)

import me.tbsten.katachi.ExperimentalKatachiApi
import me.tbsten.katachi.dsl.DeclarationContainerScope

fun DeclarationContainerScope.claudeCode() =
    "ClaudeCode".group {
        "Rules" {
            summary = "Instruction files that Claude Code reads"

            layout {
                "**/CLAUDE.md".file()
                "**/AGENTS.md".file()
                ".claude/rules/**/*.md".file()
            }
        }

        "Skills" {
            summary = "Claude Code skills"

            layout {
                ".claude/skills/**/*".file()
            }
        }

        "Agents" {
            summary = "Claude Code subagent definitions"

            layout {
                ".claude/agents/**/*.md".file()
            }
        }

        "Commands" {
            summary = "Claude Code slash commands"

            layout {
                ".claude/commands/**/*.md".file()
            }
        }

        "OutputStyles" {
            summary = "Claude Code output styles"

            layout {
                ".claude/output-styles/*.md".file()
            }
        }

        "Hooks" {
            summary = "Claude Code hook scripts"

            layout {
                ".claude/hooks/**/*".file()
            }
        }

        "Settings" {
            summary = "Claude Code settings file"

            layout {
                ".claude/settings.json".file().optional()
            }
        }

        "Mcp" {
            summary = "Claude Code MCP server configuration"

            layout {
                ".mcp.json".file().optional()
            }
        }
    }

Show moreShow less

Cursor

ProjectArchitecture.ktShow moreShow less

@file:OptIn(ExperimentalKatachiApi::class)

import me.tbsten.katachi.ExperimentalKatachiApi
import me.tbsten.katachi.dsl.architecture

val projectArchitecture = architecture {
    "AiAgent".group {
        cursor()
    }
}

// roles/Cursor.kt
@file:OptIn(ExperimentalKatachiApi::class)

import me.tbsten.katachi.ExperimentalKatachiApi
import me.tbsten.katachi.dsl.DeclarationContainerScope

fun DeclarationContainerScope.cursor() =
    "Cursor".group {
        "Rules" {
            summary = "Instruction files that Cursor reads"

            layout {
                ".cursor/rules/**/*.mdc".file()
                "**/AGENTS.md".file()
            }
        }

        "Skills" {
            summary = "Cursor skills"

            layout {
                ".cursor/skills/**/*".file()
            }
        }

        "Agents" {
            summary = "Cursor subagent definitions"

            layout {
                ".cursor/agents/*.md".file()
            }
        }

        "Commands" {
            summary = "Cursor commands"

            layout {
                ".cursor/commands/*.md".file()
            }
        }

        "HookConfig" {
            summary = "Cursor hook configuration file"

            layout {
                ".cursor/hooks.json".file().optional()
            }
        }

        "HookScripts" {
            summary = "Cursor hook scripts"

            layout {
                ".cursor/hooks/*.sh".file()
            }
        }

        "Mcp" {
            summary = "Cursor MCP server configuration"

            layout {
                ".cursor/mcp.json".file().optional()
            }
        }

        "Environment" {
            summary = "Cursor environment configuration"

            layout {
                ".cursor/environment.json".file().optional()
            }
        }

        "Ignore" {
            summary = "Files that Cursor should ignore"

            layout {
                ".cursorignore".file().optional()
                ".cursorindexingignore".file().optional()
            }
        }
    }

Show moreShow less

Windsurf (Devin Desktop)

ProjectArchitecture.ktShow moreShow less

@file:OptIn(ExperimentalKatachiApi::class)

import me.tbsten.katachi.ExperimentalKatachiApi
import me.tbsten.katachi.dsl.architecture

val projectArchitecture = architecture {
    "AiAgent".group {
        windsurf()
    }
}

// roles/Windsurf.kt
@file:OptIn(ExperimentalKatachiApi::class)

import me.tbsten.katachi.ExperimentalKatachiApi
import me.tbsten.katachi.dsl.DeclarationContainerScope

fun DeclarationContainerScope.windsurf() =
    "Windsurf".group {
        "Rules" {
            summary = "Instruction files that Windsurf reads"

            layout {
                ".devin/rules/*.md".file()
                "**/AGENTS.md".file()
            }
        }

        "Skills" {
            summary = "Windsurf skills"

            layout {
                ".devin/skills/**/*".file()
            }
        }

        "Workflows" {
            summary = "Windsurf workflows"

            layout {
                ".devin/workflows/*.md".file()
            }
        }

        "Hooks" {
            summary = "Windsurf hook configuration file"

            layout {
                ".devin/hooks.json".file().optional()
            }
        }

        "Ignore" {
            summary = "Files that Windsurf should ignore"

            layout {
                ".devinignore".file().optional()
            }
        }

        "LegacyRules" {
            summary = "Legacy Windsurf instruction files"

            layout {
                ".windsurfrules".file().optional()
                ".windsurf/rules/*.md".file()
            }
        }

        "LegacySkills" {
            summary = "Legacy Windsurf skills"

            layout {
                ".windsurf/skills/**/*".file()
            }
        }

        "LegacyWorkflows" {
            summary = "Legacy Windsurf workflows"

            layout {
                ".windsurf/workflows/*.md".file()
            }
        }
    }

Show moreShow less

GitHub Copilot

ProjectArchitecture.ktShow moreShow less

@file:OptIn(ExperimentalKatachiApi::class)

import me.tbsten.katachi.ExperimentalKatachiApi
import me.tbsten.katachi.dsl.architecture

val projectArchitecture = architecture {
    "AiAgent".group {
        githubCopilot()
    }
}

// roles/GitHubCopilot.kt
@file:OptIn(ExperimentalKatachiApi::class)

import me.tbsten.katachi.ExperimentalKatachiApi
import me.tbsten.katachi.dsl.DeclarationContainerScope

fun DeclarationContainerScope.githubCopilot() =
    "GitHubCopilot".group {
        "Instructions" {
            summary = "Instruction files that GitHub Copilot reads"

            layout {
                ".github/copilot-instructions.md".file().optional()
                ".github/instructions/**/*.instructions.md".file()
                "**/AGENTS.md".file()
            }
        }

        "Skills" {
            summary = "GitHub Copilot skills"

            layout {
                ".github/skills/**/*".file()
            }
        }

        "Agents" {
            summary = "GitHub Copilot custom agent definitions"

            layout {
                ".github/agents/*.agent.md".file()
            }
        }

        "Prompts" {
            summary = "GitHub Copilot prompt files"

            layout {
                ".github/prompts/*.prompt.md".file()
            }
        }

        "Hooks" {
            summary = "GitHub Copilot hook configuration files"

            layout {
                ".github/hooks/*.json".file()
            }
        }

        "Mcp" {
            summary = "GitHub Copilot MCP server configuration"

            layout {
                ".vscode/mcp.json".file().optional()
            }
        }

        "SetupSteps" {
            summary = "Workflow that prepares the GitHub Copilot environment"

            layout {
                // Also overlaps with Workflow (.github/workflows/*.yml) in the GitHub recipe
                ".github/workflows/copilot-setup-steps.yml".file().optional()
            }
        }
    }

Show moreShow less

Cline

ProjectArchitecture.ktShow moreShow less

@file:OptIn(ExperimentalKatachiApi::class)

import me.tbsten.katachi.ExperimentalKatachiApi
import me.tbsten.katachi.dsl.architecture

val projectArchitecture = architecture {
    "AiAgent".group {
        cline()
    }
}

// roles/Cline.kt
@file:OptIn(ExperimentalKatachiApi::class)

import me.tbsten.katachi.ExperimentalKatachiApi
import me.tbsten.katachi.dsl.DeclarationContainerScope

fun DeclarationContainerScope.cline() =
    "Cline".group {
        "Rules" {
            summary = "Instruction files that Cline reads"

            layout {
                ".clinerules/**/*.md".file()
                ".cline/rules/**/*.md".file()
                "AGENTS.md".file().optional()
            }
        }

        "Skills" {
            summary = "Cline skills"

            layout {
                ".cline/skills/**/*".file()
            }
        }

        "Agents" {
            summary = "Cline agent definitions"

            layout {
                ".cline/agents.yaml".file().optional()
            }
        }

        "Hooks" {
            summary = "Cline hook scripts"

            layout {
                ".cline/hooks/**/*".file()
            }
        }

        "Ignore" {
            summary = "Files that Cline should ignore"

            layout {
                ".clineignore".file().optional()
            }
        }
    }

Show moreShow less

JetBrains Junie

ProjectArchitecture.ktShow moreShow less

@file:OptIn(ExperimentalKatachiApi::class)

import me.tbsten.katachi.ExperimentalKatachiApi
import me.tbsten.katachi.dsl.architecture

val projectArchitecture = architecture {
    "AiAgent".group {
        junie()
    }
}

// roles/Junie.kt
@file:OptIn(ExperimentalKatachiApi::class)

import me.tbsten.katachi.ExperimentalKatachiApi
import me.tbsten.katachi.dsl.DeclarationContainerScope

fun DeclarationContainerScope.junie() =
    "Junie".group {
        "Rules" {
            summary = "Instruction files that Junie reads"

            layout {
                ".junie/rules/*.md".file()
                ".junie/playbook.md".file().optional()
                ".junie/guidelines.md".file().optional()
                "**/AGENTS.md".file()
            }
        }

        "Skills" {
            summary = "Junie skills"

            layout {
                ".junie/skills/**/*".file()
            }
        }

        "Commands" {
            summary = "Junie commands"

            layout {
                ".junie/commands/*.md".file()
            }
        }

        "Mcp" {
            summary = "Junie MCP server configuration"

            layout {
                ".junie/mcp/mcp.json".file().optional()
            }
        }

        "Config" {
            summary = "Junie configuration file"

            layout {
                ".junie/config.json".file().optional()
            }
        }

        "Ignore" {
            summary = "Files that Junie should ignore"

            layout {
                ".aiignore".file().optional()
            }
        }
    }

Show moreShow less

OpenAI Codex

ProjectArchitecture.ktShow moreShow less

@file:OptIn(ExperimentalKatachiApi::class)

import me.tbsten.katachi.ExperimentalKatachiApi
import me.tbsten.katachi.dsl.architecture

val projectArchitecture = architecture {
    "AiAgent".group {
        codex()
    }
}

// roles/Codex.kt
@file:OptIn(ExperimentalKatachiApi::class)

import me.tbsten.katachi.ExperimentalKatachiApi
import me.tbsten.katachi.dsl.DeclarationContainerScope

fun DeclarationContainerScope.codex() =
    "Codex".group {
        "Rules" {
            summary = "Instruction files that Codex reads"

            layout {
                "**/AGENTS.md".file()
            }
        }

        "Skills" {
            summary = "Codex skills"

            layout {
                ".agents/skills/**/*".file()
            }
        }

        "Config" {
            summary = "Codex configuration file"

            layout {
                ".codex/config.toml".file().optional()
            }
        }

        "Hooks" {
            summary = "Codex hook configuration file"

            layout {
                ".codex/hooks.json".file().optional()
            }
        }

        "SandboxRules" {
            summary = "Rules that decide which commands Codex may run"

            layout {
                ".codex/rules/*.rules".file()
            }
        }
    }

Show moreShow less

Google Antigravity

ProjectArchitecture.ktShow moreShow less

@file:OptIn(ExperimentalKatachiApi::class)

import me.tbsten.katachi.ExperimentalKatachiApi
import me.tbsten.katachi.dsl.architecture

val projectArchitecture = architecture {
    "AiAgent".group {
        antigravity()
    }
}

// roles/Antigravity.kt
@file:OptIn(ExperimentalKatachiApi::class)

import me.tbsten.katachi.ExperimentalKatachiApi
import me.tbsten.katachi.dsl.DeclarationContainerScope

fun DeclarationContainerScope.antigravity() =
    "Antigravity".group {
        "Rules" {
            summary = "Instruction files that Antigravity reads"

            layout {
                "**/AGENTS.md".file()
                "GEMINI.md".file().optional()
                ".agents/rules/**/*.md".file()
            }
        }

        "Skills" {
            summary = "Antigravity skills"

            layout {
                ".agents/skills/**/*".file()
            }
        }

        "Agents" {
            summary = "Antigravity agent definitions"

            layout {
                ".agents/agents/**/*.md".file()
            }
        }

        "Mcp" {
            summary = "Antigravity MCP server configuration"

            layout {
                ".agents/mcp_config.json".file().optional()
            }
        }

        "Hooks" {
            summary = "Antigravity hook configuration file"

            layout {
                ".agents/hooks.json".file().optional()
            }
        }
    }

Show moreShow less

Aider

ProjectArchitecture.ktShow moreShow less

@file:OptIn(ExperimentalKatachiApi::class)

import me.tbsten.katachi.ExperimentalKatachiApi
import me.tbsten.katachi.dsl.architecture

val projectArchitecture = architecture {
    "AiAgent".group {
        aider()
    }
}

// roles/Aider.kt
@file:OptIn(ExperimentalKatachiApi::class)

import me.tbsten.katachi.ExperimentalKatachiApi
import me.tbsten.katachi.dsl.DeclarationContainerScope

fun DeclarationContainerScope.aider() =
    "Aider".group {
        "Conventions" {
            summary = "Convention file that Aider reads"

            layout {
                "CONVENTIONS.md".file().optional()
            }
        }

        "Settings" {
            summary = "Aider configuration files"

            layout {
                ".aider.conf.yml".file().optional()
                ".aider.model.settings.yml".file().optional()
            }
        }

        "Ignore" {
            summary = "Files that Aider should ignore"

            layout {
                ".aiderignore".file().optional()
            }
        }
    }

Show moreShow less

Treat this snippet only as a starting point

The snippet on this page shows a common shape. In a real project, add to it and adjust it to fit your directory structure, naming, and the libraries you use.