name	puber-android-workflow
description	Puber Android TV feature/refactor workflow. Use for feature planning, Compose TV implementation, Koin/Voyager architecture, Gradle diagnostics, MCP source ingestion, smoke tests, and release tasks.

Use this skill for Puber Android work. Keep startup context compact: read only the reference files required by the active command, phase, or plan step.

State

Feature artifacts: .todo/<feature>/meta.json, design.md, layouts.md, spec.md, plan.md.
Kent task/node state is the lifecycle authority. meta.json stores identity and source/artifact metadata only; plan.md checkboxes track implementation-step progress.
Feature target is explicit: command arguments, Kent workflow task context, or a .todo/<feature> path/name.
There is no implicit global feature pointer.
MCP raw artifacts: .todo/<feature-or-task>/mcp/
Generic MCP raw fallback: .todo/_mcp-raw/
MCP call log: .todo/_mcp-log/mcporter-calls.jsonl

Public Commands

Kent commands live under .kent/commands/ and are invoked as /prompt:<name>.

Project Basics

Single Android project with modules :app and :baselineprofile; feature/runtime code belongs in :app.
Package root: com.kino.puber.
Product flavors: dev and prod.
Main compile check: ./gradlew :app:compileDevDebugKotlin in the main checkout.
In project-local and Kent-managed task worktrees, use ./tools/agentw :app:compileDevDebugKotlin.
Versions live in gradle/libs.versions.toml; do not hardcode dependency versions.
Static analysis: Detekt config under config/detekt/.

Architecture Pointers

DI: Koin DSL, global modules in PuberApp.kt, screen-scoped modules in buildModule(scopeId, parentScope).
Navigation: Voyager screens implementing PuberScreen; app navigation through AppRouter.
ViewModels: extend PuberVM<ViewState> or PagingVM<T, VS>.
UI: Jetpack Compose for Android TV, TV Material3 components, pure content composables with state and onAction: (UIAction) -> Unit.
API: Ktor/OkHttp in KinoPubApiClient; API models are used directly in domain/UI mapping.
Strings: user-visible strings go in res/values/strings.xml.

Use AGENTS.md as the broader project source of truth.

Recipe Loading

Load recipes lazily from:

.kent/skills/puber-android-workflow/references/recipes/

Load rules lazily from:

.kent/skills/puber-android-workflow/references/rules/

Use:

rules/workflow.md for Kent-specific workflow, worktree, and Gradle behavior.
rules/feature-target-resolution.md whenever a feature command needs to find or create a .todo/<feature> workspace.
rules/mcp.md for MCP bridge usage.
rules/serena.md for semantic Kotlin navigation when available.
rules/web-access-policy.md for web search/fetch boundaries.
rules/natural-language-routing.md for intent detection from normal user messages.

MCP Bridge

Kent may not expose MCP as first-class native tools. Use project-local wrappers:

.kent/adapters/mcp/mcp-list.sh <server> --schema
.kent/adapters/mcp/mcp-call.sh <server.tool> [arguments]

Source-ingestion commands should pass --raw-dir <dir> when collecting external source data. Runtime Smoke is the exception: do not persist unfiltered logs or unexpected authenticated UI output, and run the declared mobile evidence audit before reporting. Mutating calls require --allow-mutate and explicit user approval.

Subagents

Use configured Kent roles:

kent run --agent project-researcher --workspace "$PWD" "<prompt>"
kent run --agent build-doctor --workspace "$PWD" "<prompt>"
kent run --agent compose-reviewer --workspace "$PWD" "<prompt>"
kent run --agent domain-model-reviewer --workspace "$PWD" "<prompt>"

Use subagents for broad read-only search, noisy diagnostics, and review. The active implementation or fix session remains the single writer. Do not run parallel implementation writers.

Safety

Do not create or update global feature pointer files such as .todo/.current.
Do not commit or push unless explicitly requested.
Keep local paths, tokens, MCP configs, raw MCP outputs, and call logs out of git.
Mark plan steps complete only after verification succeeds.

kent run --agent project-researcher --workspace "$PWD" "<prompt>" kent run --agent build-doctor --workspace "$PWD" "<prompt>" kent run --agent compose-reviewer --workspace "$PWD" "<prompt>" kent run --agent domain-model-reviewer --workspace "$PWD" "<prompt>"