docs(plan): Context Architecture Optimization via Protocol Partitioning (#64)#71
Open
michael-wojcik wants to merge 2 commits intomainfrom
Open
docs(plan): Context Architecture Optimization via Protocol Partitioning (#64)#71michael-wojcik wants to merge 2 commits intomainfrom
michael-wojcik wants to merge 2 commits intomainfrom
Conversation
Add comprehensive implementation plan for protocol partitioning approach to optimize PACT framework context loading. Key elements: - Partition pact-protocols.md (1,086 lines) into 8 focused protocol files - Compress CLAUDE.md from 306 to ~100-110 lines - Update commands to @-reference only specific protocols needed - Expected ~51% reduction in typical orchestration context load Includes superseded skills-based plan for historical reference. Plan addresses peer review feedback incorporating: - Complete content accounting (all sections mapped to destinations) - Cross-reference inventory (7 internal refs to update) - Rollback strategy with explicit triggers - Content preservation verification methodology - Regression baseline capture requirements Status: PENDING APPROVAL Relates to #64
Address critical finding from second peer review: - All 7 agent files reference @pact-protocols.md for Cross-Agent Coordination and S1 Autonomy rules (21 refs across 7 files) - pact-preparer.md also references S4 Environment Model Updates: - Add Agent Files Cross-Reference Inventory (8 refs to update) - Add all 7 agent files to Components Affected and Files to Modify - Add Phase 5 (Update Agent Files) to Phase Sequence - Add commit 14 (refactor agents) to Implementation Sequence - Update acceptance criteria with agent file verification - Update scope: 8 new files + 12 modified (was 5) - Update time estimate: 6-7 hours (was 5-6) Also fixes: - Research citation: Clarify CLAUDE.md size as working assumption - Line count: 1,086 → 1,085 (actual file count) - Agent Files Audit section: Reflect actual finding (21 refs found) Grand total cross-references requiring updates: 15 (7 internal + 8 agent)
michael-wojcik
added a commit
that referenced
this pull request
Jan 15, 2026
Alternative to the comprehensive 8-file partitioning approach in PR #71. This moderate plan proposes extracting just 2 targeted files: - pact-agent-protocols.md (~100 lines): S1 Autonomy, Self-Coordination, Phase Handoffs for all 7 agents - pact-variety.md (~80 lines): Variety Management for orchestrate.md and plan-mode.md Expected outcomes: - ~90% context reduction for agents (1,085 → ~100 lines) - ~93% context reduction for plan-mode (1,085 → ~80 lines) - Only +2 files vs +8 in comprehensive approach - 2-3 hours implementation vs 6-7 hours Created via /PACT:plan-mode with specialist consultation from pact-preparer, pact-architect, and pact-test-engineer. Related to #64
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
1 participant
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
This PR adds the implementation plan for optimizing PACT framework context loading through protocol partitioning. The plan addresses issue #64.
Key Changes
context-architecture-protocols-plan.md)Plan Overview
Goal: Reduce context loading overhead by partitioning the monolithic
pact-protocols.md(1,086 lines) into 8 focused protocol files, and compressingCLAUDE.mdfrom 306 to ~100-110 lines.Approach:
Expected Impact:
Plan Status
The plan incorporates feedback from peer review addressing:
Status: PENDING APPROVAL
Test plan
🤖 Generated with Claude Code