Add protocol engineering templates, protocols, and formats#84
Merged
Alan-Jowett merged 3 commits intomicrosoft:mainfrom Mar 27, 2026
Merged
Conversation
Add a new protocol-engineering category to PromptKit with 10 components for designing, evolving, analyzing, and validating communication protocol specifications (RFCs, internet-drafts, formal specs). New components: - Persona: protocol-architect - Taxonomy: protocol-change-categories (PC1-PC8) - Protocols: protocol-evolution, protocol-conflict-analysis, protocol-validation-design - Formats: protocol-delta, protocol-validation-spec - Templates: evolve-protocol (interactive), analyze-protocol-conflicts, author-protocol-validation - Pipeline: protocol-engineering (extract -> evolve -> validate) Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Contributor
There was a problem hiding this comment.
Pull request overview
Adds a new protocol-engineering component set to PromptKit so users can evolve protocol specifications, analyze conflicts between specs, and derive protocol validation specifications using dedicated personas, reasoning protocols, taxonomies, and formats.
Changes:
- Introduces a new
protocol-architectpersona plus three protocol-engineering reasoning protocols. - Adds two new output formats (
protocol-delta,protocol-validation-spec) and three new templates that use them. - Registers all new components in
manifest.yaml, including a newprotocol-engineeringtemplate category and pipeline.
Reviewed changes
Copilot reviewed 11 out of 11 changed files in this pull request and generated 7 comments.
Show a summary per file
| File | Description |
|---|---|
| templates/evolve-protocol.md | New interactive template for evolving a protocol spec and producing a delta. |
| templates/author-protocol-validation.md | New template to derive a protocol validation specification from a protocol spec. |
| templates/analyze-protocol-conflicts.md | New template to compare two protocol specs and produce an investigation report. |
| taxonomies/protocol-change-categories.md | New taxonomy (PC1–PC8) to classify protocol spec change types/impact. |
| protocols/reasoning/protocol-validation-design.md | New reasoning protocol for deriving validation specs from protocol specs. |
| protocols/reasoning/protocol-evolution.md | New reasoning protocol for systematically evolving a protocol spec. |
| protocols/reasoning/protocol-conflict-analysis.md | New reasoning protocol for structured comparison/conflict analysis of two specs. |
| personas/protocol-architect.md | New persona tailored to protocol/IETF-style specification work. |
| manifest.yaml | Registers new persona/protocols/formats/taxonomy/templates and defines a protocol-engineering pipeline. |
| formats/protocol-validation-spec.md | New fixed-structure format for validation-spec artifacts. |
| formats/protocol-delta.md | New fixed-structure format for protocol delta/amendment artifacts. |
…stency - Fix PC7 co-occurrence contradiction: single-label with documented security implications instead of multi-label - Fix input_contract on evolve-protocol, analyze-protocol-conflicts, and author-protocol-validation: set to null since requirements doc is optional - Add taxonomies declaration to evolve-protocol frontmatter - Fix hyphenated line break in analyze-protocol-conflicts - Fix pipeline: remove consumes from stages with optional inputs Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
…labels - protocol-validation-spec: allow spec-section citations when no requirements document with REQ-IDs is provided - protocol-delta: use full taxonomy labels (e.g., PC5_STATE_MACHINE_MODIFICATION) in example tables and field descriptions Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
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
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
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.
Summary
Adds a new protocol-engineering category to PromptKit with 10 components for designing, evolving, analyzing, and validating communication protocol specifications (RFCs, internet-drafts, formal specs).
New Components (10)
Persona
Taxonomy
Reasoning Protocols
Formats
Templates
Pipeline
Design Rationale
Verification