Skip to content

About

Claude Code skill for evaluating systems against Christopher Alexander's 15 Properties — software, UI, governance, communities

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

7 Commits

Folders and files

Repository files navigation

claude-living-structure

A Claude Code skill that evaluates systems against Christopher Alexander's 15 Properties of Living Structure.

Works on anything with structure: software, UI, governance processes, communities, organizations.

15 properties of living structures

Why

Alexander argued that the 15 properties aren't aesthetic preferences — they're structural features of all living systems. They show up in nature, architecture, software, governance, and communities. Systems that exhibit them feel alive, coherent, and adapted. Those that don't feel mechanical, fragile, or imposed.

The properties are also transformations — active operations you apply to generate life in any system.

Installation

npx skillsadd zhiganov/claude-living-structure

Usage

/living-structure <subject>
/living-structure <subject> --focus <property>

The subject can be anything: a codebase, a UI feature, a governance process, a community, a document.

Examples

/living-structure harmonica-web-app              # Software codebase
/living-structure projects                       # UI feature area
/living-structure "our decision-making process"  # Governance
/living-structure "Scenius community"            # Community
/living-structure settings --focus boundaries    # Focus on one property

Focus flags

scale, centers, boundaries, alternation, positive, shape, symmetry, interlock, contrast, gradients, roughness, echoes, void, calm, fit

The 15 Properties

# Property What to look for
1 Levels of Scale Smooth gradations from small to large
2 Strong Centers Clear cores that orient everything else
3 Boundaries Thick edges that protect centers and mediate inside/outside
4 Alternating Repetition Dual structures that strengthen each other
5 Positive Space Every part is coherent and purposeful
6 Good Shape Simple parts compose into elegant wholes
7 Local Symmetries Similar things look similar; differences are meaningful
8 Deep Interlock Centers hook into each other flexibly
9 Contrast Distinct parts differentiated at a glance
10 Gradients Controlled transitions, not sharp jumps
11 Roughness Pragmatic adaptation over artificial perfection
12 Echoes Recurring themes across scales and parts
13 The Void Quiet spaces that allow life to bloom
14 Inner Calm Complex but coherent; effortless precision
15 Not-Separateness Deeply adapted to context

The checklist provides domain-specific questions for each property across four domains: software, UI, governance, and community. The skill uses whichever domain applies to the subject.

How it works

  1. Understands the subject — reads code, designs, docs, processes, or whatever the subject consists of
  2. Loads the multi-domain checklist
  3. Scores each property qualitatively: [x] present, [~] partial, [ ] missing
  4. Outputs a scorecard with overall impression, property-by-property analysis, strengths, growth areas (with transformations), and connections between properties

How it differs from other audit tools

Tool What it checks
OSS audit (/audit-oss) Concrete artifacts: LICENSE, CI, CONTRIBUTING.md
UI audit (/ui-audit) Component patterns, mobile UX, accessibility, JTBD
Living Structure Emergent qualities: coherence, adaptation, life

Living Structure is qualitative — it reads actual code/designs/processes and evaluates whether they have life. The other audits check for specific things that exist or don't.

Customizing

The checklist at living-structure-checklist.md is plain markdown. Add, remove, or modify items and domains to match your context.

Background

Christopher Alexander (1936–2022) was an architect whose work profoundly influenced software — A Pattern Language inspired design patterns, wikis, and agile methodology. In The Nature of Order, he distilled 15 geometric properties that characterize structures with "life." In The Battle for the Life and Beauty of the Earth, he reframed them as generative transformations applicable to any domain.

Further reading

License

MIT

About

Claude Code skill for evaluating systems against Christopher Alexander's 15 Properties — software, UI, governance, communities

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages