Part 3 of 4 · The review surface

Make the whole Local App easy to see.

The Local Site is the readable part of your Local App. It lives inside the Local Folder, opens in a standard browser without web hosting, and presents the App Information in readable pages. Changes happen by asking the AI Agent, which follows the Agent Instructions, including the relevant Skill or Workflow, and keeps the files and view in agreement.

Use the Starting Template to build the first Local Site.

The Starting Template gives your AI Agent a guided way to ask what you need to see, which pages would help, and how the Local App should work. It then builds the first Local Site and connects it to the App Information for you to review.

A Local Site in practice

The bookkeeper can see the month at a glance.

file:///Users/bookkeeper/Documents/8bit Apps/client-document-follow-up/site/index.htmlfile:///.../site/index.html
Month-End Documents

August close

Four clients still need documents.

Updated August 11
18Received
6Missing
4Clients to contact

Needs attention

  • Alder & Co W-9Missing
  • Briar Studio July bank statementMissing
  • Cedar Works Payroll reportDue Friday

Can you open it on your phone?

Not by default. The Local Site lives on the computer holding the Local Folder, so phone access requires extra sharing or hosting setup.

What it does

A local view that works from your computer.

Open and review

Open the Local Site’s index.html page in your browser. Use familiar pages, navigation, lists, and details to understand the App Information.

Change through conversation

Ask the AI Agent to correct App Information, update a page, or add another useful view. The AI Agent updates the files for you.

Local on your computer

No hosting is required, and nothing is published automatically. You control the Local Folder and who can open it.

See what the AI Agent is working from

The Local Site lets you see what guides the AI Agent.

App Information

Records, statuses, dates, and other facts the AI Agent may use.

Preferences and rules

Your saved choices, boundaries, and protected behavior.

References and certainty

Where information came from and whether it is confirmed or unknown.

Agent Instructions

The readable project rules, Skills, and Workflows that guide the work.

Work Summary

See what guided a completed task.

A Work Summary names the request, the files and Agent Instructions used, what changed, and what the AI Agent checked. Save each dated summary in the history folder so the Local Site’s Recent Activity page can read and present it.

Recorded Alder & Co’s W-9

Request

Mark the August W-9 as received.

Used

document-status.md, clients.md, and the Record a received document Skill.

Changed

The saved status and Alder & Co’s Local Site page.

Checked

Both places show received on August 11.

How updates flow

Save the change first, then update the Local Site.

App Information changes
AI Agent updates the Local Site
You review the result

The page does not refresh on its own, so reload it the way you would reload any page.

The Local Site should match the App Information

If a page is wrong, tell the AI Agent what needs correction. It should fix the App Information, update the Local Site, and confirm that both agree.

What to ask the AI Agent to create

Begin with the pages needed for the first useful journey.

1. Choose the pages

Ask for a home page, the pages needed for everyday use, a guide to the App Information and Agent Instructions, and a Recent Activity page that reads dated work summaries from history.

2. Connect it to the Local App

Tell the AI Agent every page should come from the App Information in the Local Folder and stay in agreement with it.

3. Ask for a full review

Have the AI Agent open every page, follow every link, check narrow browser windows, and make sure the information is clear.

4. Choose the feel

Choose a few words such as calm, practical, friendly, or spacious. Ask for one consistent design.

What every page should provide

Make the current state understandable.

  • A clear page title and short explanation of what the page is for.
  • Consistent navigation back to the home page and related views.
  • Readable labels for known, unknown, imported, or AI Agent-suggested information.
  • Helpful empty, incomplete, warning, and error messages.
  • Clear headings, readable colors, comfortable text, and obvious links and buttons.
  • Pages that remain clear in large and narrow browser windows.

How to manage it

Ask the AI Agent to keep the Local Site current.

  • Keep the whole Local Site inside the site folder.
  • Make sure it still opens when the Local Folder is copied.
  • Update every affected page when App Information changes.
  • Test long text, missing information, links, and realistic records.

Local Site not opening or looking out of date?

Part 4 explains what to check when index.html does not open, links do not work, or a page does not match the App Information. Open the full troubleshooting guide.