Skip to content

Add log_retrospective and list_retrospectives to the tool reference #13

Open

Description

@joeldickson

agents/tools.mdx lists 33 tools and the server now registers 35. log_retrospective and list_retrospectives (ShipLean/ShipLean#39) are missing, and scripts/gen-tools.ts --check reports the reference as stale.

Regenerating alone isn't enough

I ran the generator against product main at 88363af in a scratch clone, without committing the result, and found three problems:

  1. Wrong description. log_retrospective comes out with "The key of the work item this retrospective is about, such as SHIP-12." That's the text of a parameter, not the tool's description. The real description opens with the learning-from-failure preamble, so check how the generator reads it.
  2. Wrong group. Both tools land under a new ### Other heading, because the groups map in gen-tools.ts has no entry for their area. Add one, for example Retrospectives.
  3. Lost text. It removes the paragraph under sprint_status that starts "The capacity part of the answer…", which was written by hand inside the generated block. Move that paragraph into the tool's description in the product repo, or outside the block.

Also update

  • agents/scopes.mdx: add log_retrospective to shiplean:write and list_retrospectives to shiplean:read.
  • Regenerating also picks up reworded descriptions on other tools, such as break_down now covering action items. Those need no separate work.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentation

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions