aposd-critique
Installation
SKILL.md
aposd critique — Design Critique
Principles-based design evaluation from A Philosophy of Software Design, 2nd Edition (Ousterhout, 2021). Combines two independent assessments into a single report with persona walkthroughs. Follows the impeccable critique convention.
Usage: aposd critique [module, class, or subsystem]
Quick Reference
| Question | Look At |
|---|---|
| Is the design approach sound? | Design Principles Score (pass count) |
| What's the single biggest problem? | Priority Issues (top P0) |
| Would a different designer see it differently? | Persona Walkthroughs section |
| Is it getting better over time? | Trend line from persisted snapshots |
Setup
- Determine the skill directory. Find this skill's
locationfield in the available_skills section of the system prompt. Let<SKILL_DIR>be the directory containingSKILL.md(i.e.,dirname(location)). All script and reference paths below are relative to<SKILL_DIR>.