CivilDynamics.org/CLAUDE.md

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Overview

CivilDynamics.org is a Hugo-based static website presenting the Civil Dynamics framework—a structural analysis of political power and its implications for civil society. The site uses the Blowfish theme to present this theoretical framework and its implications for understanding how accessible AI might transform political organization.

Development Commands

Development Server

hugo server

Starts the development server with live reload at http://localhost:1313

Build

hugo build

Builds the static site to the public/ directory

Dependencies

• Install hugo (static site generator)
• Install dart-sass (CSS processing)

Deployment

Local Docker Build

hugo build
docker build -t payneio/civildynamics.org . --file ./Dockerfile
docker push payneio/civildynamics.org

Production Deployment

From payne-cloud environment:

# First time deployment
bin/wild-app-deploy civildynamics

# Updates
kubectl rollout restart deployment civildynamics -n civildynamics

Site Architecture

Content Structure

• content/ - All site content in Markdown format
  • _index.md - Homepage introducing the Civil Dynamics framework
  • about/ - Detailed explanation of the framework and its concepts

Configuration

• config/_default/ - Hugo configuration split across multiple files
  • hugo.toml - Main site configuration (baseURL: https://civildynamics.org/)
  • params.toml - Theme-specific parameters
  • menus.en.toml - Navigation menu structure
  • languages.en.toml - Language settings and site metadata

Theme

• Uses the Blowfish theme (located in themes/blowfish/)
• Theme is included as a git submodule
• Custom CSS can be added in assets/css/custom.css

Static Assets

• static/ - Static files served directly
• assets/ - Assets processed by Hugo
• public/ - Generated output directory (not committed)

Content Guidelines

Civil Dynamics Framework

The site focuses on presenting a structural framework for understanding political power:

• The three-vertex pyramid (state, moral, commercial power)
• Purity dynamics and their effect on civil society
• Historical resilience of hierarchical structures
• How accessible AI might enable governance without rule
• The importance of distributed vs. centralized AI architecture

Page Organization

• Articles use bundle structure with index.md and associated images
• Featured images should be named featured.png or featured.jpg
• Use front matter for metadata (title, description, etc.)

Hugo Features Used

• Page bundles for content organization
• Taxonomies (tags, categories, authors, series)
• Related content based on tags/categories
• RSS feeds and JSON output
• SEO-optimized with proper meta tags and sitemap generation

Docker Deployment

The site is containerized using a simple Nginx Alpine image:

• Hugo builds static files to public/
• Dockerfile copies public/ to Nginx document root
• No server-side processing required

Development Notes

• The site presents a theoretical framework for understanding political power structures
• Content emphasizes structural analysis over ideological positions
• The framework is non-partisan and applies across political systems
• Focus is on how distributed AI might enable new forms of coordination
• No analytics tracking currently configured (googleAnalytics = "")