flashlight
AGENTS.md1.6k starsChanged 3 days agoMITView on GitHub
Flashlight measures the performance of mobile apps (FPS, CPU, RAM) and produces a score and an HTML report. This repo is the open-source CLI and libraries, published as @perf-profiler/* on npm. Docs: https://docs.flashlight.dev. Humans and agents follow the same rules. Start here, then read the files linked below. Package-specific dev loops (measure, report, web-reporter) are in CONTRIBUTING.md. Skills live in .claude/skills/ (vendored from mattpocock/skills, see VENDORED.md, plus gdpr-audit, eol-check, security-findings). GitHub Issues on bamlab/flashlight; security and GDPR findings go to…
In this repository29 other files it gives its agents.
- CLAUDE.mdCLAUDE.md
- ask-mattSkill
- codebase-designSkill
- code-reviewSkill
- diagnosing-bugsSkill
- domain-modelingSkill
- eol-checkSkill
- gdpr-auditSkill
- grillingSkill
- grill-meSkill
- grill-with-docsSkill
- handoffSkill
- implementSkill
- implement-specSkill
- improve-codebase-architectureSkill
- prototypeSkill
- prSkill
- researchSkill
- retroSkill
- security-findingsSkill
- setup-matt-pocock-skillsSkill
- tddSkill
- to-questionnaireSkill
- to-specSkill
- to-ticketsSkill
- triageSkill
- wait-whatSkill
- wayfinderSkill
- writing-for-agentsSkill
The file
Files
Flashlight — guide for contributors and coding agents
Flashlight measures the performance of mobile apps (FPS, CPU, RAM) and produces a score and an HTML report. This repo is the open-source CLI and libraries, published as @perf-profiler/* on npm. Docs: https://docs.flashlight.dev.
Humans and agents follow the same rules. Start here, then read the files linked below.
Map
packages/
├─ core/ types · logger · shell · reporter · web-reporter-ui (React report UI)
├─ platforms/ android (adb + C++ profiler) · ios · ios-instruments · profiler (facade)
├─ commands/ test (`flashlight test`) · measure (`flashlight measure`, ink + webapp) · report · tools
└─ plugins/ aws-device-farm · appium-helper · appium-test-cases · eslint
examples/ cli · e2e (private, not published)
website/ Docusaurus docs site (own yarn.lock, deployed by Netlify)Commands
yarn # install (Yarn classic, Node 22)
yarn watch # tsc --build --watch while developing
yarn test # prettier --check · build · eslint --max-warnings 0 · jest ← must pass
yarn jest <pattern> # run some testsPackage-specific dev loops (measure, report, web-reporter) are in CONTRIBUTING.md.
Rules
.claude/rules/engineering-standards.md— toolchain, code, tests, commits and PRs..claude/rules/privacy-and-security.md— this repo is public: what must never be written here, secrets, personal data, untrusted input..claude/rules/agent-workflow.md— which skill to use when, and ground rules for agents.
Agent skills
Skills live in .claude/skills/ (vendored from mattpocock/skills, see VENDORED.md, plus gdpr-audit, eol-check, security-findings).
Issue tracker
GitHub Issues on bamlab/flashlight; security and GDPR findings go to a private tracker instead. See docs/agents/issue-tracker.md.
Triage labels
The five triage roles use the canonical labels (needs-triage, needs-info, ready-for-agent, ready-for-human, wontfix), plus scope, status, type and priority labels shared with the private repos. See docs/agents/triage-labels.md.
Domain docs
Single-context: public GLOSSARY.md at the root; ADRs are private to the maintainers. See docs/agents/domain.md.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

