Add specification integrity roadmap#36
Merged
Alan-Jowett merged 2 commits intomicrosoft:mainfrom Mar 20, 2026
Merged
Conversation
Document the phased evolution from cross-document spec audits (shipped) through bidirectional code/spec audits, invariant extraction, and standards/protocol analysis. Includes vision for continuous semantic integration as a CI consumer of PromptKit prompts. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Contributor
There was a problem hiding this comment.
Pull request overview
Adds a new “Specification Integrity & Drift Detection” section to the roadmap to describe a phased plan for evolving PromptKit from cross-document audits toward code/spec drift detection and eventually CI integration.
Changes:
- Introduces a multi-phase roadmap (Phases 1–4 + Vision) for specification integrity and drift detection.
- Documents planned future templates/personas/protocols for code/spec and test/spec audits, invariant extraction, and standards/RFC analysis.
Replace the original Phase 4 (which proposed a new persona and multiple standalone capabilities) with a leaner approach: RFCs are requirements documents with a specific format, so RFC support is primarily an input normalization template (RFC -> requirements-document) and an output format (xml2rfc v3). All downstream audit machinery reuses existing components. 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.
Adds a new Specification Integrity & Drift Detection section to \docs/roadmap.md\ documenting the phased evolution plan:
Co-authored-by: Copilot 223556219+Copilot@users.noreply.github.com