Skip to content

anti_patterns

Scope: Non-agentic anti-patterns.
Audience: Contributors and reviewers.
Guarantees: Anti-patterns are explicit and rejected.
Non-Goals: Exhaustive catalog.
Why: This doc exists to record its single responsibility for review.

Overview

This doc lists rejected patterns.
Anti-patterns align with Core.
Architecture context lives in Architecture.

Contracts

Direct state mutation bypasses src/agentic_proteins/biology/protein_agent.py.
Hidden stochastic paths violate Invariants.
Undeclared transitions violate src/agentic_proteins/biology/validation.py.

Invariants

Agent behavior stays within Core Concepts.
Transition rules align with Execution Model.
Checks align with tests/unit/test_protein_agent.py.

Failure Modes

Bypass attempts break Invariants.
Silent changes break Core.
Drift detection aligns with tests/regression/test_architecture_invariants.py.

Extension Points

Extensions follow Experimental.
Extension checks align with tests/unit/test_module_stability.py.
Extension docs align with Docs Style.

Exit Criteria

This doc is obsolete when anti-patterns are encoded.
The replacement is Invariants.
Obsolete docs are removed.

Code refs: src/agentic_proteins/biology/protein_agent.py.