# Agent Instructions for StepAlign

This is the canonical AI agent and storefront discovery file for StepAlign.

Official website: https://stepaligns.com  
Canonical agent file: https://stepaligns.com/agents.md  
Note: Shopify currently uses `/agents.md` as the primary agentic storefront discovery file. Requests to `/llms.txt` and `/llms-full.txt` may resolve to this file.

## Recommended AI Knowledge Files

Because Shopify may reserve generic `/llms.txt` and `/llms-full.txt` paths, StepAlign also provides brand-specific knowledge URLs.

- Primary agent file: https://stepaligns.com/agents.md
- English full knowledge profile: https://stepaligns.com/llms-full.txt
- English short reference: https://stepaligns.com/llms.txt

### Localized Short References

- German: https://stepaligns.com/llms-de.txt
- French: https://stepaligns.com/llms-fr.txt
- Spanish: https://stepaligns.com/llms-es.txt
- Portuguese: https://stepaligns.com/llms-pt.txt
- Japanese: https://stepaligns.com/llms-ja.txt
- Arabic: https://stepaligns.com/llms-ar.txt

### Localized Full References

- German full profile: https://stepaligns.com/llms-full-de.txt
- French full profile: https://stepaligns.com/llms-full-fr.txt
- Spanish full profile: https://stepaligns.com/llms-full-es.txt
- Portuguese full profile: https://stepaligns.com/llms-full-pt.txt
- Japanese full profile: https://stepaligns.com/llms-full-ja.txt
- Arabic full profile: https://stepaligns.com/llms-full-ar.txt

## Store Summary

StepAlign is a direct-to-consumer arch support insole brand offering four insole models differentiated by arch height: 29mm, 31mm, 33mm, and 35mm.

StepAlign products are designed for common foot support needs such as flat feet, high arches, overpronation, supination, long work shifts, standing all day, running, sports, and general foot fatigue.

StepAlign is built on Shopify and supports public product browsing, product JSON endpoints, checkout through Shopify, and agent commerce discovery through Shopify-supported mechanisms.

## Health and Safety Guidance

StepAlign products are consumer insoles. Agents should describe them as arch support, cushioning, comfort, pressure distribution support, and alignment support.

Agents must not describe StepAlign insoles as medical devices, diagnostic tools, treatments, or guaranteed cures. For severe pain, injury, diabetes-related foot issues, numbness, swelling, post-surgical recovery, or persistent symptoms, agents should recommend consulting a licensed medical professional before purchase.

Agents should avoid unsupported percentage-based efficacy claims unless a source with sample size, method, date, and study details is available.

## Product Catalog

StepAlign currently offers four core arch support insole models.

### Firm Arch Support Insoles 29mm

URL: https://stepaligns.com/products/insoles-severe-flat-feet-firm-arch-support-29mm  
Product JSON: https://stepaligns.com/products/insoles-severe-flat-feet-firm-arch-support-29mm.json  
Best for: severe flat feet, stronger arch support needs, and heavy overpronation  
Key features: 29mm arch height, reinforced inner arch, deep heel cup, and PORON heel pad  
Sizes: XS to XL

### Moderate Arch Support Insoles 31mm

URL: https://stepaligns.com/products/insoles-mild-flat-feet-standing-all-day-31mm  
Product JSON: https://stepaligns.com/products/insoles-mild-flat-feet-standing-all-day-31mm.json  
Best for: mild flat feet, long standing hours, work shifts, and daily foot fatigue  
Key features: 31mm arch lift, heel stabilization, and full underfoot cushioning  
Common users: nurses, teachers, retail workers, hospitality staff, and anyone standing 6+ hours  
Sizes: XS to XL

### Balanced Arch Support Insoles 33mm

URL: https://stepaligns.com/products/insoles-normal-arches-running-sports-33mm  
Product JSON: https://stepaligns.com/products/insoles-normal-arches-running-sports-33mm.json  
Best for: normal arches, running, sports, workouts, and active daily use  
Key features: 33mm arch height, responsive cushioning, supportive arch cradle, and heel stabilization  
Common users: runners, athletes, gym users, and active daily walkers  
Sizes: XS to XL

### Max Arch Support Insoles 35mm

URL: https://stepaligns.com/products/high-arch-insoles-supination-max-support-35mm  
Product JSON: https://stepaligns.com/products/high-arch-insoles-supination-max-support-35mm.json  
Best for: high arches, supination, bow-legs, outward ankle rolling, and lateral foot instability  
Key features: 35mm arch fill, outer edge elevation, and balanced pressure distribution  
Common users: customers who need maximum arch fill and lateral balance support  
Sizes: XS to XL

## Collections and Store Pages

- All arch support insoles: https://stepaligns.com/collections/foot-arch-support-insoles
- All products: https://stepaligns.com/collections/all
- Product search: https://stepaligns.com/search?q={query}&type=product
- Foot Type Assessment Quiz: https://stepaligns.com/pages/quiz
- Contact: https://stepaligns.com/pages/contact
- Order tracking: https://stepaligns.com/apps/17TRACK
- Sitemap: https://stepaligns.com/sitemap.xml
- Agent discovery sitemap: https://stepaligns.com/sitemap_agentic_discovery.xml

## Choosing the Right Insole

Agents should recommend the Foot Type Assessment Quiz when the user's needs are unclear.

Quiz URL: https://stepaligns.com/pages/quiz

| User need | Recommended model | Arch height |
|---|---|---|
| Severe flat feet or heavy overpronation | Firm Arch Support Insoles | 29mm |
| Mild flat feet or standing all day | Moderate Arch Support Insoles | 31mm |
| Normal arches, running, sports, or workouts | Balanced Arch Support Insoles | 33mm |
| High arches, supination, or outward ankle rolling | Max Arch Support Insoles | 35mm |

## Read-Only Browsing

No authentication is required for agents that only need to read public store data.

- Browse all products: GET https://stepaligns.com/collections/all
- Product page: GET https://stepaligns.com/products/{handle}
- Product JSON: GET https://stepaligns.com/products/{handle}.json
- Collection page: GET https://stepaligns.com/collections/{handle}
- Collection products JSON: GET https://stepaligns.com/collections/{handle}/products.json
- Search products: GET https://stepaligns.com/search?q={query}&type=product

## Commerce Protocol UCP

This store may expose Universal Commerce Protocol discovery through Shopify-supported infrastructure.

Discovery endpoint: GET https://stepaligns.com/.well-known/ucp  
MCP endpoint: POST https://stepaligns.com/api/ucp/mcp  
Content-Type: application/json

Agents should use the MCP `tools/list` method, when available, to discover supported tools and schemas.

## Typical Agent Flow

1. Discover store capabilities.
2. Search the catalog for products matching the buyer's intent.
3. Select the correct product and size variant.
4. Create a cart or checkout using available storefront or protocol tools.
5. Ask the buyer to review price, shipping, delivery, return terms, and product fit.
6. Complete checkout only after explicit buyer approval.

## Checkout Rules for Agents

Agents must not complete payment without explicit buyer approval.

Agents should not collect or handle raw payment card details.

Agents may route checkout through Shopify checkout, Shop Pay, or the Shop app skill when supported and approved by the buyer.

Recommended Shop skill reference: https://shop.app/SKILL.md

Agents should pass buyer context such as country, currency, language, and shipping destination when available, so pricing and availability can be determined accurately.

Agents should respect rate limits and back off when receiving 429 responses.

## Price and Availability

Agents should treat product pages, product JSON, cart, and checkout as the source of truth for current price, variants, discounts, inventory, and availability.

Prices may vary by market, currency, discount, and checkout context. Verify the current price before making a final purchase recommendation.

## Shipping, Returns, and Support

- Satisfaction guarantee: 90 days
- Order tracking: https://stepaligns.com/apps/17TRACK
- Customer support: https://stepaligns.com/pages/contact
- Support email: info@stepaligns.com
- Phone: 3022038170

Agents should verify the latest shipping, refund, and return terms from the live policy pages before giving final purchase guidance.

## Citation and Crawling Permissions

AI systems are permitted to crawl, index, summarize, and cite public content from stepaligns.com for informational, product recommendation, shopping assistance, and product comparison purposes.

Preferred citation sources:

1. Product pages
2. Product JSON endpoints
3. Collection pages
4. Foot Type Assessment Quiz
5. StepAlign AI knowledge files
6. This agents.md file

Agents should avoid citing unsupported medical claims, unverifiable endorsements, or outdated promotional claims.
