AI-assisted development

The Poq Android SDK ships with embedded context for AI coding agents (Claude Code and compatible tools). When set up correctly, your agent gains focused, module-specific knowledge of the SDK while you work on your app — how a module is wired, what a vendor integration needs, and which classes to extend — without you pasting in documentation.

What the SDK ships

These files live inside the SDK repository, so they travel with it. You do not need to add this documentation site as agent context — the per-module files below are the curated, AI-focused version of it.

• Root CLAUDE.md — SDK architecture, conventions, and rules.
• Per-module CLAUDE.md — a self-contained, action-ready brief for each module: what it is, its entry points, setup, and extension points. These load on demand — only when the agent reads files in that module — so they cost nothing until they're relevant.
• .claude/skills/ — task scaffolding (e.g. generating tests, new components).
• .claude/docs/ — deeper reference docs the module files link to.

Setup

Add the SDK directory with --add-dir and opt in to loading its memory files via the environment variable:

CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1 claude --add-dir ../Poq.Android.Platform

Or persist the flag in ~/.claude/settings.json:

{ "env": { "CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD": "1" } }

Important: adding the SDK via the additionalDirectories setting (instead of the --add-dir flag) grants file access but never loads CLAUDE.md files, even with the environment variable set. Use --add-dir for the AI docs to load. Without the environment variable the files are still readable on disk — but the agent will only use them if you explicitly tell it to "check the SDK", and they won't load as authoritative context.

Skills from the SDK load whenever it's added with --add-dir (no environment variable required).