MCPInstall

tool-note-and-vote

Structured group-decision mechanic that captures silent ideation, voting summaries, and Decider sign-off in a single bundled artifact. Use when a small team needs to make a fast decision with diverse input, when groupthink is a risk, or when a workshop moment demands silent contribution before discussion. Applicable to Foundation Sprint, Design Sprint, and any participatory decision context.

Installs
632
Last 24h
—
Trending rank
—
Security
Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/product-on-purpose/pm-skills --skill tool-note-and-vote
  1. 01

    Install

    Run the command in your project. The CLI asks which agents to install for.

  2. 02

    Describe the task

    Ask your agent for something this skill covers. It loads tool-note-and-vote automatically when relevant.

  3. 03

    Review the result

    The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

<!-- PM-Skills | https://github.com/product-on-purpose/pm-skills | Apache 2.0 -->

Note-and-Vote

Run a structured group decision in 20-30 minutes. Silent contribution surfaces independent thinking before group dynamics narrow the option space; explicit Decider supervote closes the choice. Produces a written audit trail of the decision and the alternatives considered.

When to Use

  • A small team (3-10 people) needs to make a fast decision with diverse input.
  • Groupthink, status bias, or loudest-voice dominance is a real risk.
  • A workshop or meeting moment demands silent ideation before open discussion.
  • The decision needs an audit trail (what was considered, why the chosen option won).
  • Decision authority is clear (a Decider exists and is in the room or available).
  • Used heavily across Foundation Sprint and Design Sprint at decision moments.

When NOT to Use

  • A single person owns the decision and just needs to make it. Use direct judgment.
  • Consensus has already emerged organically. The voting overhead adds friction without value.
  • The decision is high-stakes enough to warrant longer deliberation (multi-day investigation, written proposals, formal review). Note-and-Vote is a 25-minute tool, not a governance process.
  • No Decider is available and the team has no authority to close the decision themselves. Defer until a Decider can attend.

The Five-Step Protocol

1. Frame the question (1-2 min)
2. Silent ideation (3-7 min, depending on complexity)
3. Silent voting (2-5 min, multi-vote or single-vote)
4. Brief discussion of the vote distribution (5-10 min)
5. Decider supervote (1 min)

Total: 12-25 minutes depending on time allocations. Default is 25 minutes for a non-trivial decision.

flowchart TB
    Start([Decision needed])
    Start --> S1[Step 1: Frame the question<br/>1-2 min, spoken]
    S1 --> S2[Step 2: Silent ideation<br/>3-7 min, silent]
    S2 --> S3[Step 3: Silent voting<br/>2-5 min, silent]
    S3 --> S4[Step 4: Brief discussion<br/>5-10 min, spoken]
    S4 --> S5{Step 5: Decider supervote<br/>1 min}
    S5 -->|Most common| TopVote[Pick top vote-getter]
    S5 -->|Sometimes| Override[Pick different option<br/>with stated rationale]
    S5 -->|Rare| Revote[Call re-vote after re-framing]
    TopVote --> Record[Decision recorded in artifact]
    Override --> Record
    Revote --> S2

    style S2 fill:#e1f5ff
    style S3 fill:#e1f5ff
    style S5 fill:#fff4e1
    style Record fill:#e1ffe1

Silent steps (blue) protect against anchoring. The Decider supervote (amber) has three legal outcomes; the loop back to silent ideation is the recovery path when the framing was wrong.

Step 1: Frame the question

Write the decision question on the board, one sentence, unambiguous. Examples:

  • "Which target customer segment should our Foundation Sprint commit to for Day 1?"
  • "Which solution sketch goes forward into Wednesday's storyboard?"
  • "Which sprint question should be the primary scorecard row on Friday?"

Bad framings to avoid:

  • Compound questions ("which customer AND problem")
  • Yes/no questions (use a different tool)
  • Open exploration ("what should we do?")

Step 2: Silent ideation

Every participant contributes options silently and independently. Sticky notes on a wall, cells in a Miro board, or rows in a shared doc. No talking. No reading others' contributions until the timer ends.

The facilitator MUST enforce silence. Verbal contribution defeats the purpose.

Step 3: Silent voting

Display all contributions anonymously (or with attribution if the team has agreed). Each participant gets N votes (often 2-3 for a multi-vote round, 1 for a single-vote tiebreaker). Vote silently using dots, stickers, reactions, or numbers. No discussion during voting.

Step 4: Brief discussion

Surface the top 2-3 vote-getters. Each person who voted for the top options briefly explains why. The facilitator times this (5-10 minutes max). If discussion expands beyond the top options, the facilitator pulls it back.

This is the place where the team can detect surprises ("I didn't realize we were aligned on X") or unsurprises ("we're split between A and B for known reasons"). It is not the place to relitigate the framing.

Step 5: Decider supervote

The Decider names the chosen option. The Decider may pick the top vote-getter (most common), pick a different option with stated rationale (sometimes), or call for a re-vote after the discussion (rare).

The supervote is the decision. Record it explicitly in the artifact. Do not let the supervote blur into continued discussion; the team needs to see the close.

Output Structure

The skill produces a single bundled artifact containing:

  1. The decision question (verbatim)
  2. The silent ideation board (all contributions, timestamped, attribution per team agreement)
  3. The vote summary (counts per option, voters per option if attribution agreed)
  4. Discussion notes (brief, the rationale that surfaced)
  5. The decision record (chosen option + Decider name + Decider rationale if non-obvious)

See references/TEMPLATE.md for the canonical structure and references/EXAMPLE.md for a worked example using the Brainshelf book-catalog Foundation Sprint thread.

Common Pitfalls

  • Skipping silent ideation. "Let's just discuss it" defeats the protocol. The team produces what they would have produced without the tool.
  • Skipping Decider supervote. Consensus drift. The discussion ends without a recorded decision.
  • Long discussion phase. Five-minute discussions become twenty-minute debates. The facilitator must time-box and pull back.
  • Compound or vague framing. "What should we do about X?" is not a decidable question. Reframe before invoking.
  • Voting without seeing the contributions. If contributions are revealed during ideation, the voting is anchored to the first idea seen. Enforce silence.
  • Treating the Decider's choice as advisory. The supervote is the decision; if the Decider does not have authority, the wrong person is in the Decider seat.

Decider Role

The Decider has three responsibilities in Note-and-Vote:

  1. Frame the question (or approve the facilitator's framing) before silent ideation begins.
  2. Listen during discussion without dominating. The discussion's purpose is to surface what the silent vote could not.
  3. Supervote with explicit rationale when the supervote diverges from the team's top choice.

A Decider who consistently rubber-stamps the team's top vote is not adding value. A Decider who consistently overrides without rationale is not building trust. Both are signals the wrong person is in the seat.

Canonical Source

Character Capital publishes the canonical Note-and-Vote guide at https://www.character.vc/guide/note-and-vote. Knapp and Zeratsky describe Note-and-Vote variants in both Sprint (Design Sprint context) and Click (Foundation Sprint context).

This pm-skills implementation follows the Character protocol with the Five-Step structure named explicitly.

Cross-Family Usage

tool-note-and-vote is a standalone tool, not a member of any sprint family. It is invoked many times across both foundation-sprint-skills and design-sprint-skills family members at decision moments. SKILL.md files in those families reference tool-note-and-vote inline rather than embedding the protocol.

The skill is also useable outside sprint contexts: any participatory decision in a meeting, planning session, or workshop can invoke it.

FAQ

What does the tool-note-and-vote skill do?

Structured group-decision mechanic that captures silent ideation, voting summaries, and Decider sign-off in a single bundled artifact. Use when a small team needs to make a fast decision with diverse input, when groupthink is a risk, or when a workshop moment demands silent contribution before discussion. Applicable to Foundation Sprint, Design Sprint, and any participatory decision context.

How do I install tool-note-and-vote?

Run npx skills add https://github.com/product-on-purpose/pm-skills --skill tool-note-and-vote in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/tool-note-and-vote/ (personal) or .claude/skills/tool-note-and-vote/ (project).

Which AI agents can use tool-note-and-vote?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is tool-note-and-vote safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains tool-note-and-vote?

It is published by product-on-purpose in product-on-purpose/pm-skills. It has 632 recorded installs.

More from product-on-purpose/pm-skills

View all →

deliver-acceptance-criteria

product-on-purpose/pm-skills

Generates structured Given/When/Then acceptance criteria for a user story or feature slice, covering the happy path, key failure scenarios, and non-functional expectations in testable form. Use when turning requirements into verifiable scenarios for engineering handoff and QA sign-off. For a dedicated catalog of boundary conditions, error states, and recovery paths across a feature, use deliver-edge-cases; to write the stories themselves, use deliver-user-stories.

Testing & QA1.1K installs

deliver-prd

product-on-purpose/pm-skills

Creates a comprehensive Product Requirements Document that aligns stakeholders on what to build, why, and how success will be measured. Use when specifying features, epics, or product initiatives for engineering handoff.

deliver-user-stories

product-on-purpose/pm-skills

Generates user stories in the standard persona, action, benefit story format from product requirements or feature descriptions. Use when breaking a feature into stories for sprint planning, writing tickets, or communicating scope to engineering. For testable Given/When/Then acceptance criteria on a story, use deliver-acceptance-criteria; for boundary and failure scenarios, use deliver-edge-cases.

deliver-edge-cases

product-on-purpose/pm-skills

Documents edge cases, error states, boundary conditions, race conditions, and recovery paths for a feature - the systematic catalog of what can go wrong and the failure modes to design for. Use during specification to map the failure surface and ensure comprehensive coverage, or during QA planning to identify boundary and limit scenarios to test. Distinct from deliver-acceptance-criteria, which writes story-level Given/When/Then checks; this skill produces the whole-feature edge-case catalog.

Testing & QA878 installs

discover-competitive-analysis

product-on-purpose/pm-skills

Creates a structured competitive analysis comparing features, pricing, and positioning across 3-5 direct and indirect competitors, with a 2x2 map and actionable strategic recommendations. Use before entering a market, planning differentiation, or after losing deals. For market size rather than competitor positioning, use discover-market-sizing instead.

define-problem-statement

product-on-purpose/pm-skills

Creates a clear problem framing document with user impact, business context, and success criteria. Use when starting a new initiative, realigning a drifted project, or communicating up to leadership.

Business & Finance821 installs

Popular other skills

View category →

hyperframes-cli

heygen-com/hyperframes

The HyperFrames CLI by job - scaffold, check, look at frames, edit the timeline, preview, render locally or in the cloud, publish, project history - plus reading its JSON and recovering from build or render failures.

1.3M installs

triage

mattpocock/skills

Move issues and external PRs through a state machine of triage roles, categorise, verify, grill if needed, and write agent-ready briefs.

1M installs

ask-matt

mattpocock/skills

Ask which skill or flow fits your situation. A router over the skills in this repo.

778.4K installs

to-questionnaire

mattpocock/skills

Turn a decision you can't fully answer into a questionnaire for someone else to fill in.

508.9K installs

wait-what

mattpocock/skills

Stop. That last message did not land: re-pitch it.

459.7K installs

loop-me

mattpocock/skills

Grill me about specs for the workflows I want to build, within this workspace.

447.9K installs