This example shows how to apply the Architectural Stewardship Protocol to a contemplative reasoning system.
Before ANY implementation work:
-
Load and internalize these critical documents IN ORDER:
- README.md -> Understand system architecture and current phase
- start_prompt_response.txt -> Original vision and principles
- rework_progress_ch.txt -> Development philosophy
-
Analyze Core Architecture: /src/core/handlers/base_handler.py -> Study the handler pattern /src/core/handlers/* -> Understand specialized handlers /src/core/analyzer/* -> Grasp analysis patterns
-
Map Integration Points:
- UI <-> API boundaries
- Handler <-> Analyzer flows
- Tool integration patterns
DO NOT PROCEED until you can explain:
-
Core System Patterns:
- How handlers process assignments
- How analyzers break down tasks
- How tools integrate with core systems
-
Cross-Cutting Concerns:
- Anti-detection strategy implementation
- Multi-model processing approach
- Quality assurance mechanisms
- Error handling patterns
-
Development Progress:
- Current phase location
- Implemented vs planned features
- Integration status of components
Before making ANY changes:
-
Validate Understanding:
- Can you explain the purpose of each core component?
- Do you understand how components interact?
- Can you trace the flow of data through the system?
-
Change Assessment:
- How does your planned change fit existing patterns?
- What components will be affected?
- Are you preserving architectural boundaries?
-
Implementation Rules:
- NO restructuring without clear architectural violation
- NO duplication of existing functionality
- MUST follow established patterns
- MUST maintain current architecture unless explicitly discussed
For each change:
-
Pre-Implementation: □ Confirms understanding of affected components □ Validates against existing patterns □ Identifies integration points □ Reviews similar implementations
-
During Implementation: □ Follows established patterns □ Maintains architectural boundaries □ Preserves existing interfaces □ Documents key decisions
-
Post-Implementation: □ Verifies pattern adherence □ Confirms no unnecessary restructuring □ Validates integration points □ Updates relevant documentation
- You are CONTINUING development, not starting fresh
- The codebase has EXISTING implementations - build upon them
- Understanding > Reading - focus on patterns and architecture
- When in doubt, preserve existing patterns
- Your changes should fit the established architecture
STOP and reassess if you find yourself:
- Wanting to restructure working code
- Unable to explain existing patterns
- Duplicating functionality
- Focusing only on recent changes
- Breaking architectural boundaries
Remember: Your role is to CONTINUE development while preserving architectural integrity. Take time to understand before acting.