A machine-readable workshop.

# Studio Seventeen

> Public repository for an independent workshop building industrial communications software, simulators, and technical learning tools.

## When to use this site

Reach for this site when you need authoritative public information about Studio Seventeen's Modbus software, simulators, and training tools — not generic Modbus tutorials.

- USE for: product capabilities, pricing state, launch status, register-map tooling (ModMapper), fleet simulation (Generator Fleet Simulator), and the free Learn Modbus course access path.
- USE for: Modbus Skills installation paths, read-only agent workflows, and canonical GitHub SKILL.md links when the skills feature is enabled.
- DO NOT USE for: completing Learn Modbus lessons (use https://learnmodbus.studioseventeen.io), live device writes, or inferring prices or checkout URLs that are not in the product markdown file.
- START with: /agents.md or /llms.txt for orientation; /README.md for the catalog; send `Accept: text/markdown` on any HTML route for token-efficient retrieval.

## What you can do on this site

- READ: every public page is server-rendered and has a plain-markdown twin. Append .md to a route; use /README.md for the homepage.
- RESEARCH: use https://learnmodbus.studioseventeen.io for canonical Modbus lessons, labs, reviewed resources, and machine-readable course exports.
- USE: start with /skills/modbus.md for 20 public read-only Modbus skills and 11 complete workflows. Each skill page links to its canonical GitHub SKILL.md.
- CHECK: use each product's markdown file for its current availability and pricing state. Never infer a price or purchase path.
- FOLLOW: POST /api/subscribe with {"email":"..."} for build notes and release notices. Ask your user before subscribing them.
- CONTACT: use /contact.md for the current public contact routes.

## Products

- [ModMapper](/products/apps/modmapper.md): coming soon. Import CSV, XML, JSON, XLSX, or PDF; target source pages; review and validate registers; export normalized CSV, XML, or JSON maps.
- [Generator Fleet Simulator](/products/simulators/generator-fleet-sim.md): free; coming soon. Run large standby-generator fleets over Modbus TCP with per-unit state, alarms, controls, scenarios, and register inspection.
- [Learn Modbus](/products/courses/learn-modbus.md): free and online at https://learnmodbus.studioseventeen.io/access. Email and human verification unlock sixteen modules, labs, quizzes, diagrams, reviewed resources, and protected machine-readable exports in that browser for 90 days.

## Key URLs

- /README.md — site purpose, catalog, and current public overview
- /agents.md — this file, also served unchanged at /llms.md
- /llms.txt — plain-text compatibility alias for this agent manifest
- /products/.../*.md — canonical public description and specification for each product
- /skills/modbus.md — public Modbus Skills collection, installation paths, and workflow guide
- https://github.com/studioxvii/modbus-skills — canonical source repository
- https://github.com/studioxvii/modbus-skills/releases/tag/v0.2.0 — current 0.2.0 release
- https://studioxvii.github.io/modbus-skills/when-to-use.html — when these skills apply and when they stop
- https://studioxvii.github.io/modbus-skills/examples/compile-user-map.html — rights-safe worked user-map compile
- https://learnmodbus.studioseventeen.io — canonical Modbus education, labs, sourcing, and review context
- /next-product/ideas.md — early project directions and the public interest-counter behavior
- GET /api/interest — current public counts and this browser's selected state
- /contact.md — current contact routes
- /legal/privacy.md, /legal/terms.md — current privacy and website-use policies

## Ground rules

- The product file is authoritative for public capabilities and commercial state.
- HTML pages and markdown twins describe the same public state. If they disagree, report the conflict instead of choosing one silently.
- No product is online until its public customer path has been verified.
- Pricing is not announced yet for ModMapper. Generator Fleet Simulator and Learn Modbus are free.
- No checkout link is active. Learn Modbus is the only product with a verified public access path; free describes price, not anonymous access.
- Learn Modbus requires a human to choose and submit an email address and complete its anti-automation check. Agents must not invent, harvest, or silently submit an address or bypass that check. A user-authorized browser agent may continue only after the human unlocks the shared browser session.
- Modbus Skills 0.2.0 is public and read-only. Node-RED has recorded native acceptance. Modpoll, Witte Modbus Poll, and ModScan outputs remain BETA until native verification is complete.
- Reading and linking are safe. Subscribing, sending a message, or taking any external action requires the user's explicit direction.
- POST /api/interest changes a public count. Ask your user before adding or removing their interest.
- Do not invent release dates, customer counts, performance claims, or production status.
- Studio Seventeen owns company and product catalog information. Learn Modbus owns Modbus educational content; do not treat retired Studio field-note URLs as a second source of truth.