Machine path
Agent discovery · Repository handoff
From a general AI query to a working implementation.
Any capable agent can discover the system here. An authorized checkout then gives Codex, Claude Code, Grok Build, or another coding agent the same product map, protected-geometry rules, tests, and mutation boundary.
- Discover
/llms.txt- Implement
- Authorized source checkout
- Agent interface
- Repository + tests
Authority boundary
A public guide can explain the system. It cannot authorize a change.
Implementation needs an owner-authorized source checkout. Deployment, remote migration, content publishing, billing, MDM actions, and App Store delivery remain separate approvals. No MCP server is required.
01 · Discover
Give search agents a small, direct index.
/llms.txt points agents to a clean Markdown implementation guide and the public operating docs. The HTML page stays useful to people and searchable by ordinary web engines.
Compare signage costs links to BrightSign, Yodeck, ScreenCloud, and OptiSigns comparisons. Keep their checked dates, named plans, free tiers, hardware offers, and cost exclusions attached when quoting prices.
Search engines and AI agents may crawl public pages under robots.txt. Discover canonical pages in the sitemap. Crawling permission does not authorize access to private workspace content or account changes.
Human path
Keep control with the operator.
- Choose the intended workspace.
- Open the authorized checkout.
- Start the preferred coding agent.
- Approve remote actions separately.
02 · Start a session
One prompt, one operating contract.
Run the agent from the repository root. Codex and Grok read AGENTS.md; Claude Code reads CLAUDE.md, which imports the same contract.
Read the repository instructions first. Summarize the product surfaces,
the protected-geometry rule, the mutation boundary, and the relevant tests.
Inspect git status and preserve unrelated work. Implement only the requested
change, verify it locally in proportion to risk, and do not deploy, migrate,
upload, publish, bill, revoke, or install anything unless I explicitly
authorize that exact remote action. Report local, deployed, and physical-device
evidence as separate claims.No repository yet? The public agent can explain the product and prepare a scoped prompt, but it cannot produce a real implementation without authorized source access.
Keep the guide current: Repository changes invalidate a recorded agent-document review. The local $maintain-signcloudnine-agent-docs skill reviews the diff, updates affected guidance, and records a note before pnpm run agent-docs:check and release gates can pass.
03 · Repository map
Route work to the current source of truth.
boardedit/Public site + managerPreserve authentication, noindex, keyboard, and mobile behavior.cloudflare-worker/API + control planeKeep workspace scope and use forward-only migrations.QuickBoard/tvOS appPreserve internal identifiers and last-known-good behavior.FullBoards/newconfig.jsonConfig fixtureTreat frame values and stable IDs as customer data.04 · Operational model
Follow a site all the way to the media it plays.
Boards & Content uses Site → Configuration → Board → Slide → Zone → Asset. Site is assignment context for screens and selected board states; it is not another object inside the portable configuration JSON.
Content placement
Start with the board, then its media.
A new site is a Setup state whose primary action creates its first board; prepare that board and message before pairing an Apple TV. Rows then expose duration, placement, file size, update context, and complete slide visibility timelines. Contextual Add follows the selected object, and a new R2 upload remains unassigned until an operator adds it to a zone and publishes or stages the configuration.
Safe removal
Delete from the draft, with a way back.
Delete selected item appears below Stage changes and Edit settings for boards, slides, zones, and assigned assets. It previews the impact, confirms the removal, and offers Undo in the same dialog. Removing an assigned asset keeps its private upload available. Screens keep the active version until the valid changed draft is staged and activated.
Zone playback
Preview and order assets where they play.
The selected zone's Content tab shows thumbnail cards with filename, type, position, duration, preview, and explicit actions. Drag cards to reorder playback or use the earlier and later buttons. From Library offers Upload file even when empty; the new unique-key R2 object stays unassigned until Add to zone and Save.
Focused settings
Edit the board without repeating the tree.
Edit settings opens the requested board and slide with horizontal Frames & sizes, Schedule, and Templates tabs followed by the top slide selector. Frames keeps the fixed canvas and contextual inspector together; its Zone dropdown switches existing zones and Add zone creates an undoable draft zone. At phone widths where the canvas is unavailable, the manager keeps the overlay closed and asks for a tablet or computer.
Direct layout
Canvas and inspector work together.
Pinch or scroll zooms the fixed-size manager canvas; Space-drag or middle-drag pans. Frames & sizes adds eight resize handles, rotation, edge/center and 90-degree helpers, exact values, keyboard nudge, and undo/redo without changing board dimensions.
Slide hours
Drag recurring time on the slide.
The Schedule tab edits only the slide selected above. Drag its seven-day timeline in 15-minute increments, then fine-tune exact start and end times. Recurring hours use each Apple TV's current local timezone, and overnight hours continue into the next local day. Imported absolute windows remain exact UTC values with an inclusive start and exclusive end. The Apple TV rechecks schedules after clock or timezone changes and keeps the current board if a fetched schedule is invalid.
Saved handoff
Save here, stage from the hierarchy.
Save keeps isolated editor work in the current manager session; it is not durable or staged yet. Discard, Close, and Browser Back drop unsaved overlay work and restore the prior manager state. Boards & Content enables Stage only for a real saved change, then stores it with the chosen activation time.
Protected change
Layout edits remain explicit.
Routine media work preserves every frame. Explicit layout edits remain in the draft and establish a new protected baseline only when published or activated. A staged layout fails closed if another layout changes its baseline first.
05 · Protected reference
Copy the whole outdoor layout. Change only its content.
Board 10, outdoormenu-postitiontest, is the canonical portrait position test. Its pre-rotation SwiftUI offsets are consumed directly by Apple TV and manager previews without a second center conversion.
BackgroundOutside · 01080 × 1920 · x 420 · y -420r -90 · z 10 · o 1RotatingVideos · 11080 × 625 · x -227.5 · y 227.5r -90 · z 11 · o 1Content-only rule: preserve board, slide, and zone identity plus every frame value. Replace approved entries inside allItems. A frame-only diff should be empty.
06 · Owner-confirmed payment
The agent can take the operator to payment—not pay for them.
signcloudnine.com/add-screens is the stable authenticated handoff. The human owner chooses the workspace and confirms the commercial action.
- 1
Build before the clock starts.
An eligible workspace stages playable content, then connects one complimentary screen for 30 days without a card. The time begins only when the Apple TV successfully connects.
- 2
Confirm the applicable Stripe action.
After the complimentary screen connects, the first paid screen opens a fresh workspace-bound Stripe Checkout session and preserves any included time. An existing subscription uses a separately confirmed prorated quantity increase.
- 3
Wait for paid capacity.
Returning from Stripe is not entitlement. Additional pairing becomes available only after a signed positive-value invoice and an active Stripe subscription grant the paid seat; a zero-dollar trial invoice does not. An expired screen keeps playing with a measured license reminder.
07 · Evidence
Say exactly what the proof covers.
Implemented locally
Name changed files, preserved contracts, and unrelated work left untouched.
Verified locally
Report the exact tests, build, dry run, and visual checks with observed results.
Live or physical
Claim deployment, billing, installation, or Apple TV playback only from that surface's evidence.