architectural-forensicslisted

# Architectural Forensics Protocol Deconstruct agent frameworks to inform derivative system architecture. ## Mission Distinguish between **software engineering decisions** (how it runs) and **cognitive architecture decisions** (how it thinks) to extract reusable patterns for new systems. ## Quick Start ```bash # 1. Map the codebase (uses codebase-mapping skill's script) python .claude/skills/codebase-mapping/scripts/map_codebase.py /path/to/framework --output codebase-map.json # 2. Run analysis via the command /analyze-frameworks ``` ## Protocol Phases ### Phase 1: Engineering Chassis Analyze the software substrate. See `references/phase1-engineering.md` for detailed guidance. | Analysis | Focus Files | Output | |----------|-------------|--------| | Data Substrate | types.py, schema.py, state.py | Typing strategy, mutation patterns | | Execution Engine | runner.py, executor.py, agent.py | Async model, control flow topology | | Component Model | base_*.py, interfaces.py | Abstraction depth, DI patterns | | Resilience | executor.py, try/except blocks | Error propagation, sandboxing | ### Phase 2: Cognitive Architecture Extract agent "business logic". See `references/phase2-cognitive.md` for detailed guidance. | Analysis | Focus Files | Output | |----------|-------------|--------| | Control Loop | agent.py, loop.py | Reasoning pattern, step function | | Memory | memory.py, context.py | Context assembly, eviction policies | | Tool Interface | tool.py, functions.py |