# joeldenke/android-ai architecture

> Architecture diagram of the GitHub repository joeldenke/android-ai, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/joeldenke/android-ai
- Repository: https://github.com/joeldenke/android-ai

## Overview

Android AI is a repository of Android-development guidance and automation distributed as a Claude Code plugin and adapters for other AI tools. A user invokes a skill or specialist to get Android design, implementation, review, or operational help; skills are the documented source of truth, with Cursor and Windsurf adapters generated from them. Claude Code also exposes specialist agents and lifecycle hooks. The README documents these product-level relationships; no implementation excerpts were provided, so internal calls and hook execution details are not inferred.

Main entry points: [`skills`](https://github.com/joeldenke/android-ai/tree/main/skills) (Android Skills), [`agents`](https://github.com/joeldenke/android-ai/tree/main/agents) (Specialist Agents), [`hooks`](https://github.com/joeldenke/android-ai/tree/main/hooks) (Lifecycle Hooks), [`agents/android-lead.md`](https://github.com/joeldenke/android-ai/blob/main/agents/android-lead.md) (Android Lead)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_guidance["Android Skills"]
  node_skills["Android Skills"]
  node_new_feature["New Feature<br/>[new-feature.md]"]
  node_compose["Compose Components"]
  node_architecture["Architecture Audit"]
  node_code_review["Code Review<br/>[code-review.md]"]
  node_testing["Test Writing<br/>[write-tests.md]"]
  node_performance["Performance Analysis"]
  node_device["Device Tools<br/>[adb.md]"]
  node_figma["Figma Workflows<br/>[figma-sync.md]"]
  node_security["Security Review<br/>[security.md]"]
  node_release["Release Guidance<br/>[release.md]"]
end

subgraph group_specialists["Claude Agents"]
  node_agents["Specialist Agents"]
  node_android_lead["Android Lead<br/>[android-lead.md]"]
  node_android_architect["Android Architect"]
  node_kotlin_expert["Kotlin Expert<br/>[kotlin-expert.md]"]
  node_compose_expert["Compose Expert<br/>[compose-expert.md]"]
  node_coroutine_expert["Coroutine Expert"]
  node_testing_engineer["Testing Engineer"]
end

subgraph group_lifecycle["Claude Hooks"]
  node_hooks["Lifecycle Hooks"]
  node_session_hook["Session Start<br/>[session-start.md]"]
  node_lint_hook["Post-tool Lint<br/>[post-tool-lint.md]"]
  node_push_hook["Pre-push Check<br/>[pre-push-check.md]"]
end

subgraph group_adapters["Tool Adapters"]
  node_cursor_rules["Cursor Rules<br/>[rules]"]
  node_windsurf_rules["Windsurf Rules<br/>[.windsurfrules]"]
  node_claude_plugin["Claude Plugin<br/>[plugin.json]"]
end

node_developer(("Developer"))
node_claude_code(("Claude Code"))
node_cursor(("Cursor"))
node_windsurf(("Windsurf"))

node_developer -->|"invokes skill"| node_skills
node_skills -->|"includes"| node_new_feature
node_skills -->|"includes"| node_compose
node_skills -->|"includes"| node_architecture
node_skills -->|"includes"| node_code_review
node_skills -->|"includes"| node_testing
node_skills -->|"includes"| node_performance
node_skills -->|"includes"| node_device
node_skills -->|"includes"| node_figma
node_skills -->|"includes"| node_security
node_skills -->|"includes"| node_release
node_developer -->|"delegates task"| node_agents
node_agents -->|"includes"| node_android_lead
node_agents -->|"includes"| node_android_architect
node_agents -->|"includes"| node_kotlin_expert
node_agents -->|"includes"| node_compose_expert
node_agents -->|"includes"| node_coroutine_expert
node_agents -->|"includes"| node_testing_engineer
node_android_lead -->|"delegates to team"| node_agents
node_claude_code -->|"loads plugin"| node_claude_plugin
node_claude_code -->|"runs automatically"| node_hooks
node_hooks -->|"includes"| node_session_hook
node_hooks -->|"includes"| node_lint_hook
node_hooks -->|"includes"| node_push_hook
node_skills -->|"generates adapters"| node_cursor_rules
node_skills -->|"generates adapters"| node_windsurf_rules
node_cursor -->|"loads rules"| node_cursor_rules
node_windsurf -->|"loads rules"| node_windsurf_rules

click node_skills "https://github.com/joeldenke/android-ai/tree/main/skills"
click node_new_feature "https://github.com/joeldenke/android-ai/blob/main/skills/new-feature.md"
click node_compose "https://github.com/joeldenke/android-ai/blob/main/skills/compose-component.md"
click node_architecture "https://github.com/joeldenke/android-ai/blob/main/skills/architecture-audit.md"
click node_code_review "https://github.com/joeldenke/android-ai/blob/main/skills/code-review.md"
click node_testing "https://github.com/joeldenke/android-ai/blob/main/skills/write-tests.md"
click node_performance "https://github.com/joeldenke/android-ai/blob/main/skills/performance-analyzer.md"
click node_device "https://github.com/joeldenke/android-ai/blob/main/skills/adb.md"
click node_figma "https://github.com/joeldenke/android-ai/blob/main/skills/figma-sync.md"
click node_security "https://github.com/joeldenke/android-ai/blob/main/skills/security.md"
click node_release "https://github.com/joeldenke/android-ai/blob/main/skills/release.md"
click node_agents "https://github.com/joeldenke/android-ai/tree/main/agents"
click node_android_lead "https://github.com/joeldenke/android-ai/blob/main/agents/android-lead.md"
click node_android_architect "https://github.com/joeldenke/android-ai/blob/main/agents/android-architect.md"
click node_kotlin_expert "https://github.com/joeldenke/android-ai/blob/main/agents/kotlin-expert.md"
click node_compose_expert "https://github.com/joeldenke/android-ai/blob/main/agents/compose-expert.md"
click node_coroutine_expert "https://github.com/joeldenke/android-ai/blob/main/agents/coroutine-flow-expert.md"
click node_testing_engineer "https://github.com/joeldenke/android-ai/blob/main/agents/testing-engineer.md"
click node_hooks "https://github.com/joeldenke/android-ai/tree/main/hooks"
click node_session_hook "https://github.com/joeldenke/android-ai/blob/main/hooks/session-start.md"
click node_lint_hook "https://github.com/joeldenke/android-ai/blob/main/hooks/post-tool-lint.md"
click node_push_hook "https://github.com/joeldenke/android-ai/blob/main/hooks/pre-push-check.md"
click node_cursor_rules "https://github.com/joeldenke/android-ai/tree/main/.cursor/rules"
click node_windsurf_rules "https://github.com/joeldenke/android-ai/blob/main/.windsurfrules"
click node_claude_plugin "https://github.com/joeldenke/android-ai/blob/main/.claude-plugin/plugin.json"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_skills,node_new_feature,node_compose,node_architecture,node_code_review,node_testing,node_performance,node_device,node_figma,node_security,node_release toneBlue
class node_agents,node_android_lead,node_android_architect,node_kotlin_expert,node_compose_expert,node_coroutine_expert,node_testing_engineer toneAmber
class node_hooks,node_session_hook,node_lint_hook,node_push_hook toneMint
class node_cursor_rules,node_windsurf_rules,node_claude_plugin toneRose
class node_developer,node_claude_code,node_cursor,node_windsurf toneIndigo
```

## Components

### Android Skills

- [Android Skills](https://github.com/joeldenke/android-ai/tree/main/skills): `skills`
- [New Feature](https://github.com/joeldenke/android-ai/blob/main/skills/new-feature.md): `skills/new-feature.md`
- [Compose Components](https://github.com/joeldenke/android-ai/blob/main/skills/compose-component.md): `skills/compose-component.md`
- [Architecture Audit](https://github.com/joeldenke/android-ai/blob/main/skills/architecture-audit.md): `skills/architecture-audit.md`
- [Code Review](https://github.com/joeldenke/android-ai/blob/main/skills/code-review.md): `skills/code-review.md`
- [Test Writing](https://github.com/joeldenke/android-ai/blob/main/skills/write-tests.md): `skills/write-tests.md`
- [Performance Analysis](https://github.com/joeldenke/android-ai/blob/main/skills/performance-analyzer.md): `skills/performance-analyzer.md`
- [Device Tools](https://github.com/joeldenke/android-ai/blob/main/skills/adb.md): `skills/adb.md`
- [Figma Workflows](https://github.com/joeldenke/android-ai/blob/main/skills/figma-sync.md): `skills/figma-sync.md`
- [Security Review](https://github.com/joeldenke/android-ai/blob/main/skills/security.md): `skills/security.md`
- [Release Guidance](https://github.com/joeldenke/android-ai/blob/main/skills/release.md): `skills/release.md`

### Claude Agents

- [Specialist Agents](https://github.com/joeldenke/android-ai/tree/main/agents): `agents`
- [Android Lead](https://github.com/joeldenke/android-ai/blob/main/agents/android-lead.md): `agents/android-lead.md`
- [Android Architect](https://github.com/joeldenke/android-ai/blob/main/agents/android-architect.md): `agents/android-architect.md`
- [Kotlin Expert](https://github.com/joeldenke/android-ai/blob/main/agents/kotlin-expert.md): `agents/kotlin-expert.md`
- [Compose Expert](https://github.com/joeldenke/android-ai/blob/main/agents/compose-expert.md): `agents/compose-expert.md`
- [Coroutine Expert](https://github.com/joeldenke/android-ai/blob/main/agents/coroutine-flow-expert.md): `agents/coroutine-flow-expert.md`
- [Testing Engineer](https://github.com/joeldenke/android-ai/blob/main/agents/testing-engineer.md): `agents/testing-engineer.md`

### Claude Hooks

- [Lifecycle Hooks](https://github.com/joeldenke/android-ai/tree/main/hooks): `hooks`
- [Session Start](https://github.com/joeldenke/android-ai/blob/main/hooks/session-start.md): `hooks/session-start.md`
- [Post-tool Lint](https://github.com/joeldenke/android-ai/blob/main/hooks/post-tool-lint.md): `hooks/post-tool-lint.md`
- [Pre-push Check](https://github.com/joeldenke/android-ai/blob/main/hooks/pre-push-check.md): `hooks/pre-push-check.md`

### Tool Adapters

- [Cursor Rules](https://github.com/joeldenke/android-ai/tree/main/.cursor/rules): `.cursor/rules`
- [Windsurf Rules](https://github.com/joeldenke/android-ai/blob/main/.windsurfrules): `.windsurfrules`
- [Claude Plugin](https://github.com/joeldenke/android-ai/blob/main/.claude-plugin/plugin.json): `.claude-plugin/plugin.json`

### Other components

- **Developer**
- **Claude Code**
- **Cursor**
- **Windsurf**

## Connections

- Developer → Android Skills: invokes skill (evidence: `README.md`)
- Android Skills → New Feature: includes (evidence: `README.md`)
- Android Skills → Compose Components: includes (evidence: `README.md`)
- Android Skills → Architecture Audit: includes (evidence: `README.md`)
- Android Skills → Code Review: includes (evidence: `README.md`)
- Android Skills → Test Writing: includes (evidence: `README.md`)
- Android Skills → Performance Analysis: includes (evidence: `README.md`)
- Android Skills → Device Tools: includes (evidence: `README.md`)
- Android Skills → Figma Workflows: includes (evidence: `README.md`)
- Android Skills → Security Review: includes (evidence: `README.md`)
- Android Skills → Release Guidance: includes (evidence: `README.md`)
- Developer → Specialist Agents: delegates task (evidence: `README.md`)
- Specialist Agents → Android Lead: includes (evidence: `README.md`)
- Specialist Agents → Android Architect: includes (evidence: `README.md`)
- Specialist Agents → Kotlin Expert: includes (evidence: `README.md`)
- Specialist Agents → Compose Expert: includes (evidence: `README.md`)
- Specialist Agents → Coroutine Expert: includes (evidence: `README.md`)
- Specialist Agents → Testing Engineer: includes (evidence: `README.md`)
- Android Lead → Specialist Agents: delegates to team (evidence: `README.md`)
- Claude Code → Claude Plugin: loads plugin (evidence: `README.md`)
- Claude Code → Lifecycle Hooks: runs automatically (evidence: `README.md`)
- Lifecycle Hooks → Session Start: includes (evidence: `README.md`)
- Lifecycle Hooks → Post-tool Lint: includes (evidence: `README.md`)
- Lifecycle Hooks → Pre-push Check: includes (evidence: `README.md`)
- Android Skills → Cursor Rules: generates adapters (evidence: `README.md`)
- Android Skills → Windsurf Rules: generates adapters (evidence: `README.md`)
- Cursor → Cursor Rules: loads rules (evidence: `README.md`)
- Windsurf → Windsurf Rules: loads rules (evidence: `README.md`)
