Skip to content

Tighten the protocol cross-references in the panel skills #104

Open

Description

@cacack

Generated by Claude Code.

At a glance

The review of #101 found several small places where the panel skills' references to the shared protocol are worded loosely enough that a reader or a model could misread them. None of them changes behavior today. This issue tightens the wording so every step points at exactly one protocol section and nothing can be copied out of a template by mistake.

Context

Why now: these four findings came out of the 6-persona review of #101 and were deferred as non-defects (one MEDIUM, three LOW).
What is missing: clear wording at these four places:

  1. panel-product step 0 cites protocol Arguments next to Probe the environment, but arguments are parsed in the earlier Arguments section (Ergonomics reviewer, MEDIUM).
  2. The (protocol) markers sit on heading lines inside the fenced snapshot.md templates, where they could be copied into the snapshot word for word (Maintainer reviewer, LOW).
  3. The gh field list is tucked into a parenthetical on the ## Open issues heading line inside those templates (Skeptic reviewer, LOW).
  4. The protocol's partial-run note says "full default set". panel-product overrides this for its opt-in market persona, but the protocol wording doesn't anticipate that kind of override (Ergonomics reviewer, LOW).

Value: low. Fewer ways to misread the protocol, and less chance that stray template markers end up in snapshot files.

Acceptance Criteria

  • panel-product step 0 cites only Probe the environment, or explains why it also cites Arguments.
  • No fenced snapshot.md template in either panel skill has a heading line carrying (protocol) or a field list. The markers and field lists sit outside the fence or in a template comment.
  • The protocol's partial-run rule defines "full default set" so that it covers a panel-declared opt-in persona.
  • make constitution-check passes, and the panels plugin version is bumped.

Scope

In: wording at the four sites above.
Out: any change to what the panels capture or how they run.

References

Activity

  1. added
    effort:lowLow implementation effort
    type:storyBuild something, with design latitude
    class:plannedChosen work; eligible for a milestone
    skillsSkills and their references/templates
    on Oct 4, 2026
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

    class:plannedChosen work; eligible for a milestoneeffort:lowLow implementation effortskillsSkills and their references/templatestype:storyBuild something, with design latitudevalue:lowLow user value

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions