mirror of
https://github.com/openprose/prose.git
synced 2026-09-19 05:55:05 +08:00
63c8ce4b23
Move the standard library (previously `github.com/openprose/std`) and
the company-as-prose library (previously local dir
`/Users/sl/code/openprose/company-as-prose`) into this repository
under `packages/std/` and `packages/co/` respectively.
Motivation: concentrate attention on one repository so stars,
discussions, and issues aggregate. `openprose/std` was a genuinely
useful asset nobody could find because ~50 stars on its own repo
told a much worse story than 1,106 stars on `openprose/prose`
would have. Same logic applies to co.
Layout choice: `packages/{std,co}/` rather than `std/` + `co/` at
the repo root. Root siblings accumulate over time, and a flat
top-level made future libraries (hub, kit, dev, etc.) compete with
spec infrastructure. `packages/` is bounded — new libraries land
there without cluttering root. Matches pnpm/Deno/monorepo tooling
conventions.
Changes:
- New: `packages/std/` (copied from openprose/std, `.git` excluded)
- New: `packages/co/` (copied from company-as-prose, README updated
for new name and location)
- `packages/std/README.md`: updated shorthand expansion reference
- `packages/co/README.md`: renamed "company-as-prose" to "co" in
self-references, added std-vs-co split heuristic, updated
`prose run` examples to use `co/` shorthand
- `skills/open-prose/deps.md`:
- `std/` shorthand now expands to
`github.com/openprose/prose/packages/std/`
- `co/` shorthand added, expands to
`github.com/openprose/prose/packages/co/`
- Both shorthands resolve into the same clone of
`openprose/prose` under `.deps/github.com/openprose/prose/`;
`packages/std/` and `packages/co/` are sibling subdirectories
- `prose.lock` format row updated to `host/owner/repo sha`
(matches the explicit-host resolution that landed in #35)
- `.deps/` directory structure example redrawn to show the
`{host}/{owner}/{repo}/packages/{std,co}/...` shape
- Error message and Interaction tables refreshed accordingly
- Resolution Algorithm step 1 now documents both shorthands
- `skills/open-prose/forme.md`: Step 2 resolution list updated to
include co/ shorthand and the host-keyed `.deps/` layout
- `skills/open-prose/help.md`: Q&A "How do dependencies work?"
rewritten to name both shorthands and the new explicit-host model
- `skills/open-prose/state/filesystem.md`: `.deps/` directory
tree re-drawn to include the `{host}/` layer with std/co as
sibling packages inside the clone
- `skills/open-prose/guidance/patterns.md`,
`skills/open-prose/guidance/antipatterns.md`: examples now use
the `std/` shorthand or explicit `github.com/...` rather than
the deprecated bare `openprose/std/` form
- `skills/open-prose/examples/registry-import/index.md`: sample
service reference switched to `std/evals/inspector`
- `README.md`: Stdlib badge replaced with internal `packages/std/`
link plus new `packages/co/` link; "Standard Library" section
rewritten as "Libraries" with both packages described
Out of scope for this PR (deliberately):
- Tooling changes to `prose install` and Forme's `.deps/` writer
to adopt the `{host}/{owner}/{repo}/` layout in practice — this
PR is spec-only. Existing tooling continues to work against
whatever layout it currently implements; the spec now describes
the target.
- Retiring the `openprose/std` GitHub repo. Delete that repo
separately after this merges.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
94 lines
2.9 KiB
Markdown
94 lines
2.9 KiB
Markdown
---
|
|
name: dialectic
|
|
kind: composite
|
|
---
|
|
|
|
# Dialectic
|
|
|
|
Thesis and antithesis argue positions. Disagreement IS the output.
|
|
|
|
### Description
|
|
|
|
Thesis and antithesis argue opposing positions; the unresolved tension is the output.
|
|
|
|
### Metadata
|
|
|
|
- `version`: 0.1.0
|
|
|
|
### Slots
|
|
|
|
- `thesis`
|
|
- requires: task_brief, prior antithesis argument (if not first round)
|
|
- ensures: argument for the position
|
|
- `antithesis`
|
|
- requires: task_brief, prior thesis argument
|
|
- ensures: argument against the position
|
|
|
|
### Config
|
|
|
|
- `task_brief` (string, default: none): The question or topic for debate
|
|
- `rounds` (integer, default: 2): Number of exchange rounds
|
|
|
|
### Invariants
|
|
|
|
- Neither agent knows it is part of a dialectic
|
|
- The full exchange is the output — the composite never resolves the tension
|
|
- Each agent sees only the other's prior argument, not its reasoning
|
|
|
|
### Shape
|
|
|
|
- `self`: manage argument rounds, pass each agent the other's prior argument
|
|
- `delegates`:
|
|
- `thesis`: argue for a position
|
|
- `antithesis`: argue against it
|
|
- `prohibited`: none
|
|
|
|
### Requires
|
|
|
|
- &compositeState exists at __compositeState with:
|
|
thesis: string -- component name for thesis agent
|
|
antithesis: string -- component name for antithesis agent
|
|
task_brief: string -- the question or proposition to argue
|
|
rounds: number -- (optional, default 2)
|
|
|
|
### Ensures
|
|
|
|
- Round 1: thesis argues first, antithesis responds
|
|
- Subsequent rounds: each agent sees the other's prior argument
|
|
- This composite does NOT resolve the tension — the full exchange is the output
|
|
- The parent extracts insight from the tension
|
|
- &compositeState.result contains the full exchange
|
|
- &compositeState.exchange contains the structured round-by-round arguments
|
|
|
|
### Delegation Loop
|
|
|
|
```javascript
|
|
const { thesis, antithesis, task_brief, rounds = 2 } = __compositeState;
|
|
const exchange = [];
|
|
|
|
let lastThesis = null;
|
|
let lastAntithesis = null;
|
|
|
|
for (let round = 0; round < rounds; round++) {
|
|
// Thesis argues
|
|
let thesisBrief = round === 0
|
|
? `Argue FOR the following position.\n\n${task_brief}`
|
|
: `Argue FOR the following position, responding to the counterargument.\n\n${task_brief}\n\nCounterargument from prior round:\n${lastAntithesis}`;
|
|
lastThesis = await rlm(thesisBrief, null, { use: thesis });
|
|
|
|
// Antithesis argues
|
|
const antithesisBrief = `Argue AGAINST the following position.\n\n${task_brief}\n\nArgument to counter:\n${lastThesis}`;
|
|
lastAntithesis = await rlm(antithesisBrief, null, { use: antithesis });
|
|
|
|
exchange.push({ round: round + 1, thesis: lastThesis, antithesis: lastAntithesis });
|
|
}
|
|
|
|
__compositeState.result = exchange;
|
|
__compositeState.exchange = exchange;
|
|
return(exchange);
|
|
```
|
|
|
|
### Notes
|
|
|
|
This is a seed pattern. Neither agent knows it is part of a dialectic. Each receives a brief asking it to argue a position. The structural value is in the tension between positions — premature consensus is more dangerous than unresolved disagreement.
|