Skip to content

Commit c9cc4d3

Browse files
Enhance README with clearer descriptions (#62)
Clarify the explanation of agent creation and contributions. <!-- SPDX-License-Identifier: MPL-2.0 --> ## Summary <!-- Briefly describe what this PR does and why. Link to related issues with "Closes #N". --> ## Changes <!-- List the key changes introduced by this PR. --> - ## RSR Quality Checklist <!-- Check all that apply. PRs that fail required checks will not be merged. --> ### Required - [ ] Tests pass (`just test` or equivalent) - [ ] Code is formatted (`just fmt` or equivalent) - [ ] Linter is clean (no new warnings or errors) - [ ] No banned language patterns (no TypeScript, no npm/bun, no Go/Python) - [ ] No `unsafe` blocks without `// SAFETY:` comments - [ ] No banned functions (`believe_me`, `unsafeCoerce`, `Obj.magic`, `Admitted`, `sorry`) - [ ] SPDX license headers present on all new/modified source files - [ ] No secrets, credentials, or `.env` files included ### As Applicable - [ ] `.machine_readable/STATE.a2ml` updated (if project state changed) - [ ] `.machine_readable/ECOSYSTEM.a2ml` updated (if integrations changed) - [ ] `.machine_readable/META.a2ml` updated (if architectural decisions changed) - [ ] Documentation updated for user-facing changes - [ ] `TOPOLOGY.md` updated (if architecture changed) - [ ] `CHANGELOG` or release notes updated - [ ] New dependencies reviewed for license compatibility (MPL-2.0 / MPL-2.0) - [ ] ABI/FFI changes validated (`src/interface/abi/` and `src/interface/ffi/` consistent) ## Testing <!-- Describe how you tested these changes. --> ## Screenshots <!-- If applicable, add screenshots or terminal output demonstrating the change. --> Signed-off-by: Jonathan D.A. Jewell <6759885+hyperpolymath@users.noreply.github.com>
1 parent 0efb9c0 commit c9cc4d3

1 file changed

Lines changed: 8 additions & 4 deletions

File tree

README.adoc

Lines changed: 8 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -64,10 +64,12 @@ bugs that plague multi-agent systems.
6464

6565
== The Problem
6666

67-
When Agent A creates Agent B, it is _writing a program_. Every agent framework
67+
When Agent A creates Agent B, it is _writing a program_. Almost all agent frameworks
6868
today treats this as string concatenation — prompts glued together, tools passed
6969
as JSON, behaviour defined in untyped configuration. This is the equivalent of
70-
building SQL queries by concatenating user input. We know how that ends.
70+
building SQL queries by concatenating user input. We know how that ends...
71+
72+
Well, maybe not all of us, so here's the primer.
7173

7274
Multi-agent systems today suffer from:
7375

@@ -241,9 +243,11 @@ choreography peer_review(author: Author, reviewer: Reviewer) {
241243
| Specify and verify agent behaviour over time.
242244
|===
243245

244-
== Novel Contributions
246+
== Novel Contributions (I think!)-
245247

246-
007 introduces concepts not found in any existing language:
248+
007 introduces concepts not found in any existing language, except as referenced jtv
249+
(https://github.com/hyperpolymath/jtv and https://jtv-lang.org [under construction])
250+
and typed-wasm (https://github.com/hyperpolymath/typed-wasm), again, as refrenced)
247251

248252
1. **Harvard Architecture for Agent Creation** — grammatical separation of
249253
agent data and control, making agent injection a parse error

0 commit comments

Comments
 (0)