Skip to content

repo-spec.md

Latest commit

 

History

History
51 lines (41 loc) · 940 Bytes

repo-spec.md

File metadata and controls

51 lines (41 loc) · 940 Bytes

Repository Spec

Goal

This section tells an implementation agent how to build a reference runtime repository from the research in this repo without guessing the intended architecture.

Initial Repository Shape

reference-coding-agent-runtime/
  packages/
    runtime-core/
    runtime-types/
    tool-adapters/
    policy-hooks/
    test-harness/
  docs/
    architecture/
    patterns/
    decisions/

Interfaces To Define First

  1. Task
  2. AgentState
  3. ToolCall
  4. ToolResult
  5. CompletionAttempt
  6. RequiredAction
  7. JournalEvent
  8. RuntimePolicyHook
  9. SubagentRun

Minimal Viable Runtime Sequence

  1. Create task.
  2. Run one turn.
  3. Execute a tool.
  4. Reinject a result.
  5. Attempt completion.
  6. Reject or accept completion.
  7. Emit journal events throughout.

What To Defer

  • rich UI,
  • provider proliferation,
  • plugin ecosystems,
  • graph orchestration,
  • business-domain policies.
⚡