Agent Scan
This page is the first stop for coding agents, documentation agents, and external AI tools that need to locate the right MiHCM Design System context quickly.
Start Here
| Need | Read |
|---|---|
| Fast routing map | /llms.txt |
| Machine-readable routes and source paths | /agent-map.json |
| Full Markdown bundle | /llms-full.txt |
| Agent and MCP setup | Agent tooling |
| External developer onboarding | External developers |
| Human component catalog | Components |
| Design token rules | Tokens |
| AI-generated UI safety | AI-UI |
| Security quick reference | docs/SECURITY.md |
Agent Scan Protocol
- Read
/llms.txtfirst. - Use
/agent-map.jsonwhen you need exact source paths, route URLs, and document tags. - Fetch narrow component pages before using
/llms-full.txt. - For components, read
/components/{slug}/usagefirst, then/examples,/api, and/accessibility. - Use the hosted MCP at
/mcpfor current component, token, schema, and changeset facts. - Validate generated UI descriptors before rendering them.
Where Things Live
| Area | Human route | Source |
|---|---|---|
| Docs app pages | /... | src/apps/docs/app/**/page.* |
| Component docs | /components/{slug}/{tab} | src/apps/docs/content/components/{slug}/ |
| Component wiki | Download links under /downloads/agent/docs/components/ | docs/components/*.md |
| Design tokens | /tokens/* | src/apps/docs/app/tokens/*, docs/tokens/*, src/packages/tokens/ |
| Agent skills | /downloads/skills/* | skills/*/SKILL.md |
| MCP configs | /downloads/mcp/* | src/apps/docs/public/downloads/mcp/* |
| Runbooks | /downloads/agent/docs/runbooks/* | docs/runbooks/*.md |
| ADRs | /downloads/agent/docs/decisions/* | docs/decisions/*.md |
Rules For Generated Interfaces
- Use MiHCM components and icons.
- Use standard Tailwind utilities and MiHCM semantic token classes.
- Do not hardcode raw hex, rgb, hsl, arbitrary bracket utilities, inline visual styles, local CSS layers, or local primitive forks.
- Use
mihcm_validate_descriptorbefore rendering model-generated component descriptors. - Use
mihcm_review_frontend_snippetbefore finalizing consumer JSX.
Stable Agent Files
| File | Purpose |
|---|---|
/agents.md | Short entry file for agents that look for agents.md. |
/llms.txt | Curated documentation map. |
/.well-known/llms.txt | Compatibility mirror. |
/llms-full.txt | Full docs bundle. |
/.well-known/llms-full.txt | Compatibility mirror. |
/agent-map.json | Machine-readable index with source paths, URLs, tags, and purposes. |
/downloads/skills/mihcm-skill-pack.json | Public skill and MCP config manifest. |