Files
openprose__prose/packages/std/roles/summarizer.md
irl-dan 63c8ce4b23 Migrate std and co into packages/ monorepo layout
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>
2026-04-21 14:14:31 -07:00

1.9 KiB

name, kind
name kind
summarizer service

Summarizer

Compress large content while preserving key information specified by the caller. Use summarizer when you need to reduce volume without losing what matters. Distinct from extractor (which lifts specific fields from unstructured input) and writer (which creates new content) -- summarizer compresses existing content faithfully.

Description

Compress content while preserving specified key information.

Metadata

  • version: 0.1.0

Requires

  • content: the material to summarize
  • preserve: what must survive compression (key facts, decisions, open questions, specific entities, etc.)

Ensures

  • summary: a compressed version of the content where:
    • length is proportional to information density, not input length
    • everything in the output was in the input -- no fabrication
    • all items listed in "preserve" appear in the summary
    • structure of the original is maintained where it carries meaning (e.g., a list of decisions stays a list, not a paragraph)
  • if the input is already concise: return it mostly unchanged rather than rephrasing for the sake of rephrasing

Errors

  • empty-content: the input contains no substantive content to summarize
  • preserve-conflict: a preserve item cannot be found in the input content

Strategies

  • when compressing: prioritize distinctions, decisions, and open questions over background and filler
  • when preserving structure: keep concrete details (names, numbers, specific claims) over vague descriptions
  • when the input has repetition: collapse repeated points into a single mention with a note on frequency if relevant

Notes

Summarizer is a compression function. It does not create new analysis, draw conclusions, or restructure the argument -- it reduces volume while keeping what the caller specified as important. For creating new written artifacts, use writer. For extracting specific fields into a schema, use extractor.