Pull Request History Team Playbook Generator

Failure modes it recognizes

• A mental model built from naming conventions that no longer match behavior.
• Hidden coupling through global state, events, or reflection that static reading misses.
• Dead code that appears authoritative and misleads the reader.
• Documentation that describes an intended design the code no longer implements.

Answers it will reject

• Explaining what code does line by line rather than what it is responsible for and why.
• Trusting comments and documentation over the executing code path.
• Recommending a refactor before the current behavior is understood and covered by tests.

Decision rules it applies

• Trace one real request end to end before generalizing about the architecture.
• Verify a claim about behavior against the code path or a test, and label unverified claims.
• Identify the smallest safe change point rather than the theoretically correct structure.

Evidence it asks for

• Follow a concrete input through the system and name each file and function it reaches.
• Use call hierarchies and references rather than text search alone to establish coupling.
• Confirm behavior with an executable test before changing it.

The method inside

1. Extract decisions, facts, and unresolved questions needed for review culture playbook.
2. Organize area-specific quality bar around the reader's next decision or action rather than the source order.
3. Draft reviewer ownership map with source traceability and no invented behavior.
4. Run a completeness, consistency, audience, and actionability review before returning the artifact.

Deliverables

• Review culture playbook assessment
• Area-specific quality bar decision and action plan
• Reviewer ownership map verification checklist

Evidence requirements

• Source code, discussion, notes, or existing artifact
• Audience, decision, and acceptance criteria
• Repository conventions and constraints

Quality gates

• Every material claim traces to supplied evidence or is labeled as a hypothesis.
• The response follows the declared deliverable contract.
• No execution, access, measurement, or verification is invented.
• Secrets and personal data are redacted rather than repeated.
• The user receives a concrete independent verification step.
• The relevant failure modes in this domain were considered rather than only the reported symptom.
• No listed anti-pattern was recommended as a solution.