You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Add ponder skill for convergent multi-pass review and deliberation - #5999
My contribution adds a new instruction, prompt, agent, skill, workflow, or canvas extension file in the correct directory.
The file follows the required naming convention.
The content is clearly structured and follows the example format.
I have tested my instructions, prompt, agent, skill, workflow, or canvas extension with GitHub Copilot.
I have run npm start and verified that README.md is up to date.
I am targeting the main branch for this pull request.
Description
I added the ponder skill under skills/ponder/ (SKILL.md and references/{protocol.md,perspectives.md,harness-notes.md}) and updated docs/README.skills.md via npm run build.
Ponder is a convergent, multi-pass deliberation loop for coding agents. Instead of running a single review pass that skips files or a naive repeat prompt that manufactures nitpicks on later passes, Ponder enforces:
Exhaustive unit enumeration (units.json): Every file, screen, or plan unit in scope is inventoried before grading begins, and decide stop refuses to pass (blocked) while any enumerated unit is ungraded (coverage < 1.0).
Four explicit perspectives (deliberation.json): Every pass records structured arguments from skeptic, builder, dreamer, and empath.
Append-only delta ledger (deltas.jsonl): Pass 2+ revises prior findings via explicit delta operations (add, edit, change, delete, unit-add, unit-edit, unit-delete) rather than rewriting findings from scratch, allowing late passes to converge quietly when all findings hold.
Type of Contribution
New instruction file.
New prompt file.
New agent file.
New plugin.
New skill file.
New agentic workflow.
New canvas extension.
Update to existing instruction, prompt, agent, plugin, skill, workflow, or canvas extension.
Risk tier:merge-risk:high — Privileged execution, automation, or review-policy change Required to merge: passing submission-gate checks plus 1 approval from reviewers with write access, including a maintainer with admin or maintain permission.
Why this tier
Label needs-review:HIGH flags a high contributor-risk signal
✓ [spec-compliance] All 1 skill(s) are spec-compliant.
ℹ️
✓ spec-compliance: All spec checks passed.
ℹ️
✓ [valid-refs] All file references across 1 skill(s) are valid.
ℹ️
✓ valid-refs: All file references resolve to existing files within the skill directory.
ℹ️
1 skill(s) linted, 1 passed
Full linter output
### Linting skills/ponder
✅ ponder (2/2 checks passed)
✓ [spec-compliance] All 1 skill(s) are spec-compliant.
✓ spec-compliance: All spec checks passed.
✓ [valid-refs] All file references across 1 skill(s) are valid.
✓ valid-refs: All file references resolve to existing files within the skill directory.
1 skill(s) linted, 1 passed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Pull Request Checklist
npm startand verified thatREADME.mdis up to date.mainbranch for this pull request.Description
I added the
ponderskill underskills/ponder/(SKILL.mdandreferences/{protocol.md,perspectives.md,harness-notes.md}) and updateddocs/README.skills.mdvianpm run build.Ponder is a convergent, multi-pass deliberation loop for coding agents. Instead of running a single review pass that skips files or a naive repeat prompt that manufactures nitpicks on later passes, Ponder enforces:
units.json): Every file, screen, or plan unit in scope is inventoried before grading begins, anddecide stoprefuses to pass (blocked) while any enumerated unit is ungraded (coverage < 1.0).deliberation.json): Every pass records structured arguments fromskeptic,builder,dreamer, andempath.deltas.jsonl): Pass 2+ revises prior findings via explicit delta operations (add,edit,change,delete,unit-add,unit-edit,unit-delete) rather than rewriting findings from scratch, allowing late passes to converge quietly when all findings hold.Type of Contribution
Additional Notes
Local validation run before opening this PR:
npx @microsoft/vally-cli lint skills/ponder --verbose:2/2 checks passed(spec-compliance,valid-refs)npm run skill:validate:All 449 skills are validuvx codespell skills/ponder:0 errorsnode ./eng/pr-risk-scan.mjs:High: 0, Medium: 0, Info: 0npm run buildandbash eng/fix-line-endings.sh: updateddocs/README.skills.mdcleanly.By submitting this pull request, I confirm that my contribution abides by the Code of Conduct and will be licensed under the MIT License.