Skip to content

docs: animated team peer-review hero SVG in README #222

Merged
Koukyosyumei merged 6 commits into
mainfrom
overview-svg
Jun 24, 2026
Merged

docs: animated team peer-review hero SVG in README #222
Koukyosyumei merged 6 commits into
mainfrom
overview-svg

Conversation

@Koukyosyumei

Copy link
Copy Markdown
Collaborator

No description provided.

Add docs/_static/hero-team.svg — an animated overview of the h5i team
flow: one task fans out to claude and codex in sealed sandboxes, they
peer-review each other in a continuous loop (flowing dashes + traveling
SMIL particles), a neutral verifier replays and tests every candidate,
and the one verified result is merged back into your repo. Replaces the
static screenshot_sandbox_h5i_3.png as the README hero image.
Drop the in-figure eyebrow/title/subline (duplicated the README h1 and
intro paragraph directly above) and recrop the viewBox so the diagram
fills the frame. Picks up the README width 95%->99% tweak.
Increase agent/label/meta/small/stage/chip sizes, widen the verifier
card and shift the result block right so the larger text fits without
overflow. No canvas height change needed.
Added instructions for monitoring the status and included an image for visual explanation.
@Koukyosyumei Koukyosyumei changed the title Overview svg docs: animated team peer-review hero SVG in README Jun 24, 2026
@Koukyosyumei

Copy link
Copy Markdown
Collaborator Author

🪙 75% AI-authored · 4 files · prompt 30/100

3 AI commits

Important

🎯 Goal: Create an animated SVG hero image for README showing the team peer-review loop (claude <-> codex in sandboxes -> user)

3 / 441 : 1.21 / 5
AI commitsfiles touchedREAD : EDITTHINKs / ops

💬 The ask

"Can we generate a nice SVG as the hero image in README that shows the overview of this h5i system?? We can focus on team feature, where claude and codex in sandboxed environment pee-review each other, and the user can get the final high-q…"

📍 What shipped

  • ✓ docs: animated team peer-review hero SVG in README
  • ✓ update
  • ✓ docs: trim redundant title from team hero SVG
  • ✓ docs: bump font sizes in team hero SVG for readability

Note

🪴 Prompt maturity: 30/100 · developing · 3 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.13
Control / acceptance █░░░░░░░░░ 0.11
Context grounding █░░░░░░░░░ 0.08
Structure ██░░░░░░░░ 0.19
Lexical diversity █████████░ 0.92
Clarity (readability band) █████████░ 0.86
Length adequacy ██████████ 0.98

Readability (display-only): Flesch 75 · FK grade 7.2 · Gunning Fog 10.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 — 9766 nodes across 6 lanes, latest 24 only
%%{init: {"flowchart": {"nodeSpacing": 42, "rankSpacing": 48, "diagramPadding": 14}, "themeVariables": {"fontSize": "18px"}} }%%
flowchart TB
  subgraph lane_0["💭 Reasoning · 4 steps"]
    direction LR
    n_lane_0_0["THINK · Let me build a new, polished animated hero SVG focused on the `team` pee…"]:::t
    n_lane_0_1["THINK · Nothing is pushed — let me know if you want `h5i share push` (for the h5…"]:::t
    n_lane_0_2["THINK · The descriptive subline (”One task fans out…”) also duplicates the intro…"]:::t
    n_lane_0_3["THINK · I'll widen the verifier card and nudge the result block right to keep sp…"]:::t
    n_lane_0_0 --> n_lane_0_1
    n_lane_0_1 --> n_lane_0_2
    n_lane_0_2 --> n_lane_0_3
  end
  subgraph lane_1["📄 docs/_static/hero-team.svg · 9 ops"]
    direction LR
    n_lane_1_0["EDIT × 9"]:::a
  end
  subgraph lane_2["📄 README.md · 3 ops"]
    direction LR
    n_lane_2_0["READ × 2"]:::o
    n_lane_2_1["EDIT"]:::a
    n_lane_2_0 --> n_lane_2_1
  end
  subgraph lane_3["📄 docs/pitch/index.html · 1 op"]
    direction LR
    n_lane_3_0["EDIT"]:::a
  end
  subgraph lane_4["📄 docs/_static/h5i-team.svg · 1 op"]
    direction LR
    n_lane_4_0["READ"]:::o
  end
  subgraph lane_5["🗂 Other · 6 nodes"]
    direction LR
    n_lane_5_0["READ · read hero.png"]:::o
    n_lane_5_1["READ · read hero2.png"]:::o
    n_lane_5_2["READ · read hero3.png"]:::o
    n_lane_5_3["READ · read hero4.png"]:::o
    n_lane_5_4["READ · read hero5.png"]:::o
    n_lane_5_5["READ · read hero6.png"]:::o
    n_lane_5_0 --> n_lane_5_1
    n_lane_5_1 --> n_lane_5_2
    n_lane_5_2 --> n_lane_5_3
    n_lane_5_3 --> n_lane_5_4
    n_lane_5_4 --> n_lane_5_5
  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;
Loading

Note

🪙 Token reduction — 4 captured tool outputs kept out of context: 2666 → 1854 tokens (30% saved, 812 tokens). Full output is recoverable with h5i recall object.

📜 Per-commit provenance

d45bcc5d docs: bump font sizes in team hero SVG for readability

  • promptDo you think we can increase the font size a bit more?? If space is limited, it's fine to increase the height (of course we don't need to increase the hight if not necessary)
    • 🌱 prompt maturity 21/100 nascent — vague / under-specified, weak context
  • model claude-opus-4-8 · agent claude-code

a9b2f693 docs: trim redundant title from team hero SVG

  • promptAmazing! I guess we don't need "h5i TEAM", and "Two agents review each other. One verified result ships", cuz we can see the title of README just above this figure.
    • 🪴 prompt maturity 29/100 developing — weak context, no acceptance criteria
  • model claude-opus-4-8 · agent claude-code

5275200c docs: animated team peer-review hero SVG in README

  • promptCan we generate a nice SVG as the hero image in README that shows the overview of this h5i system?? We can focus on team feature, where claude and codex in sandboxed environment pee-review each other, and the user can get the final high-quality output. I guess that it would be …
    • 🪴 prompt maturity 35/100 developing — no acceptance criteria, weak context
  • model claude-opus-4-8 · agent claude-code

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

@Koukyosyumei Koukyosyumei merged commit 0409f72 into main Jun 24, 2026
5 checks passed
@Koukyosyumei Koukyosyumei deleted the overview-svg branch June 24, 2026 22:28
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant