Borrowing it
Nothing to install: this file belongs to rajanm/retail-enterprise-agents. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.
curl -O https://raw.githubusercontent.com/rajanm/retail-enterprise-agents/master/GEMINI.mdgit clone --depth 1 https://github.com/rajanm/retail-enterprise-agentsWrote 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.
[](https://agentmods.dev/instructions/rajanm/retail-enterprise-agents/gemini-md)<a href="https://agentmods.dev/instructions/rajanm/retail-enterprise-agents/gemini-md"><img src="https://agentmods.dev/badge/instructions/rajanm/retail-enterprise-agents/gemini-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.
<a href="https://agentmods.dev/instructions/rajanm/retail-enterprise-agents/gemini-md"><img src="https://agentmods.dev/badge/instructions/rajanm/retail-enterprise-agents/gemini-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>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.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.10937 | $0.10937 |
| Opus 5 | $0.05469 | $0.05469 |
| Sonnet 5 | $0.02187 | $0.02187 |
| Haiku 4.5 | $0.01094 | $0.01094 |
Grade B, and why
retail-enterprise-agents GEMINI.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 10d 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.
Asks for rootmediumPrivilege escalation
A mod that escalates privileges can change anything on the machine, not only the project.
4. **FFmpeg & Google Chrome**: Required for `record_agent_demo.py` Playwright session capture and 1080p MP4 transcoding (`sudo apt-get install ffmpeg` or `brew install ffmpeg`). This is a copy
100% identical to retail-enterprise-agents AGENTS.md — 0 lines differ, which has more behind it and is treated as the original. This page carries a canonical link to it rather than competing with it.
How it starts
The opening of the file, as written. The whole thing — 485 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Retail Enterprise Agents
Google ADK agents for Gemini Enterprise, organized by retail domain (merchandising first, supply
chain added 2026-07-26). Agents are defined declaratively via ADK's YAML Agent Config and answer
business questions by querying BigQuery through the Conversational Analytics API
(ask_data_insights), supplemented by Google Search grounding for external market context.
Full architecture rationale lives in
docs/superpowers/specs/2026-07-25-retail-merchandising-adk-agents-design.md — read it before
making structural changes; this file is a quick-reference, not a replacement.
CLAUDE.md, GEMINI.md, and AGENTS.md must be kept 100% byte-identical at all times via cp CLAUDE.md GEMINI.md && cp CLAUDE.md AGENTS.md && cmp CLAUDE.md GEMINI.md && cmp CLAUDE.md AGENTS.md. Always update all three in sync whenever project state, conventions, or instructions change.
docs/ is local-only, gitignored (docs/**), not shared via git (decision made 2026-07-26,
final — reversed an earlier decision to track it). Its history contained GCP project/resource
identifiers throughout, and the call was to keep this content local rather than in shared git
history. This means docs/superpowers/ exists on this machine but will not be present on a
fresh clone or for anyone else — don't assume it exists elsewhere, and don't rely on git to
distribute it.
Current state
The scaffolding infrastructure (template, shared instruction fragments, generator script) is
built and is domain-agnostic — creating a new domain is just a new --domain value, no new
infra needed. One hundred agents are fully built, tested, deployed to Vertex AI Agent Engine (dev), and
registered with Gemini Enterprise:
- Merchandising Domain (14 of 14 agents complete) (
domains/merchandising/agents/):assortment_planning("Merchandising: Assortment Planning")pricing_promotions("Merchandising: Pricing & Promotions")sell_through_inventory_health("Merchandising: Sell-Through & Inventory Health")vendor_negotiation_rebates("Merchandising: Vendor Negotiation & Rebates")markdown_clearance_optimization("Merchandising: Markdown & Clearance Optimization")price_matching_competitor_intel("Merchandising: Price Matching & Competitor Intel")space_planning_micro_merch("Merchandising: Space Planning & Micro-Merchandising", added 2026-08-07)private_brand_development("Merchandising: Private Brand Development", added 2026-08-07)seasonal_transition_planning("Merchandising: Seasonal Transition Planning", added 2026-08-07)category_growth_strategy("Merchandising: Category Growth Strategy", added 2026-08-07)size_pack_optimization("Merchandising: Size & Case Pack Optimization", added 2026-08-07)item_lifecycle_rationalization("Merchandising: Item Lifecycle & SKU Rationalization", added 2026-08-07)trade_spend_effectiveness("Merchandising: Trade Spend & Allowance Effectiveness", added 2026-08-07)localized_curation_clustering("Merchandising: Localized Assortment Clustering", added 2026-08-07)
- Supply Chain & Logistics Domain (14 of 14 agents complete) (
domains/supply_chain/agents/):vendor_performance("Supply Chain: Vendor Performance", added 2026-07-26)inventory_planning("Supply Chain: Inventory Planning", added 2026-07-26)logistics_operations("Supply Chain: Logistics Operations", added 2026-07-27)warehouse_dc_operations("Supply Chain: Warehouse & DC Operations", added 2026-07-28)returns_reverse_logistics("Supply Chain: Returns & Reverse Logistics", added 2026-07-29)inbound_freight_optimization("Supply Chain: Inbound Freight Optimization", added 2026-08-07)last_mile_delivery_dispatch("Supply Chain: Last-Mile Delivery & Dispatch", added 2026-08-07)cold_chain_temperature_compliance("Supply Chain: Cold Chain Temperature Compliance", added 2026-08-07)multi_echelon_safety_stock("Supply Chain: Multi-Echelon Safety Stock", added 2026-08-07)supplier_risk_resilience("Supply Chain: Supplier Risk & Resilience", added 2026-08-07)cross_dock_flow_through("Supply Chain: Cross-Dock & Flow-Through Velocity", added 2026-08-07)customs_import_tariff_compliance("Supply Chain: Customs & Import Tariff Compliance", added 2026-08-07)dc_automation_robotics_kpis("Supply Chain: DC Automation & Robotics KPIs", added 2026-08-07)packaging_dunnage_optimization("Supply Chain: Packaging & Dunnage Optimization", added 2026-08-07)
- Store Operations Domain (11 of 11 agents complete) (
domains/store_operations/agents/):labor_productivity("Store Operations: Labor Productivity", added 2026-07-27)store_fulfillment_execution("Store Operations: Store Fulfillment & Execution", added 2026-07-28)loss_prevention_shrinkage("Store Operations: Loss Prevention & Shrinkage", added 2026-07-28)visual_merchandising_compliance("Store Operations: Planogram & Visual Merchandising Compliance", added 2026-08-07)energy_facilities_maintenance("Store Operations: Store Energy & Facilities Maintenance", added 2026-08-07)pos_checkout_queue_analytics("Store Operations: POS & Checkout Queue Analytics", added 2026-08-07)store_cash_management_tills("Store Operations: Store Cash Management & Till Balancing", added 2026-08-07)omnichannel_returns_in_store("Store Operations: In-Store Omnichannel Returns & BORIS", added 2026-08-07)store_safety_incident_management("Store Operations: Store Safety & Incident Management", added 2026-08-07)curbside_pickup_speed_accuracy("Store Operations: Curbside Pickup Speed & Accuracy", added 2026-08-07)store_manager_operational_audit("Store Operations: Store Manager Operational Audits", added 2026-08-07)
- E-Commerce & Digital Channels Domain (11 of 11 agents complete) (
domains/e_commerce/agents/):cart_checkout_analytics("E-Commerce: Cart & Checkout Analytics", added 2026-07-29)search_merchandising_personalization("E-Commerce: Product Discovery & Analytics", added 2026-07-29)payment_gateway_fraud_risk("E-Commerce: Payment Gateway & Fraud Risk", added 2026-08-08)marketplace_seller_performance("E-Commerce: 3P Marketplace Seller Performance", added 2026-08-08)mobile_app_conversion_retention("E-Commerce: Mobile App Conversion & Engagement", added 2026-08-08)digital_site_performance_vitals("E-Commerce: Digital Web Performance & Vitals", added 2026-08-08)product_detail_page_optimization("E-Commerce: PDP Optimization & Media Engagement", added 2026-08-08)subscription_recurring_orders("E-Commerce: Subscription & Recurring Orders", added 2026-08-08)digital_promotions_coupon_abuse("E-Commerce: Digital Promo & Coupon Abuse", added 2026-08-08)b2b_wholesale_portal_analytics("E-Commerce: B2B Wholesale Portal Analytics", added 2026-08-08)web_accessibility_seo_health("E-Commerce: SEO Health & Web Accessibility", added 2026-08-08)
- Finance, Real Estate & Accounting Domain (11 of 11 agents complete) (
domains/finance/agents/):gross_margin_profitability("Finance: Gross Margin & Profitability", added 2026-07-27)store_pnl_operating_costs("Finance: Store P&L & Operating Costs", added 2026-07-28)working_capital_cashflow("Finance: Working Capital & Cash Flow", added 2026-07-29)capex_store_remodel_roi("Finance: CapEx & Store Remodel ROI", added 2026-08-08)corporate_budget_variance_fpna("Finance: Corporate Budget Variance & FP&A", added 2026-08-08)foreign_exchange_landed_costs("Finance: FX Exposure & Landed Cost Hedging", added 2026-08-08)gift_card_breakage_liability("Finance: Gift Card Breakage & Liability", added 2026-08-08)inventory_valuation_provisions("Finance: Inventory Valuation & LCM Provisions", added 2026-08-08)sales_tax_nexus_compliance("Finance: Sales Tax Nexus & Jurisdictional Compliance", added 2026-08-08)store_real_estate_lease_mgmt("Finance: Store Real Estate & Lease Management", added 2026-08-08)vendor_recovery_audit_compliance("Finance: Vendor Recovery Audit & Compliance", added 2026-08-08)
- Marketing & Retail Media Domain (10 of 10 agents complete) (
domains/marketing/agents/):campaign_performance_roi("Marketing: Campaign Performance & ROI", added 2026-07-28)customer_lifecycle_loyalty("Marketing: Customer Lifecycle & Loyalty", added 2026-07-28)retail_media_network_monetization("Marketing: Retail Media Network & Sponsored Ad Yield", added 2026-08-08)customer_churn_winback_analytics("Marketing: Churn Prediction & Win-Back Triggers", added 2026-08-08)email_sms_crm_orchestration("Marketing: CRM, Email & SMS Campaign Orchestration", added 2026-08-08)influencer_creator_campaign_roi("Marketing: Influencer & Creator Campaign ROI", added 2026-08-08)customer_acquisition_cost_cac("Marketing: CAC Payback Velocity & Unit Economics", added 2026-08-08)omnichannel_customer_cdp_insights("Marketing: Omnichannel CDP & Customer Identity", added 2026-08-08)geotargeted_local_marketing("Marketing: Geotargeted & Local Store Marketing", added 2026-08-08)brand_health_social_sentiment("Marketing: Brand Health & Social Sentiment", added 2026-08-08)
- Customer Care & Experience Domain (10 of 10 agents complete) (
domains/customer_care/agents/, added 2026-08-07, demos recorded 2026-08-10):contact_center_agent_performance("Customer Care: Contact Center Performance & FCR")wismo_order_tracking_resolution("Customer Care: WISMO & Order Inquiries")voice_of_customer_sentiment_nlp("Customer Care: Voice of Customer & NLP Sentiment")product_warranty_claims_repair("Customer Care: Product Warranty & Claims")ai_chatbot_deflection_handoff("Customer Care: AI Bot Containment & Escalations")vip_clientele_concierge_support("Customer Care: VIP & High-CLV Concierge")returns_appeals_exception_desk("Customer Care: Return Exceptions & Appeals")omnichannel_social_support_desk("Customer Care: Social Support & Public Sentiment")store_associate_support_hotline("Customer Care: Store Helpdesk & POS Support")damaged_goods_claims_resolution("Customer Care: Damaged Goods Claims & Recovery")
- Sustainability, ESG & Compliance Domain (10 of 10 agents complete) (
domains/sustainability_compliance/agents/, added 2026-08-07, demos recorded 2026-08-10):carbon_footprint_scope_emissions("ESG: Carbon Footprint & Scope Emissions")food_waste_spoilage_reduction("ESG: Food Waste Reduction & Diversion")sustainable_packaging_circularity("ESG: Sustainable Packaging & Circularity")ethical_sourcing_labor_audits("ESG: Ethical Sourcing & Labor Audits")product_safety_recall_readiness("ESG: Product Safety & Recall Execution")energy_renewable_grid_transition("ESG: Renewable Energy & Grid Transition")water_conservation_facility_audit("ESG: Water Conservation & Facility Audits")chemical_restricted_substances_rsl("ESG: Restricted Substances (RSL) & Chemical Safety")dei_supplier_diversity_spend("ESG: Supplier Diversity & Equity Spend")extended_producer_responsibility_epr("ESG: Extended Producer Responsibility (EPR) & Resale")
- Human Resources & Workforce Management Domain (9 of 9 agents complete) (
domains/human_resources/agents/, added 2026-08-07, demos recorded 2026-08-15):store_associate_turnover_retention("HR: Store Associate Turnover & Retention")workforce_scheduling_fairness("HR: Scheduling Fairness & Predictive Hours")training_onboarding_compliance("HR: Training & Onboarding Compliance")workplace_safety_workers_comp("HR: Workplace Safety & Workers' Comp")store_manager_bench_succession("HR: Store Leadership Bench & Succession")seasonal_hiring_peak_readiness("HR: Seasonal Hiring & Peak Readiness")associate_engagement_pulse_enps("HR: Associate Pulse & eNPS Analytics")labor_union_compliance_cba("HR: Labor Union & CBA Compliance")frontline_wage_market_benchmarks("HR: Frontline Wage & Market Benchmarks")
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.
- 10d ago First seen · 485 lines · 10,937 tokens per session scan B f8e920aa0b61
retail-enterprise-agents GEMINI.md is an instructions file published in the GitHub repository rajanm/retail-enterprise-agents (8 stars, last pushed 25d ago), licensed Apache-2.0. It adds 10,937 tokens to every session, about $0.0547 per session on Opus 5. A static security scan graded it B with 1 finding (asks for root). It is 100% identical to retail-enterprise-agents AGENTS.md, differing in 0 lines, and is treated as a copy.
Other instructions, from other repositories
runtm copilot-instructions.md
Copilot instructions for runtm-ai/runtm, covering runtm tool instructions, critical rules, structure, adding endpoints and app/api/v1/myendpoint.py.
next.js AGENTS.md
AGENTS.md instructions for vercel/next.js, covering next.js development guide, codebase structure, monorepo overview, core package: packages/next and other important packages.
codex AGENTS.md
AGENTS.md instructions for openai/codex, covering rust/codex-rs, the codex-core crate, code review rules, crate api surface and model visible context.
vscode buildNext.instructions.md
Working notes and architecture documentation for the new esbuild-based build system in build/next. Use when making changes to the new build pipeline (transpile/bundle commands, NLS plugin, source-map handling, resource copying, or self-hosting watch tasks).
vscode oss-third-party-notices.instructions.md
Instructions for microsoft/vscode, covering vs code oss third-party-notices pipeline, architecture, pipeline flow in ci, applying the notice (cutover) and fallback chain (never fail the build).
langchain AGENTS.md
AGENTS.md instructions for langchain-ai/langchain, covering global development guidelines for the langchain monorepo, corridor security analysis, project architecture and context, monorepo structure and development tools & commands.