Skip to content

Define and verify the annotation interpretation contract #7

Closed

Description

@lastobelus

Outcome

Agents can reliably distinguish requested revisions from questions, discussion, and contextual notes in a Markover handoff.

Acceptance criteria

  • The protocol or agent-facing contract explicitly distinguishes revision requests, questions, discussion, and source proposals.
  • Concrete positive and negative examples cover mixed-feedback reviews.
  • Representative automated protocol/evaluation cases fail when questions are treated as edit requests.
  • Generic agent instructions and each supported agent example use the same semantics.
  • The public workflow no longer over-promises beyond the verified behavior.

Intended PR stack

Bottom to top:

  1. Centralize the interpretation model and protocol semantics.
  2. Apply the semantics to agent instructions and examples.
  3. Add representative evaluation and regression coverage.

Activity

  1. added this to the Focused preview milestone on Aug 3, 2026
  2. self-assigned this
    on Aug 3, 2026
  3. added
    enhancementNew feature or request
    launch:blockerBlocks the next Markover announcement gate
    launchWork required for an announcement or release gate
    on Aug 3, 2026
  4. lastobelus commented on Aug 3, 2026

    @lastobelus
    OwnerAuthor

    Stack scaffold initialized locally from origin/main. No empty placeholder PRs were submitted.

    Bottom → top:

    • agent/launch-annotation-contract
    • agent/launch-annotation-guidance
    • agent/launch-annotation-evals

    Begin on the bottom branch, keep each layer independently reviewable, and run gh stack submit once the layers contain their real implementation commits.

  5. lastobelus commented on Aug 4, 2026

    @lastobelus
    OwnerAuthor

    Implementation stack submitted: #47 → #48 → #49. Automated cross-model agent evaluations are tracked separately in #46 under the Broad announcement milestone. Full stack verification: npm test (196 passing) and npm run check.

  6. moved this from Todo to In Progress in Markover Announcement Readinesson Aug 6, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

enhancementNew feature or requestlaunchWork required for an announcement or release gatelaunch:blockerBlocks the next Markover announcement gate

Projects

Relationships

None yet

Development

No branches or pull requests

Issue actions