From f191a16f86a86177e35117d12ed67896ce940e82 Mon Sep 17 00:00:00 2001 From: dadachi Date: Mon, 20 Apr 2026 21:10:02 +0900 Subject: [PATCH] Fill README gaps: demo placeholder, architecture diagram, stretch specs MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Addresses §2.3 of the pre-hackathon checklist — the public README is the first thing reviewers see, so the three checklist items (example specs beyond the must-have clinic queue, architecture visual, demo placeholder) need to land before Tuesday. Co-Authored-By: Claude Opus 4.7 (1M context) --- README.md | 27 ++++++++++++++++++++++++++- 1 file changed, 26 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 1362738..2dc7d50 100644 --- a/README.md +++ b/README.md @@ -37,6 +37,27 @@ It will: 5. **Drive the build green** — `bin/rails test`, `xcodebuild test`, `./gradlew test` must all pass before the agent exits. 6. **Validate the output** across three layers (structural, runtime, semantic). Details in [`docs/SPEC.md`](./docs/SPEC.md) section 6. +## Demo + +*90-second end-to-end run — coming after the hackathon wrap on 2026-04-27.* + +## Architecture + +```mermaid +flowchart LR + Spec["Natural-language spec
(e.g. walk-in clinic queue)"] --> Agent + subgraph Agent["Claude Code Agent · Opus 4.7"] + Planner --> Workers + Workers --> Reviewer + Reviewer --> Judge + end + Substrate[("Free-edition substrate
Rails · iOS · Android
READ-ONLY")] -. copy .-> Out + Agent --> Out["./out/[slug]/
rails / ios / android"] + Out --> L1["Layer 1 — Structural"] + L1 --> L2["Layer 2 — Runtime + mobile-mcp"] + L2 --> L3["Layer 3 — Vision judge"] +``` + ## Substrate The agent operates on the free, MIT-licensed edition of NativeAppTemplate — three public repos: @@ -54,9 +75,13 @@ Combined ~42.5k LOC. Extracted from [MyTurnTag Creator](https://myturntag.com), > **Not yet functional — hackathon build in progress.** The interface below is the target; `npx` won't work until v0.1 ships at the end of hackathon week. ```bash -# Standalone CLI +# Standalone CLI — must-have for the hackathon demo npx nativeapptemplate-agent "a walk-in clinic queue for small veterinary practices" +# Stretch specs the agent is also designed to handle +npx nativeapptemplate-agent "a restaurant waitlist for casual dining" +npx nativeapptemplate-agent "a personal task tracker with due dates" + # Generated output appears under ./out// tree ./out/clinic-queue/ # ├── rails/ ← Rails 8.1 API, git-initialized, buildable