docs(front): reframe landing around the acceptance-layer narrative by Koukyosyumei · Pull Request #248 · h5i-dev/h5i

Koukyosyumei · 2026-07-01T17:42:27Z

No description provided.

Restructure the front page flow after the h5i serve demo: add a 'What you just saw' interpretation, sharpen the problem into 'code generation got cheap, code acceptance got risky', collapse the 6-card feature grid into three primitives (Isolate / Record / Audit & Accept), and replace the tricks section with a 'What lives in Git' refs/h5i/* section. FAQ now leads with 'What is h5i?' to broaden past team framing.

… caption Drop the standalone acceptance-layer section and instead put a single line under the h5i serve demo: 'A live record of what each agent did, why it changed the code, and what evidence supports merging it.'

Insert a quick-scan section after the hero: the README elevator-pitch paragraph plus a six-card capability grid (prompt versioning, persistent context/memory, supervised sandbox, ~95% token reduction, conflict-free multi-agent orchestra, automated audit) so readers grasp the purpose before the 'bottleneck changed' framing.

- Add a top border/padding to #team so there is a divider line between the 'How it works' primitives and the team section. - Remove the bottom 'Get Started' install section; the /workflows guide and the hero install command already cover onboarding. - Repoint the nav 'Install' link to the hero install command (#quickstart) at the top of the page, and drop the redundant hero 'Get Started' button, promoting 'See Workflows' to the primary action.

Relocate the 'two heads are better than one' proverb row from the 'Built with h5i' section to the end of the killer-workflow team section, where the 'run many, merge one' framing makes it land.

Swap the split terminal transcript + verdict cards in the team section for the _static/hero-team.svg diagram, framed in a dashboard-wrap.

Koukyosyumei · 2026-07-01T17:42:46Z

🪙 75% AI-authored · 1 file · prompt 51/100

6 AI commits

Important

🎯 Goal: Restructure docs front page: acceptance-layer narrative, 3 primitives (Isolate/Record/Audit & Accept), dissolve tricks section, tighten FAQ

6 / 8	1	1 : 4.2	1 / 7
_{AI commits}	_{files touched}	_{READ : EDIT}	_{THINKs / ops}

💬 The ask

"Let's improve the front page of ./docs. "うん、方向性としては front pageはpitchよりさらに「読む」ではなく「理解して押す」ページ にしたほうがよさそう。今のindexは、heroと h5i serve デモまでは強い一方で、その後が features → problem → team → tricks → built-with → explore → install → FAQ になっていて、少し「機能説…"

📍 What shipped

✓ docs(front): add a 'What h5i is' summary section from the README pitch
✓ docs(front): drop the Get Started install section, add team separator
✓ docs(front): move the multilingual proverbs to the team section
✓ docs(front): replace the team terminal/verdict block with hero-team.svg
✓ update

Note

🌿 Prompt maturity: 51/100 · proficient · 6 prompts scored (100% of AI commits)
🔧 Recurring weak spots: weak context, no acceptance criteria, vague / under-specified.
Heuristic signal of prompt craft — not a developer rating.

📊 heuristic breakdown

Dimension	Signal
Specificity	`████████░░` 0.76
Control / acceptance	`█████░░░░░` 0.45
Context grounding	`██████░░░░` 0.61
Structure	`████░░░░░░` 0.41
Lexical diversity	`████████░░` 0.84
Clarity (readability band)	`████████░░` 0.82
Length adequacy	`██████████` 0.97

Readability (display-only): Flesch 60 · FK grade 9.8 · Gunning Fog 12.3

Offline classical-NLP score — no LLM. Higher = more specific, bounded, and grounded prompting.

Tip

✅ Security scan clean

No credentials leaked in this branch's diff. h5i scanned every added line against the secret rule pack and found nothing to rotate.

Note

Duplicate-code scan clean — no copy-paste blocks introduced.

🧠 Reasoning by file — 10295 nodes across 2 lanes, latest 24 only

%%{init: {"flowchart": {"nodeSpacing": 42, "rankSpacing": 48, "diagramPadding": 14}, "themeVariables": {"fontSize": "18px"}} }%%
flowchart TB
  subgraph lane_0["💭 Reasoning · 3 steps"]
    direction LR
    n_lane_0_0["THINK · Let me do a quick structural sanity check on tag balance:"]:::t
    n_lane_0_1["THINK · Let me add a compact ”What h5i is” section right after the hero (before …"]:::t
    n_lane_0_2["THINK · I'll move the proverbs block from `#built-with` into the `#team` section…"]:::t
    n_lane_0_0 --> n_lane_0_1
    n_lane_0_1 --> n_lane_0_2
  end
  subgraph lane_1["📄 docs/index.html · 21 ops"]
    direction LR
    n_lane_1_0["READ"]:::o
    n_lane_1_1["EDIT × 7"]:::a
    n_lane_1_2["READ"]:::o
    n_lane_1_3["EDIT × 7"]:::a
    n_lane_1_4["READ"]:::o
    n_lane_1_5["EDIT × 2"]:::a
    n_lane_1_6["READ"]:::o
    n_lane_1_7["EDIT"]:::a
    n_lane_1_0 --> n_lane_1_1
    n_lane_1_1 --> n_lane_1_2
    n_lane_1_2 --> n_lane_1_3
    n_lane_1_3 --> n_lane_1_4
    n_lane_1_4 --> n_lane_1_5
    n_lane_1_5 --> n_lane_1_6
    n_lane_1_6 --> n_lane_1_7
  end
  classDef o fill:#dbeafe,stroke:#1e3a8a,color:#0b1c4a;
  classDef t fill:#fef3c7,stroke:#92400e,color:#3f2d05;
  classDef a fill:#dcfce7,stroke:#166534,color:#0a2e16;
  classDef n fill:#ede9fe,stroke:#5b21b6,color:#221251;
  classDef m fill:#e5e7eb,stroke:#374151,color:#0b0f17;

📜 Per-commit provenance — 6 AI-authored commits

`097d4f78` docs(front): replace the team terminal/verdict block with hero-team.svg

prompt — We can also remove " ~/my-project · team: fix-auth $ h5i env create claude-arch --profile architect # persona baked from .h5i/env.toml $ h5i env create codex-impl --profile implementer $ h5i team create fix-auth --base HEAD $ h5i team add-env fix-auth env/claude-arch/fix-auth --…
- 🌿 prompt maturity 54/100 proficient
model claude-opus-4-8 · agent claude-code

`7ceed6a0` docs(front): move the multilingual proverbs to the team section

prompt — We can move "Two heads are better than one. Dos cabezas piensan mejor que una. 三个臭皮匠，胜过一个诸葛亮。 एक से भले दो। 三人寄れば文殊の知恵。 Deux avis valent mieux qu'un." to THE KILLER WORJFLOW THEN SCALE section
- 🪴 prompt maturity 26/100 developing — weak context, vague / under-specified
model claude-opus-4-8 · agent claude-code

`75dc78af` docs(front): drop the Get Started install section, add team separator

prompt — nice. I guess we can also add a section border line between HOW IT WORKS and THE KILLER WORKFLOW THEN SCALE. We can also remove GET STARTED cuz we already have workflow. The right Install button can link to the install command at the beggining of this front page.
- 🪴 prompt maturity 42/100 developing — no acceptance criteria, weak context
model claude-opus-4-8 · agent claude-code

`012b24f7` docs(front): add a 'What h5i is' summary section from the README pitch

prompt — I think the current README.md's top summary "h5i (pronounced high-five) gives every AI coding agent a sandboxed Git worktree, and records the prompts, commands, logs, policies, and reviews behind every change. Run one agent safely, scale to many via a conflict-free multi-agent or…
- 🪴 prompt maturity 37/100 developing
model claude-opus-4-8 · agent claude-code

`ef4923f4` docs(front): replace 'What you just saw' section with a one-line demo caption

prompt — I guess we can remove "What you just saw" section, and instead add one line like "A live record of what each agent did, why it changed the code, and what evidence supports merging it." bellow the h5i serve's tab example
- 🪴 prompt maturity 39/100 developing — no acceptance criteria, weak context
model claude-opus-4-8 · agent claude-code

`984937e9` docs(front): reframe landing around the acceptance-layer narrative

prompt — Let's improve the front page of ./docs. "うん、方向性としては front pageはpitchよりさらに「読む」ではなく「理解して押す」ページ にしたほうがよさそう。今のindexは、heroと h5i serve デモまでは強い一方で、その後が features → problem → team → tricks → built-with → explore → install → FAQ になっていて、少し「機能説明ページ」に戻っている感じがあります。一方pitchは、`why now → …
- 🌿 prompt maturity 67/100 proficient
model claude-opus-4-8 · agent claude-code

_{Generated by h5i · re-run h5i share pr post to refresh.}

Koukyosyumei added 8 commits July 1, 2026 13:07

update

1e759e0

docs(front): move the multilingual proverbs to the team section

7ceed6a

Relocate the 'two heads are better than one' proverb row from the 'Built with h5i' section to the end of the killer-workflow team section, where the 'run many, merge one' framing makes it land.

docs(front): replace the team terminal/verdict block with hero-team.svg

097d4f7

Swap the split terminal transcript + verdict cards in the team section for the _static/hero-team.svg diagram, framed in a dashboard-wrap.

update

7e8e496

Koukyosyumei changed the title ~~Improve pages~~ docs(front): reframe landing around the acceptance-layer narrative Jul 1, 2026

Koukyosyumei merged commit 9053f81 into main Jul 1, 2026
5 checks passed

Koukyosyumei deleted the improve-pages branch July 1, 2026 17:43

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

docs(front): reframe landing around the acceptance-layer narrative#248

docs(front): reframe landing around the acceptance-layer narrative#248
Koukyosyumei merged 8 commits into
mainfrom
improve-pages

Koukyosyumei commented Jul 1, 2026

Uh oh!

Koukyosyumei commented Jul 1, 2026

✅ Security scan clean

`097d4f78` docs(front): replace the team terminal/verdict block with hero-team.svg

`7ceed6a0` docs(front): move the multilingual proverbs to the team section

`75dc78af` docs(front): drop the Get Started install section, add team separator

`012b24f7` docs(front): add a 'What h5i is' summary section from the README pitch

`ef4923f4` docs(front): replace 'What you just saw' section with a one-line demo caption

`984937e9` docs(front): reframe landing around the acceptance-layer narrative

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

Uh oh!

Conversation

Koukyosyumei commented Jul 1, 2026

Uh oh!

Koukyosyumei commented Jul 1, 2026

🪙 75% AI-authored · 1 file · prompt 51/100

💬 The ask

📍 What shipped

✅ Security scan clean

097d4f78 docs(front): replace the team terminal/verdict block with hero-team.svg

7ceed6a0 docs(front): move the multilingual proverbs to the team section

75dc78af docs(front): drop the Get Started install section, add team separator

012b24f7 docs(front): add a 'What h5i is' summary section from the README pitch

ef4923f4 docs(front): replace 'What you just saw' section with a one-line demo caption

984937e9 docs(front): reframe landing around the acceptance-layer narrative

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

`097d4f78` docs(front): replace the team terminal/verdict block with hero-team.svg

`7ceed6a0` docs(front): move the multilingual proverbs to the team section

`75dc78af` docs(front): drop the Get Started install section, add team separator

`012b24f7` docs(front): add a 'What h5i is' summary section from the README pitch

`ef4923f4` docs(front): replace 'What you just saw' section with a one-line demo caption

`984937e9` docs(front): reframe landing around the acceptance-layer narrative