commcare-android: Instructions file for Codex

AGENTS.md

commcare-android AGENTS.md is an instructions file for Codex, OpenCode from dimagi/commcare-android. It costs 1,657 tokens per session, scanned B, original, Apache-2.0.

A repository instruction file for developing CommCare Android and its shared Java library. It records build commands, project structure, and concise writing rules for agents and developers.

In plain words
What is it for?
Use it when changing the Android app or shared library, especially to build with the Gradle wrapper and place documentation in the correct area.
Why use it?
It keeps changes compatible with the project's build process and prevents unnecessary or misleading comments and documentation.

Instructions file for CodexOpenCode

Written for Codex and OpenCode: the file is AGENTS.md. Also seen: reads .claude/ paths; mentions subagents; mentions Claude Code.

This is dimagi/commcare-android's own configuration. It tells Codex and OpenCode how to work on commcare-android itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything commcare-android configures →

Reuse

Borrowing it

Nothing to install: this file belongs to dimagi/commcare-android. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/dimagi/commcare-android/master/AGENTS.md
Clone the repo
git clone --depth 1 https://github.com/dimagi/commcare-android

Made for: Codex, OpenCode.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for commcare-android AGENTS.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/dimagi/commcare-android/agents-md/github.svg)](https://agentmods.dev/instructions/dimagi/commcare-android/agents-md)
Your own site
<a href="https://agentmods.dev/instructions/dimagi/commcare-android/agents-md"><img src="https://agentmods.dev/badge/instructions/dimagi/commcare-android/agents-md/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for commcare-android AGENTS.md

Your own site · 80×15
<a href="https://agentmods.dev/instructions/dimagi/commcare-android/agents-md"><img src="https://agentmods.dev/badge/instructions/dimagi/commcare-android/agents-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 1,657 This file is loaded in full into every session.
When invoked 1,657 The same file — it is already loaded in full.
Security scan B 1 finding. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.01657 $0.01657
Opus 5.5 $0.00663 $0.00663
Sonnet 5.5 $0.00331 $0.00331
Haiku 4.5 $0.00166 $0.00166

Measured 5d ago against content hash dbec42615be9, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade B, and why

commcare-android AGENTS.md scanned grade B with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 5d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Enumerates other installed skillsmediumAgent snooping

Other skills' SKILL.md files reveal prompts, capabilities and secrets that should be invisible to peers.

**List the Confluence docs the change affects.** Those docs get updated when the app release containing the change goes out, so the PR only records which pages need it: user-facing changes must list them in the PR's **Do
AGENTS.md · 107 lines

How it starts

The opening of the file, as written. The whole thing — 107 lines — stays where its author put it; the contents beside it link to each section on GitHub.

AI Agent Development Guidelines for CommCare Android

Build

  • Always use the Gradle wrapper (./gradlew) from the commcare-android directory for building commcare-core

Project Overview

  • CommCare Android is an open-source Android application for data collection and service delivery in low-resource settings
  • CommCare Core is a shared Java library that provides core functionalities for CommCare's Android and Web Client

Concision (applies to all writing)

Commits, PR descriptions, code comments, and documentation default to concise and high-level, and never restate what is already clear from reading the code.

  • Commit and PR bodies: convey the why and the shape of the change, not a walkthrough of the diff.
  • Code comments: reserve for non-obvious why; never narrate what the code plainly does.
  • Documentation: prefer one high-level sentence over a paragraph; touch only the lines a change affects.

Project Documentation

Tech documentation for this repo is organized by Gradle submodule and, within the main app module, by product area:

  • /docs/commcare/ — CommCare-specific subsystems (e.g., translations)
  • /docs/connect/ — Connect-specific subsystems
  • /docs/personalid/ — PersonalID-specific subsystems (e.g., OAuth/SSO, photo management)
  • /docs/ (root) — cross-cutting subsystems that span multiple products (e.g., push notifications)
  • commcare-support-library/docs/ — docs for the standalone commcare-support-library Maven artifact (e.g., third-party identity provider integration)

Before making any code change, search /docs and any module-level docs/ folders for documentation relevant to the area you're modifying. Update the corresponding doc when behavior, APIs, or data flow change.

List the Confluence docs the change affects. Those docs get updated when the app release containing the change goes out, so the PR only records which pages need it: user-facing changes must list them in the PR's Documentation section, or say "None". To find them, search Confluence for the features the branch changes and compare the results against the documentation links on the Jira ticket. In Claude Code, open the PR first with "Pending" under the Documentation header, then run the docs-affected-by-branch skill (.claude/skills/) on the branch in a subagent. It searches both the CommCare and Connect Confluence spaces. Pass the subagent the PR link and the Jira ticket key, and tell it to replace "Pending" with its findings when it is done. A subagent can't ask the user, so if you don't know the ticket, ask the user before opening the PR; pass "none" if there isn't one. Without Confluence access, ask the user which pages are affected. Never drop the section as empty.

Read the full file on GitHub · 107 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 5d ago First seen · 107 lines · 1,657 tokens per session scan B dbec42615be9

Subscribe to this mod's changes

commcare-android AGENTS.md is an instructions file published in the GitHub repository dimagi/commcare-android (48 stars, last pushed yesterday), licensed Apache-2.0. It adds 1,657 tokens to every session, about $0.0066 per session on Opus 5.5. A static security scan graded it B with 1 finding (enumerates other installed skills). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-11-15.

Related

commcare-android AGENTS.md compared with instructions from other repositories

commcare-android AGENTS.md next to 6 instructions from other repositories
ModTypeStarsLast pushLicenceScanTokensWorks with
commcare-android AGENTS.mddimagi/commcare-androidInstructions file48yesterdayApache-2.0B1,657Codex, OpenCode
vscode buildNext.instructions.mdmicrosoft/vscodeInstructions file196ktodayMITA9,887GitHub Copilot
next.js AGENTS.mdvercel/next.jsInstructions file144ktodayMITA8,130Codex, OpenCode
vscode oss-third-party-notices.instructions.mdmicrosoft/vscodeInstructions file196ktodayMITA5,685GitHub Copilot
langchain AGENTS.mdlangchain-ai/langchainInstructions file150ktodayMITA4,680Codex, OpenCode
vscode copilot-instructions.mdmicrosoft/vscodeInstructions file196ktodayMITA3,153GitHub Copilot
deepseek-harness AGENTS.mddeepseek-ai/deepseek-harnessInstructions file285k2d agoMITA4,342Codex, OpenCode