Commit 59ad7f0
authored
docs: reframe README opener around the human+agent audience (#99)
* docs: reframe README opener around the human+agent audience (#90)
The previous opener led with what the harness is (a coding harness for
Python+React) and folded the audience into a trailing clause. The new
opener leads with who it's for — teams pairing AI agents with human
engineers — and keeps the mechanism punchline ("every gate enforced
mechanically in CI, not by discipline") that makes the harness story
distinctive.
Wording matches the repo's GitHub description for consistency between
the two surfaces.
Closes #90
* docs: tighten README opener — harness vocab + 0.2.11 bump (#90)
Review feedback on #99:
- "Production-grade SDLC scaffold" -> "Production-grade SDLC harness".
Everywhere else (package name, docs/HARNESS.md, CLAUDE.md) calls it
a harness; "scaffold" was an unintentional vocabulary drift.
- "regardless of who's at the keyboard" -> "regardless of who shipped
the code". Agents don't have keyboards; the original metaphor leaked.
The new phrasing covers humans and agents without forcing the
human-only mental model.
- README opener now also mirrors the GitHub repo description verbatim
("human-LLM coding collaborations"), so the two surfaces stay
aligned.
Also bumps the project version 0.2.10 -> 0.2.11 (docs change -> PATCH
per docs/DEVELOPMENT.md) in pyproject.toml and the self-version line
in uv.lock, unblocking the "Version bump check" CI gate that flagged
the original commit.
The "enforced mechanically in CI, not by discipline" punchline is
preserved verbatim.
Refs #901 parent 722293d commit 59ad7f0
3 files changed
Lines changed: 3 additions & 3 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
8 | 8 | | |
9 | 9 | | |
10 | 10 | | |
11 | | - | |
| 11 | + | |
12 | 12 | | |
13 | 13 | | |
14 | 14 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
1 | 1 | | |
2 | 2 | | |
3 | | - | |
| 3 | + | |
4 | 4 | | |
5 | 5 | | |
6 | 6 | | |
| |||
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.
0 commit comments