Skip to content

docs: restructure Agent and MAS manifest reference pages - #29

Draft
Tehsmash wants to merge 1 commit into
outshift-open:mainfrom
Tehsmash:docs/manifest-reference-restructure
Draft

docs: restructure Agent and MAS manifest reference pages#29
Tehsmash wants to merge 1 commit into
outshift-open:mainfrom
Tehsmash:docs/manifest-reference-restructure

Conversation

@Tehsmash

@Tehsmash Tehsmash commented Aug 4, 2026

Copy link
Copy Markdown

Summary

  • Rewrites agent.md and mas.md as proper field-level reference documents with top-level fields → metadata → spec → sub-schema sections (ContextChunk, ModelEntry, DesignPattern, WorkflowNode, WorkflowEdge, etc.)
  • Merges topology-and-workflow.md into mas.md as a first-class section; file deleted
  • Merges workflow.md standalone kind: Workflow reference into mas.md; file deleted
  • Drops redundant Concepts sections — Responsibilities tables duplicated the spec field tables, Delegation belongs on the MAS page, Composition and Mealy view added no actionable information
  • Updates all inbound links in README.md, runtime.md, references/index.md, agent.md, and mas.md

Rewrites agent.md and mas.md as proper field-level reference documents,
merges topology-and-workflow.md and workflow.md into mas.md, and removes
all redundant Concepts sections.

- agent.md and mas.md: add top-level fields, metadata, and spec field
  tables with links to per-sub-schema sections (ContextChunk, ModelEntry,
  DesignPattern, WorkflowNode, WorkflowEdge, etc.)
- topology-and-workflow.md: merged into mas.md as a first-class section;
  file deleted
- workflow.md: standalone kind:Workflow reference merged into mas.md;
  file deleted
- Concepts sections dropped from both pages — Responsibilities tables
  duplicated the spec field tables, Delegation belongs on the MAS page,
  Composition and Mealy view added no actionable information
- All inbound links in README.md, runtime.md, references/index.md,
  agent.md, and mas.md updated to new anchors

Signed-off-by: Sam Betts <1769706+Tehsmash@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant