Apply software design principles across architecture and implementation using deterministic decision workflows, SOLID checks, structural patterns, and anti-pattern detection; use when reviewing designs, refactoring modules, or resolving maintainability and coupling risks.
Does it follow best practices?
Evaluation — 99%
↑ 1.01xAgent success when using this tile
Validation for skill structure
{
"context": "Architectural decision documentation - tests whether the agent uses proper ADR format and architectural decision-making process",
"type": "weighted_checklist",
"checklist": [
{
"name": "Classifies as architectural decision",
"description": "Correctly identifies this as architectural (not tactical/foundational)",
"max_score": 10
},
{
"name": "Uses proper ADR format",
"description": "Includes Status, Context, Decision, Alternatives, Consequences sections",
"max_score": 20
},
{
"name": "Documents alternatives with rationale",
"description": "Lists all 3 options with pros/cons analysis",
"max_score": 20
},
{
"name": "Explains chosen decision clearly",
"description": "States the selected approach and why it was chosen",
"max_score": 15
},
{
"name": "Documents risks and mitigation",
"description": "Identifies potential problems and how to address them",
"max_score": 15
},
{
"name": "Includes validation steps",
"description": "Specifies how to verify the decision works (peer review, etc.)",
"max_score": 10
},
{
"name": "Applies architectural dependency checks",
"description": "Considers dependency direction and coupling implications",
"max_score": 10
}
]
}Install with Tessl CLI
npx tessl i pantheon-ai/software-design-principles@0.1.4evals
scenario-1
scenario-2
scenario-3
scenario-4
scenario-5
scenario-6
scenario-7
references