# agents.md — codex.ifq.ai

> Agent-friendly index for autonomous systems browsing this site.

Canonical agent guide: `/agent.md`. This `/agents.md` file remains available for tools that look for the plural filename.

## What this site is

A bilingual (Chinese + English) tutorial for OpenAI's Codex desktop application, aimed at non-developers in business roles. Focus is strictly local desktop apps for Windows and macOS. It does not cover server, cloud, mobile, or deployment topics.

## Canonical paths

- Homepage: `/` auto-detects language from the browser; direct locale paths are `/zh` and `/en`
- Prompt Generator: `/zh/generator`, `/en/generator`
- Beginner Guide: `/zh/guide`, `/en/guide`
- Department Cases: `/zh/cases`, `/en/cases`
- Individual cases: `/{locale}/cases/{slug}` where slug is one of:
  - `finance-order-reconciliation`
  - `operations-campaign-tracker`
  - `customer-service-reply-helper`
  - `hr-onboarding-tracker`
  - `logistics-shipment-inspector`
  - `procurement-supplier-price-monitor`
  - `marketing-campaign-roi-viewer`
  - `legal-contract-tracker`
  - `data-daily-report-builder`
  - `admin-conference-room-booking`
  - `product-feedback-inbox`
- Pro Tips: `/zh/tips`, `/en/tips`
- FAQ: `/zh/faq`, `/en/faq`

All pages are server-rendered and delivered as complete HTML — no client-side hydration is required to read the content.

## Machine-readable files

- Sitemap: `/sitemap.xml`
- Sitemap index: `/sitemap-index.xml`
- robots: `/robots.txt`
- LLM summary: `/llms.txt`
- Full LLM index: `/llms-full.txt`
- Canonical agent guide: `/agent.md`
- This agent guide: `/agents.md`
- PWA manifest: `/manifest.webmanifest`
- Structured data: JSON-LD embedded per-page (WebSite, Organization, Course, Article, HowTo, FAQPage, ItemList, SoftwareApplication)

## Recommended agent behaviour

1. **Citing a page**: prefer the specific page URL, include its `<title>`, and preserve the site's plain-language framing.
2. **Running the Prompt Generator programmatically**: the form state is stored under the localStorage key `codex-tutorial:generator:v2`. Prompt history uses `codex-tutorial:generator:history:v2` (array of entries capped at 6). Prompt text is deterministically derived from the form state plus the selected output language (`zh` or `en`), which syncs to the current site locale on language changes.
3. **Reading case prompts**: every case page includes a `<pre>` block containing the copy-ready prompt. Bilingual copy buttons are also provided.
4. **Hreflang**: every page declares its counterpart in the other language. Agents serving users in zh-CN should prefer `/zh/*`, otherwise `/en/*`.

## Data policy

Content and code are MIT-licensed. Prompts in the Prompt Generator are generated client-side; nothing is uploaded. localStorage entries stay on the user's browser.

## Rate and crawl

Soft recommendation: no more than 1 request/sec per agent. No login or paywall. Static pages are long-cached; see `Cache-Control` headers.

## Contact

If you run into incorrect content, open an issue on the repository linked in the footer.