Skip to content
This repository was archived by the owner on Oct 1, 2026. It is now read-only.

docs: README pass before 0.1.0 publish - #13

Merged
joshrotenberg merged 1 commit into
mainfrom
docs/readme-pass-for-0.1.0
Apr 18, 2026
Merged

joshrotenberg merged 1 commit into
mainfrom
docs/readme-pass-for-0.1.0

Conversation

@joshrotenberg

Copy link
Copy Markdown
Contributor

Summary

Pre-publish read-through of the main README.

Changes

  • Install snippet: gen_agent_anthropic constraint bumped from ~> 0.1 to ~> 0.2 (needs :receive_timeout from 0.2.0)
  • Strategies table note: the "see also" link pointed at hexdocs.pm/gen_agent's pattern guides, which doesn't reflect the current layering (orchestration patterns live in this repo now per the ensemble pattern direction). Rewired to point at our own guides/workflows/overview.md.
  • Quickstart: reflects that echo is pre-enabled after chore: re-comment example ensembles in config/config.exs before publishing #2 — no manual config edit needed to try it. Spells out the uncomment-then-restart path for a real ensemble.
  • Workflow guides pointer: listed all 7 strategies (Solo, Switchboard, Pool, Pipeline, Supervisor, Debate, Consensus) instead of just the original 4.
  • Status footer: tightened wording — op vocabulary and public API are stable ahead of 1.0; breaking changes bump minor.
  • Development section: added the full pre-commit checklist that matches CI (format, compile, credo, dialyzer, test).

Test plan

  • mix format --check-formatted clean
  • mix test green (86 tests)
  • mix docs still exits 0 (won't know about 22 warnings until docs: mix docs builds clean, zero warnings #12 merges)
  • Spot-check all internal links still resolve (guides/workflows/*)

Closes #5

- Install snippet: bump gen_agent_anthropic constraint to ~> 0.2
  (uses :receive_timeout from that version)
- Strategies table note: point at the local workflow guides
  instead of the dead link to gen_agent's hexdocs; orchestration
  patterns live here now
- Quickstart: reflect that `echo` is pre-enabled after the
  config re-comment (no manual edit needed to try it), and
  spell out the uncomment-then-restart path for real ensembles
- Per-strategy guide pointer lists all 7 strategies, not just 4
- Status footer tightened: the op vocabulary and public API are
  stable ahead of 1.0, breaking changes bump minor
- Development section adds the full pre-commit checklist that
  matches CI
@joshrotenberg
joshrotenberg merged commit 65d0823 into main Apr 18, 2026
2 checks passed
@joshrotenberg
joshrotenberg deleted the docs/readme-pass-for-0.1.0 branch April 18, 2026 04:42
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

docs: README pass before 0.1.0 publish

1 participant