Skip to content

Redesign settler cards from the Settler Showcase, and group parallel settlers into a crew - #71

Merged
ParallelEntrepreneur merged 2 commits into
mainfrom
feat/settler-cards
Sep 17, 2026
Merged

ParallelEntrepreneur merged 2 commits into
mainfrom
feat/settler-cards

Conversation

@ParallelEntrepreneur

@ParallelEntrepreneur ParallelEntrepreneur commented Sep 17, 2026

Copy link
Copy Markdown
Collaborator

Implements the Settler Showcase design (claude.ai/design): the ant, the card and
parallel settlers.

The ant (AntAvatar.tsx, index.css) is now a pixel-art worker in side profile,
26 by 20 pixels with crisp edges and a joint for every moving part. The ground,
thought pixels, scribble and lens move a pixel at a time.

  • working: a tripod gait, carrying what the tool is (a lens to search or read, a
    leaf to edit, a block to build or install, a flag to test).
  • thinking: looks up while a thought fills in, dot by dot.
  • writing: nods over a line it writes and rewrites.
  • done: hops once and rests with a check.
  • paused: sits with its antennae drooped.
  • A failed tool result makes it stumble over a pebble, then carry on.
  • Each role wears its own mark: a Scout's pack, a Builder's hard hat, an
    Inspector's monocle, and so on.
  • Reduced motion freezes every state in a readable pose.

The card (SettlerCard.tsx) keeps the settler's name, task and one status line.
It adds a step count and a trail along its foot that moves while the settler
works, and the frame turns green when the settler is done. Collapsed, a done
card shows the first sentence of its report. Opened, it shows the report as
markdown, then the steps: in plain words with the command or path each acted
on, or the raw transcript in the technical view.

Grouping: settlers the orchestrator sends out together are one crew. Their
events interleave while they work, and each settler now keeps one card for the
whole burst instead of splitting into "continued" cards every time another
settler speaks. A crew's cards hang off one rail under a strip of its ants on a
shared trail ("3 settlers · 2 at work · 1 done"), and their loops are staggered
so they never move in lockstep.

Departures from the design, where it showed data colonies don't send:

  • A done card doesn't show a duration, because the stream doesn't record when
    a settler finished.
  • A failed step says "didn't work", not "didn't work · retried", because
    nothing says it was retried.

The mock's colony now sends a crew of three (Scout, Tester, Inspector) with a
failing test run, so ?mock=1 shows every part of this.

…settlers into a crew

Implements the Settler Showcase design (claude.ai/design): the ant, the card and
parallel settlers.

The ant (AntAvatar.tsx, index.css) is now a side-profile worker with a joint for
every moving part.
- working: a tripod gait, carrying what the tool is (a lens to search or read, a
  leaf to edit, a block to build or install, a flag to test).
- thinking: looks up while a thought fills in, dot by dot.
- writing: nods over a line it writes and rewrites.
- done: hops once and rests with a check.
- paused: sits with its antennae drooped.
- A failed tool result makes it stumble over a pebble, then carry on.
- Each role wears its own mark: a Scout's pack, a Builder's hard hat, an
  Inspector's monocle, and so on.
- Reduced motion freezes every state in a readable pose.

The card (SettlerCard.tsx) keeps the settler's name, task and one status line.
It adds a step count and a trail along its foot that moves while the settler
works, and the frame turns green when the settler is done. Collapsed, a done
card shows the first sentence of its report. Opened, it shows the report as
markdown, then the steps: in plain words with the command or path each acted
on, or the raw transcript in the technical view.

Grouping: settlers the orchestrator sends out together are one crew. Their
events interleave while they work, and each settler now keeps one card for the
whole burst instead of splitting into "continued" cards every time another
settler speaks. A crew's cards hang off one rail under a strip of its ants on a
shared trail ("3 settlers · 2 at work · 1 done"), and their loops are staggered
so they never move in lockstep.

Departures from the design, where it showed data colonies don't send:
- A done card doesn't show a duration, because the stream doesn't record when
  a settler finished.
- A failed step says "didn't work", not "didn't work · retried", because
  nothing says it was retried.

The mock's colony now sends a crew of three (Scout, Tester, Inspector) with a
failing test run, so ?mock=1 shows every part of this.
The design's ant is now pixel art on a 2-unit grid, 26 by 20 pixels, with crisp
edges. Every part is a rect, and the role marks and carried objects are pixel
shapes. The legs still turn at their joints. The ground, thought pixels,
scribble and lens now move a pixel at a time, using steps() timing.
AntAvatar.tsx and index.css follow the design's AntAvatar.tsx and ant.css.
@ParallelEntrepreneur
ParallelEntrepreneur merged commit a51e515 into main Sep 17, 2026
@ParallelEntrepreneur
ParallelEntrepreneur deleted the feat/settler-cards branch September 17, 2026 08:00
ParallelEntrepreneur added a commit that referenced this pull request Sep 17, 2026
…laiming no runtime downloads (#78)

docs/vision.md defined a settler as "the agent module working inside a colony".
Since #70 and #71, the colony chat also calls the subagents that module sends out
settlers, named for their role (Scout, Builder, Inspector…), and colonizer.dev is
getting a page about colonies and settlers. The vocabulary now covers both: the
agent module is a colony's first settler, and the subagents it sends out are
settlers too, each with a role.

Principle 4 said "No runtime downloads". That hasn't been true for a while:
microsandbox pulls a colony image the first time a colony needs it, and
switching Headroom on downloads its bundle. docs/install.md already says so.
The principle now keeps what holds (your hardware, its own dependencies, no
cloud account) and names the two downloads after install.
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